API for RF receivers including ThinkRF WSA platform
Contents
1. 25 API for RF receivers including ThinkRF WSA platform Release 26 Chapter 5 Hardware Support CHAPTER 6 Links Official github page Documentation for this API WSA4000 WSA5000 Documentation 27 API for RF receivers including ThinkRF WSA platform Release 28 Chapter 6 Links CHAPTER 7 PyRF RTSA M1 2446 85 MHz M2 2457 85 MHz Delta 11 0 MHz Frequency Control 105 08 dBm 110 56 dBm 5 48 dB ese ieee Span Stop 2 Adjust Rew 7 Amplitude Control Refevel 0 dom 1 Minimum Attenuator Device Control Mode 59 z PULRefi Internal 1QPat Digitizer B V Level Tigger Start 240 972 E Stopi 2463 29 Mhz 4 leve 66 54 dem H Trace Control v Gear Trace Center _ a 29 API for RF receivers including ThinkRF WSA platform Release Frequency Control Center 2699 90 MHz Start Span Stp 2 adist sew Amplitude Control Reflevel 1 160m Attenuator Device Control Mode z Pref mend Trace Control Ces Tace c DM ET 30 Chapter 7 PyRF RTSA CHAPTER 8 Indices and tables2. pyrf connectors blocking PlainSocketConnector pyrf connectors twisted async SCPIClientFactory method 9 method 10 eof pyrf connectors twisted async TwistedConnector clientConnectionFailed method 10 pyrf connectors twisted async VRTClientFactory method 11 clientConnectionLost pyrf connectors twisted async SCPHelientboeteny ContextPacket attribute 13 method 10 clientConnectionLost pyrf connectors twisted_async VRT ientFactory method 11 generate_speca_packet in module pyrf vrt 14 collect_data_and_context in module pyrf util 12 compute fft in module pyrf numpy util 12 H 9 has_data pyrf connectors blocking PlainSocketConnector connect pyrf connectors blocking PlainSocketConnector method method 9 connect pyrf connectors twisted async TwistedConnector method 10 inject recording state pyrf connectors twisted async TwistedConnector connectionLost pyrf connectors twisted async VRTClent method 10 method 11 inject recording state pyrf connectors twisted async VRTClient method 11 connectionMade pyrf connectors twisted async SCPIClient method 10 InvalidDataReceived 14 IQData class in pyrf vrt 13 is context packet pyrf vrt ContextPacket method 13 15 context packet pyrf vrt DataPacket method 13 ContextPacket class in pyrf vrt 13 35 API for RF receivers including ThinkRF WSA platform Release is_data_pa
3. hide differential dc offset mask the differential DC offset present in captures with IQ data convert to dbm convert the output values to dBm Returns numpy array of dBm values as floats 2 7 pyrf util pyrf util read data and context dut points 1024 Initiate capture of one data packet wait for and return data packet and collect preceeding context packets Returns data pkt context values Where context values is a dict of field name value items from all the context packets received 12 Chapter 2 Reference API for RF receivers including ThinkRF WSA platform Release pyrf util collect_data_and_context dut Wait for and return data packet and collect preceeding context packets 2 8 pyrf vrt class pyrf vrt ContextPacket packet type count size tmpstr has_timestamp A Context Packet received from pyrf devices thinkrf WSA read fields a dict containing field names and values from the packet is context packet ptype None Parameters ptype Receiver Digitizer or None for any packet type Returns True if this packet matches the type passed is data packet Returns False class pyrf vrt DataArray binary data bytes per sample Data Packet values as a lazy array read from binary data Parameters bytes per sample 1 for PSD8 data 2 for 114 data or 4 for 24 data numpy array return a numpy array for this data class pyrf vrt DataPacket count size stream id tsi tsf payload
4. Created SweepDevice to generalize spectrum analyzer type function Created CaptureDevice to collect single captures and related context 4 16 PyRF 0 4 0 2013 05 18 pyrf connectors twisted async TwistedConnector now has a vrt callback attribute for setting a function to call when VRT packets are received This new callback takes a single parameter a pyrf vrt DataPacket or pyrf vrt ContextPacket instance The old method of emulating a synchronous read interface from a pyrf devices thinkrf WS A4000 instance is no longer supported and will now raise a pyrf connectors twisted async TwistedConnectorError exception New methods added to pyrf devices thinkrf WSA4000 abort sppO stream start stream stop stream status Added support for stream ID context packets and provide a value for sweep ID context packet not converted to a hex string wsa4000gui updated to use vrt callback wsa4000gui v enables verbose mode which currently shows SCPI commands sent and responses received on stdout Added examples stream py example for testing stream data rate Updated examples twisted show 1 q py for new vrt callback Removed pyrf twisted util module which implemented old synchronous read interface Removed now unused pyrf connectors twisted async VRTTooMuchData exception Removed wsa4000gui blocking script Fix for power spectrum calculation in pyrf numpy util 4 17 PyRF 0 3 0 2013 02 01 API now allows asyn
5. trailer A Data Packet received from pyrf devices thinkrf WSA read data apyrf vrt IOData object containing the packet data is context packet ptype None Returns False is data packet Returns True class pyrf vrt IQData binary data Data Packet values as a lazy collection of I tuples read from binary data This object behaves as an immutable python sequence e g you may do any of the following points len iq data i and q iq data 5 for i in data print i q numpy array Return a numpy array of I Q values for this data similar to 2 8 pyrf vrt 13 API for RF receivers including ThinkRF WSA platform Release array 44 8 60 92 8 56 80 ly dtype int16 exception pyrf vrt InvalidDataReceived pyrf vrt generate speca packet data count 0 Parameters data a python dict that can be serialized as JSON count int count for the header of this packet Returns vrt packet bytes next count int pyrf vrt vrt packet reader raw read Read a VRT packet parse it and return an object with its data Implemented as a generator that yields the result of the passed raw read function and accepts the value sent as its data 14 Chapter 2 Reference CHAPTER 3 Examples These examples may be found in the examples directory included with the PyRF source code 3 1 discovery py twisted_discovery py discovery py
6. twisted_discovery py These examples detect WSA devices on the same network Example output WSA4000 00 50 c2 ea 29 14 None at 10 126 110 111 WSA4000 00 50 c2 ea 29 26 None at 10 126 110 113 3 2 show i q py twisted show i q py These examples connect to a device specified on the command line tunes it to a center frequency of 2 450 MHz then reads and displays one capture of 1024 1 q values e show q py twisted show i q py Example output truncated 0 20 8 16 0 24 8 12 0 32 24 24 32 16 12 24 20 0 12 32 32 4 0 12 20 16 48 16 12 12 15 API for RF receivers including ThinkRF WSA platform Release 0 36 4 12 3 3 matplotlib plot sweep py This example connects to a device specified on the command line and plots a complete sweep of the spectrum using NumPy and matplotlib matplotlib plot sweep py 3 4 pyqtgraph plot block py This example connects to a device specified on the command line tunes it to a center frequency of 2 450 MHz then continually captures and displays an FFT in a GUI window pyqtgraph plot block py 16 Chapter 3 Examples CHAPTER 4 Changelog 4 1 PyRF 2 6 1 2014 09 30 Upload corrected version with changelog 4 2 PyRF 2 6 0 2014 09 30 Added channel power measurement feature to GUI Added Export to CSV feature to GUI for saving streams of processed power spectrum data Added a power level cursor adjustable horizontal line to
7. GUI Added reference level offset adjustment box to GUI Trigger region in GUI is now a rectangle to make it visibly different than channel power measurement controls Update mode drop down in GUI to include information about each mode instead of showing internal mode names Use netifaces for address detection to fix discover issue on non English windows machines 4 3 PyRF 2 5 0 2014 09 09 Added Persistence plot Made markers draggable in the plot Added version number to title bar Moved DSP options to developer menu developer menu now hidden unless GUI run with d option Rounded center to nearest tuning resolution step in GUI Fixed a number of GUI control and label issues Moved changelog into docs and updated 17 API for RF receivers including ThinkRF WSA platform Release 4 4 PyRF 2 4 1 2014 08 19 4 5 Added missing reqirement Fixed use with CONNECTOR IQ path PyRF 2 4 0 2014 08 19 4 6 Improved trigger controls Fixed modes available with some WSA versions PyRF 2 3 0 2014 08 12 4 7 Added full playback support including sweep in GUI Added control to WSA class Added average mode and clear button for traces Added handling for different REFLEVEL ERROR on early firmware versions Disable triggers for unsupported WSA firmware versions Added free plot adjustment developer option Fixed a number of GUI interface issues PyRF 2 2 0 2014 07 15 Added waterfall d
8. S Rob t m ae eee See bee 17 43 PYRE D510 um boe Bhd kde ied AA bdo ed x ai ee a 17 424 35245 e446 Ge ee SERRA SEER ew OEE Eas eae A 18 Z5 PYRE QAO 6 ee eter Bee edd Be e Ap EG eee qub eui w eee 18 4 6 JPYRF 2310 pe ae peed ee peda beh oes RR eh ee amp S 18 4 S Sh E e d d Se d 18 48 JPyYRE2 10 1 24 8e eee E EO ee ENSURE E S 19 Z9 PYRE 2 03 Revue vers sque BS e ee eA ie d 19 4 10 PYRE 20 2 use cx acd gt ARR Ge RI UR Go GAA 19 4 11 PYRE ZOT 235504082268 be 19 PYRE 2100 Pr 20 4 13 PYRE L2 O 6524548685 Gs cee E Se hee hee MESSE VE 20 PYRE E RO Sok ot AP a ace eas GAS RG Rae ARRAS DERE 20 415 PYRE DOO o 6344 he eee evan bbe eee eine boa ede wt bbe beak 20 4 16 PYRE O40 223 205 denos ed ead het es de wee eee eee 21 any ae a 21 4 18 Oe REA RRA OA Be 22 4 10 PYRE ODA GR AR n eo nium Une de 22 4 20 PYRE 02 3 doge E 3 Ae
9. ee 22 421 PyRBO032 RET DA ERAS REG x BARES EDO wR RE E ES EARS 22 4 22 python thimkrf0 2 eux RR Ke eee mob sod UR Gore RS 22 4 23 pythonsthunktrf 0 2 0 MGE ROS 2454 SCA he bd fee 22 4 24 pythonsthinkrf 0 1 dn RR RR RC UE UR ee 22 5 Hardware Support 25 6 Links 27 7 RTSA 29 8 Indices and tables 31 Python Module Index 33 API for RF receivers including ThinkRF WSA platform Release pyRF Contents Contents 1 API for RF receivers including ThinkRF WSA platform Release 2 Contents CHAPTER 1 Manual pyRF 1 1 Installation 1 1 1 Windows Dependencies A UU N Download https s3 amazonaws com ThinkRF Support Resources pyrf dependencies zip Extract the contents of the zipped file Install Python 2 7 6 python 2 7 6 msi Add the following to the windows PATH C Python27 C Python27Scripts Install Numpy numpy 1 8 1 win32 superpack python2 7 Install Scipy scipy 0 14 0 win32 superpack python2 7 Install Pyside PySide 1 2 0 win32 py2 7 Install Pyqtgraph pyqtgraph 0 9 8 win32 Install zope interface zope interface 4 1 1 win32 py2 7 Install twisted Twisted 14 0 0 win32 py2 7 Install pywin32 pywin32 219 win32 py2 7 Install netifaces netifaces 0 10 4 win32 py2 7 Using a command line go to the qtreactor qtreactor pyrf 1 0 folder a
10. genindex search 31 API for RF receivers including ThinkRF WSA platform Release 32 Chapter 8 Indices and tables Python Module Index Fh Fh Fh Fh Fh Fh Fh capture device 9 config l1 connectors blocking 9 connectors twisted 10 devices thinkrf 7 numpy 9611 12 sweep_device 7 util 12 3 33 API for RF receivers including ThinkRF WSA platform Release 34 Python Module Index Index B D buildProtocol pyrf connectors twisted_async SCPIClienthdatoxpyrf vrt DataPacket attribute 13 method 10 DataArray class in pyrf vrt 13 buildProtocol pyrf connectors twisted async VRTClientF amp zaorPacket class in pyrf vrt 13 method 11 dataReceived pyrf connectors twisted async SCPIClient method 10 C dataReceived pyrf connectors twisted async VRTClient calculate channel power in module pyrf numpy util method 11 12 disconnect pyrf connectors blocking PlainSocketConnector capture_power_spectrum method 9 pyrf sweep_device SweepDevice method disconnect pyrf connectors twisted async TwistedConnector method 10 capture time domain pyrf capture device CaptureDevice method 9 E CaptureDevice class in pyrf capture device 9 eof pyrf connectors twisted async V RTClient attribute CaptureDeviceError 9 11 clientConnectionFailed eof
11. in Hz 2 5 pyrf config 11 API for RF receivers including ThinkRF WSA platform Release Jevel fstop level trigger ending frequency in Hz level amplitude level trigger minimum dBm attenuator enable disable attenuator class pyrf config TriggerSettings trigtype XfstartzNone 5 ampli tude None Trigger settings for pyrf devices thinkrf WSA trigger Parameters trigtype LEVEL or to disable fstart starting frequency in Hz fstop ending frequency in Hz amplitude minumum level for trigger in dBm exception pyrf config TriggerSettingsError 2 6 pyrf numpy util pyrf numpy util calculate channel power power spectrum Return a dBm value representing the channel power of the input power spectrum param power spectrum array containing power spectrum to be used for the channel power calculation pyrf numpy util compute fft dut data pkt context correct phase True hide differential dc offset True convert to ap ply windowzTrue apply spec inv True apply reference True ref None Return an array of dBm values by computing the FFT of the passed data and reference level Parameters dut pyrf devices thinkrf WSA WSA device e data pkt pyrf vrt DataPacket packet containing samples context dict containing context values correct phase apply phase correction for captures with IQ data
12. sync_async decorator We convert the generator to a single return value for simple synchronous use pyrf connectors blocking socketread socket count flagsz None Retry socket read until count data received like reading from a file 2 4 2 twisted async class pyrf connectors twisted async SCPIClient connectionMade dataReceived data scpiget cmd scpiset cmd class pyrf connectors twisted async SCPIClientFactory buildProtocol addr clientConnectionFailed connector reason clientConnectionLost connector reason startedConnecting connector class pyrf connectors twisted async TwistedConnector reactor vrt_callback None A connector that makes SCPI VRT connections asynchronously using Twisted A callback may be assigned to vrt callback that will be called with VRT packets as they arrive When callback is None the default arriving packets will be ignored connect host output disconnect eof inject recording state state raw read num bytes scpiget cmd scpiset cmd set recording output output sync async gen exception pyrf connectors twisted async TwistedConnectorError class pyrf connectors twisted async VRTClient receive callback A Twisted protocol for the VRT connection 10 Chapter 2 Reference API for RF receivers including ThinkRF WSA platform Release Parameters receive_callback a function that will be passed a vrt DataPacket or Contex
13. API for RF receivers including ThinkRF WSA platform Release ThinkRF Corporation October 10 2014 Contents 1 Manual 3 Ne Installation A as 3 1 2 API for WSA Xo x x x EADS ROE RR ER OE 4 1 artes Ee ee Ae ae GUREA ph s 5 2 Reference 7 24 pyrbdevices iuh e Ee EDA Eee 7 2 2 pytbLsweep device Raw ee RG x Y Xo ee E 7 2 5 Pyr capire device Sty hoe o ens eS BAe d 9 24 pyrbconfectorg a RI X RR UR e Boe Ee De ds 9 2 9 Dyrf COnfIB PA Sot RUE RO SORTE C hee Se RR CHER 11 26 lt pyrinumpy ses ke ee s HER Sk ee eRe 12 2 7 te gh Shee Sine 12 20 usu RA wae TL 13 3 Examples 15 3 1 discovety py twisted discovertypy lt oom om eo mom mw qwe voy Rom dem oe Rd 15 3 2 sshow 1gpy twisted show semap e Edere eMe unes 15 3 3 umatplotlib plot SWeep Dy s v scs pees eR eRe 16 34 pyqtgraph plot block py e e e aieri meo Romo eh eee o eS ACE IE S 16 4 Changelog 17 x AA wage Be RD te RUE cule 17 4 2 PyRE 260 2 62544 bo Ped de
14. ce that will will be used for capturing data typically a pyrf thinkrf WSA instance async callback callback to use for async operation not used if real device is using a PlainSocketConnector device settings initial device settings to use passed to pyrf capture dvice CaptureDevice configure device if given capture time domain rfe mode freq device settings None min points 128 Initiate a capture of raw time domain IQ or I only data Parameters rfe mode radio front end mode e g ZIF SH freq center frequency rbw float requested RBW in Hz output RBW may be smaller than requested device settings attenuator decimation frequency shift and other device settings min points int smallest number of points per capture from real device configure device device settings Configure the device settings on the next capture Parameters device settings attenuator decimation frequency shift and other device settings read data packet exception pyrf capture device CaptureDeviceError 2 4 pyrf connectors 2 4 1 blocking class pyrf connectors blocking PlainSocketConnector This connector makes SCPI VRT socket connections using plain sockets connect ost disconnect eof has data 2 3 pyrf capture device 9 API for RF receivers including ThinkRF WSA platform Release raw read num scpiget cmd scpiset cmd sync async gen Handler for the
15. chronous use with TwistedConnector GUI now uses asynchronous mode but synchronous version may still be built as wsa4000gui blocking GUI moved from examples to inside the package at pyrf gui and built from the same setup py add Twisted version of show i q py example documentation installation instructions requirements py2exe instructions user manual and many other changes fix support for reading WSA4000 very low frequency range pyrf util vead data and reflevel was renamed to read data and context pyrf util socketread was moved to pyrf connectors blocking socketread added requirements txt for building dependencies from source 4 16 PyRF 0 4 0 21 API for RF receivers including ThinkRF WSA platform Release 4 18 PyRF 0 2 5 2013 01 26 fix for compute fft calculations 4 19 PyRF 0 2 4 2013 01 19 fix for missing devices file in setup py 4 20 PyRF 0 2 3 2013 01 19 add planned features to docs 4 21 PyRF 0 2 2 2013 01 17 rename package from python thinkrf to PyRF 4 22 python thinkrf 0 2 1 2012 12 21 update for WSA4000 firmware 2 5 3 decimation change 4 23 python thinkrf 0 2 0 2012 12 09 GUI add BPF toggle Antenna switching reset option Open Device dialog IF Gain control Span control RBW control update freq on finished editing create basic documentation and reference and improve docstrings bug fixes for GUI py2exe setup py GUI perfomance improveme
16. cket pyrf vrt ContextPacket method 13 is_data_packet pyrf vrt DataPacket method 13 makeConnection pyrf connectors twisted_async VRTClient method 11 N numpy_array pyrf vrt DataArray method 13 numpy_array pyrf vrt IQData method 13 PlainSocketConnector class pyrf connectors blocking 9 plan sweep in module pyrf sweep_device 8 pyrf capture_device module 9 pyrf config module 11 pyrf connectors blocking module 9 pyrf connectors twisted_async module 10 pyrf devices thinkrf module 7 pyrf numpy_util module 12 pyrf sweep_device module 7 pyrf util module 12 pyrf vrt module 13 R socketread in module pyrf connectors blocking 10 startedConnecting pyrf connectors twisted async SCPIClientFactory method 10 startedConnecting pyrf connectors twisted async VRTClientFactory method 11 steps pyrf sweep_device SweepStep attribute 8 SweepDevice class in pyrf sweep device 7 SweepDeviceError 7 SweepEntry class in pyrf config 11 SweepStep class in pyrf sweep device 7 sync async pyrf connectors blocking PlainSocketConnector method 10 sync async pyrf connectors twisted async TwistedConnector method 10 T to sweep entry method 8 TriggerSettings class in pyrf config 12 TriggerSettingsError 12 TwistedConnector class in pyrf connectors twisted async 10 TwistedConnectorError 10 V vrt packet reader
17. device exception pyrf sweep device SweepDeviceError class pyrf sweep device SweepStep Data structure used by SweepDevice for planning sweeps Parameters API for RF receivers including ThinkRF WSA platform Release fcenter starting center frequency in Hz fstep frequency increment each step in Hz fshift frequency shift in Hz decimation decimation value points samples to capture bins skip number of FFT bins to skip from left bins run number of usable FFT bins each step bins pass number of bins from first step to discard from left bins keep total number of bins to keep from all steps steps to sweep entry device rfe mode kwargs Create a SweepEntry for device matching this SweepStep extra parameters gain antenna etc may be provided as keyword parameters pyrf sweep device plan sweep device fstart fstop mode min points 32 Parameters device a device class or instance such as pyrf devices thinkrf WSA fstart float starting frequency in Hz fstop float ending frequency in Hz rbw float requested RBW in Hz output RBW may be smaller than requested mode string sweep mode ZIF left band ZIF or SH min points int smallest number of points per capture The following device properties are used in planning the sweep device properties FULL BW full width of the filter in Hz device properties USABLE BW usable portion bef
18. in module pyrf vrt 14 pyrf sweep device SweepStep raw read pyrf connectors blocking PlainSocketConnectorV RTClient class pyrf connectors twisted async 10 method 9 raw read pyrf connectors twisted async TwistedConnector method 10 read data method 9 read data and context in module pyrf util 12 5 pyrf capture_device CaptureDevice SCPIClient class in pyrf connectors twisted async 10 SCPIClientFactory class pyrf connectors twisted_async 10 scpiget pyrf connectors blocking PlainSocketConnector method 10 scpiget method 10 scpiget pyrf connectors twisted async TwistedConnector method 10 scpiset pyrf connectors blocking PlainSocketConnector method 10 scpiset method 10 scpiset pyrf connectors twisted async TwistedConnector method 10 in pyrf connectors twisted async SCPIClient pyrf connectors twisted async SCPIClient VRTClientFactory class in pyrf connectors twisted async 11 set recording output pyrf connectors twisted async TwistedConnector method 10 set recording output pyrf connectors twisted async VRTClient method 11 36 Index
19. isplay for GUI and example program Added automatic re tuning when plot dragged of zoomed Added recording speca state in recorded VRT files Start Stop recording menu Added GUI non sweep playback support and command line p option Added marker controls peak left right center to marker Redesigned frequency controls device controls and trace controls Default to Sweep SH mode in GUI Added developer options menu for attenuated edges etc Refactored shared GUI code and panels SweepDevice now returns numpy arrays of dBm values Fixed device discovery with multiple interfaces 18 Chapter 4 Changelog API for RF receivers including ThinkRF WSA platform Release e Replaced reflevel adjustment properties with REFLEVEL ERROR value Renamed GUI launcher to rtsa gui 4 8 PyRF 2 1 0 2014 06 20 Refactored GUI code to separate out device control and state Added SPECA defaults to device properties Restored trigger controls in GUI Added DSP panel to control fft calculations in GUI Fixed a number of GUI plot issues 4 9 PyRF 2 0 3 2014 06 03 Added simple QT GUI example with frequency attenuation and rbw controls Added support for more hardware versions Fixed plotting issues in a number of modes in GUI 4 10 PyRF 2 0 2 2014 04 29 Removed Sweep ZIF mode from GUI Fixed RFE input mode GUI issues 4 11 PyRF 2 0 1 2014 04 21 Added Sweep SH mode support to SweepDevice Added IQ in DD SHN RFE mode
20. nd type setup py install Using a command line go to the setuptools 5 7 folder and type setup py install Continue from PyRF Installation below 1 1 2 Debian Ubuntu Dependencies Use packaged requirements API for RF receivers including ThinkRF WSA platform Release apt get install python pyside python twisted python numpy python zope interface python pip python scipy python setuptools pip install e git github com pyrf qtreactor git egg qtreactor pip install e git github com pyrf pyqtgraph git egg pyqtgraph Or install GUI requirements from source apt get install qt sdk python dev cmake libblas dev libatlas dev liblapack dev gfortran export BLAS usr lib libblas libblas so export ATLAS usr lib atlas base libatlas so export LAPACK usr lib lapack liblapack so pip install r requirements txt Continue from PyRF Installation below 1 1 3 PyRF Installation Download the development version git clone git github com pyrf pyrf git cd pyrf python setup py install Or download a stable release then from the source directory python setup py install 1 2 API for WSA RF Receiver pyrf devices thinkrf WSAisthe class that provides access to WSA4000 WSA5000 devices Its methods closely match the SCPI Command Set described in the Programmers Reference available in ThinkRF Resources There are simple examples that use this API under the examples directory included with the source c
21. not specified a dialog will appear asking you to enter one If reset is used the WSA will be reset to defaults before the GUI appears 1 3 PyRF RTSA 5 API for RF receivers including ThinkRF WSA platform Release 6 Chapter 1 Manual CHAPTER 2 Reference 2 1 pyrf devices 2 1 1 thinkrf 2 2 pyrf sweep device class pyrf sweep device SweepDevice real device async_callback None Virtual device that generates power levels from a range of frequencies by sweeping the frequencies with a real device and piecing together FFT results Parameters e real device device that will will be used for capturing data typically a pyrf devices thinkrf WSA instance callback callback to use for async operation not used if real device is using a PlainSocketConnector capture power spectrum fstart fstop device settingszNone mode ZIF continu ous False min_points 32 Initiate a capture of power spectral density by setting up a sweep list and starting a single sweep Parameters fstart float starting frequency in Hz fstop float ending frequency in Hz rbw float requested RBW in Hz output RBW may be smaller than requested device settings antenna gain and other device settings mode string sweep mode ZIF left band ZIF or SH continuous bool async continue after first sweep min points int smallest number of points per capture from real
22. nts 4 24 python thinkrf 0 1 0 2012 12 01 initial release 22 Chapter 4 Changelog API for RF receivers including ThinkRF WSA platform Release PyRF is an openly available comprehensive development environment for wireless signal analysis It enables rapid development of powerful applications that leverage the new generation of measurement grade software defined radio technology PyRF is built on the Python Programming Language and includes feature rich libraries example applications and source code all specific to the requirements of signal analysis PyRF is openly available allowing commercialization of solutions through BSD open licensing and offering device independence via standard hardware APIs PyRF handles the low level details of real time acquisition signal processing and visualization allowing you to concentrate on your analysis solutions Spectrum Analyzer GUI pyrf sweep device Direct Sweep Device SCPI pyrf devices thinkrf WSA Pyqt qtgraph pyrf connector twisted async NumPy pyrf connector blocking Twisted Connector Plain Socket SCPI VRT VRT App yr E Open Source Libraries Development Network Layer 4 24 python thinkrf 0 1 0 23 API for RF receivers including ThinkRF WSA platform Release 24 Chapter 4 Changelog CHAPTER 5 Hardware Support This library currently supports development for the ThinkRF WSA4000 and WSA5000 platforms
23. ode This API may be used in a blocking mode the default or in an asynchronous mode with using the Twisted python library In blocking mode all methods that read from the device will wait to receive a response before returning In asynchronous mode all methods will send their commands to the device and then immediately return a Twisted Deferred object If you need to wait for the response or completion of this command you can attach a callback to the Deferred object and the Twisted reactor will call it when ready You may choose to use Twisted s inlineCallbacks function decorator to write Twisted code that resembles synchronous code by yielding the Deferred objects returned from the API To the asynchronous when instance created you must a pyrf connectors twisted async TwistedConnector instance as the connector parameter as in show i q py twisted show i q py 4 Chapter 1 Manual API for RF receivers including ThinkRF WSA platform Release 1 3 PyRF RTSA PyRF RISA 25 0 dev Connected To 10126110101 1 2446 85 MHz M2 2457 85 MHz 105 08 dBm 110 56 dBm AAA ANCA AWA AINA A AN WWW hme Jor Nan rtsa gui is cross platform GUI application built with the Ot toolkit and PySideProject bindings for Python The GUI may be launched with the command rtsa gui hostname reset If hostname is
24. ore filter drop off at edges Hz device properties MIN TUNABLE the lowest valid center frequency for arbitrary tuning in Hz O DC is always assumed to be available for direct digitization device properties MAX TUNABLE the highest valid center frequency for arbitrart tuning in Hz device properties DC OFFSET BW the range of frequencies around center that may be affected by a DC offset and should not be used device properties TUNING RESOLUTION the smallest tuning increment for fcenter and fstep Returns actual fstart actual fstop list of SweepStep instances The caller would then use each of these tuples to do the following 1 The first 5 values are used for a single capture or single sweep 2 An FFT is run on the points returned to produce bins in the linear domain 3 bins bins skip bins skip bins run are selected 4 take logarithm of output bins and appended to the result 8 Chapter 2 Reference API for RF receivers including ThinkRF WSA platform Release 5 for sweeps repeat from 2 until the sweep is complete 6 bins pass is the number of selected bins to skip from the first capture only 7 bins keep is the total number of selected bins to keep for single captures bins run bins keep 2 3 pyrf capture device clas pyrf capture device CaptureDevice real device async_callback None de vice_settings None Virtual device that returns power levels generated from a single data packet Parameters real device devi
25. s to GUI Added IQ output path and PLL reference controls to GUI Added discovery widget to GUI for finding devices Fixed a number of issues 4 8 PyRF 2 1 0 19 API for RF receivers including ThinkRF WSA platform Release 4 12 PyRF 2 0 0 2014 01 31 Added multiple traces and trace controls to GUI Added constellation and IQ plots Added raw VRT capture to file support Updated SweepDevice sweep plan calculation Created separate GUI for single capture modes Updated device properties for WSA5000 RFE modes Show attenuated edges in gray sweep steps in different colors in GUI Added decimation and frequency shift controls to single capture GUI Fixed many issues with WSA5000 different RFE mode support Removed trigger controls waiting for hardware support Switched to using pyinstaller for better windows build support 4 13 PyRF 1 2 0 2013 10 01 Added WSA5000 support Added WSA discovery example scripts Renamed WSA4000 class to WSA supports WSA5000 as well Separated device properties from WSA class 4 14 PyRF 1 1 0 2013 07 19 Fixed some py2exe issues Show the GUI even when not connected 4 15 PyRF 1 0 0 2013 07 18 Switched to pyqtgraph for spectrum plot Added trigger controls Added markers Added hotkeys for control Added bandwidth control 20 Chapter 4 Changelog API for RF receivers including ThinkRF WSA platform Release Renamed GUI launcher speca gui
26. tPacket when it is received connectionLost reason dataReceived data eof False inject recording state state makeConnection transport set_recording_output output_file None class pyrf connectors twisted_async VRTClientFactory receive_callback buildProtocol addr clientConnectionFailed connector reason clientConnectionLost connector reason startedConnecting connector 2 5 pyrf config class pyrf config SweepEntry fstart 2400000000 fstop 2400000000 fstep 100000000 fshift 0 decimation 0 1 gain vlow ifgain 0 hdr_gain 10 5 1024 ppb l trigtype none dwell_s 0 dwell_us 0 level_fstart 50000000 level_fstop 10000000000 level_amplitude 100 attenuator True rfe_mode ZIF Sweep entry for pyrf devices thinkrf WSA sweep add Parameters fstart starting frequency in Hz fstop ending frequency in Hz fstep frequency step in Hz fshift the frequency shift in Hz decimation the decimation value 0 or 4 1023 antenna the antenna 1 or 2 gain the RF gain value high medium low or vlow ifgain the IF gain in dB 10 34 hdr gain the HDR gain in dB 10 30 spp samples per packet ppb packets per block dwell s dwell time seconds dwell us dwell time microseconds trigtype trigger type none pulse or level level fstart level trigger starting frequency
Download Pdf Manuals
Related Search