A Python GUI for the SKA AAVS1 Racks Management

Transcription

1 A Pythn GUI fr the SKA AAVS1 Racks Management A. Mattana IRA 509/17 Istitut di Radi Astrnmia, Blgna, INAF

2 this page ha been intentinally left blank Referee: tbd 2

3 Index Index Index INDEX... 3 INTRODUCTION... 4 SOFTWARE DESCRIPTION... 7 SYSTEM REQUIREMENTS... 7 SOFTWARE STRUCTURE... 7 USER MANUAL... 9 MAIN APPLICATION... 9 TPM CONFIGURATION RECEIVERS CONFIGURATION

4 Intrductin AAVS1 (Aperture Array Verificatin System 1) is the first SKA Lw Frequency Aperture Array (LFAA) test bench installed in the Western Australia in the MRO site (Murchisn Radi Observatry). It is placed within the MWA field, at 6 Km frm the ASKAP cntrl rm. The Murchisn Radi Observatry site in the Western Australia. The fur yellw dts are the AAVS1 statins within the MWA cre. A grup f us has dne the AAVS1 deplyment in 2017: Jader Mnari, Federic Perini, Marc Schiaffin, Simne Rusticelli, Marc Plni and Andrea Mattana (myself). AAVS1 is a prduct f the Aperture Array Design and Cnstructin and Cnsrtium (AADCC) fr SKA-LFAA where INAF has the biggest rle leading the WP f Antenna Receivers and pushing effrt in the WP f the Signal Prcessing prviding the itpm (Italian Tile Prcessing Mdule). The itpm bard was the nly usable and tested backend ready at the time f AAVS1 deply. itpm is just ne f mre candidates bards fr the SKA LFAA Backend, in this dcument I will use the wrd TPM r itpm meaning exactly the same thing. TPM des the signal acquisitin and data pre-prcessing f a statin slice f 16 antennas, called Tile. 4

5 Index The fllwing picture shws the data acquisitin diagram, the big grey grup n the right are mst f the TPM tasks. In the prcessing facility there is a pwerful wrkstatin called LMC (Lcal Mnitr and Cntrl) that is respnsible fr the management f all the TPMs and cmputes the phase and amplitude cefficients fr the antennas calibratin with which the TPM can cmpute a cherent Beam f the Tile. Each TPM passes the Beam f the Tile t the next TPM that add its cntribute (see next picture). The last TPM in the chain utput the beam f Statin t the Central Signal Prcessr (CSP). 5

6 AAVS1 cnsists in ne big statin f 256 dual plarizatin lg peridic antennas (main cre), and three smaller satellites f 48 antennas. Since ne TPM handles signals f 16 antennas, the AAVS1 Racks hst 25 TPMs (and tw spare bards). The AAVS1 Main Statin, 256 SKALA2 antennas In the secnd mid f 2016, the prductin f the 25 itpms started and we feel the need t manage sets f TPM bards even during lab tests. Since the LMC sftware was nt yet available, we develped ur wn management sftware. The purpse f this dcument is t describe the AAVS1 Rack Management sftware. This sftware has nt been prpsed t the cmmunity t be the legacy sftware being GUI based, but sme primitives rutines, such the Pre-ADU management, have been prvided t the SKA LMC develpers t be included in the legacy sftware. 6

7 System Requirements Sftware Descriptin System Requirements The Rack Management Sftware is written in Pythn Language. It is mainly based n the QT4 libraries (required) prviding an easy widget implementatin. The sftware is platfrm independent being Pythn a runtime interpreter. We have used it bth n Micrsft Windws 7 cmputers and Linux Ubuntu machine. The sftware is cmpatible with Pythn 2.7, and requires the fllwing libraries: Standard Pythn Libraries: s, sys, struct, math, datetime, time, subprcess Additinal required Libraries: PyQt4, xml, numpy, matpltlib, netifaces, glb. The additinal libraries can be installed thrugh the package installer Pythn PIP (setuptls): Sftware Structure The Sftware wants t manage at least ne SubRack at time, and talk t at least ne TPM f a SubRack. The functins have been split in several files accrding t the fllwing scalable scheme. There is a main widget called SKA-TPM that instantiates a SubRack bject (fig 3.1). A SubRack bject is a set f TPM instances. The SubRack creatin requires an XML file descriptr cntaining few infrmatin such hw many TPMs are cntained in the SubRack. Each TPM is an bject the TPM Class (fig 3.2). The file descriptr cntains the TPM IP address, the TCP Prt fr the cmmunicatin, the scket timeut fr read/write peratin, the psitin f the TPM inside the SubRack and the ADU and Pre-ADU bard serial numbers. 7

8 Sftware Descriptin Fig 3.1 Fr each TPM bject, yu can instantiate a PRE-ADU bject f the class PRE-ADU (fig 3.3), with which yu can access t the cnfiguratin f the 16 dual pl receivers. Fig 3.2 Fig 3.3 The GUI is a state machine always idle. When a buttn is pressed the cnnected functin runs until the executin f the rutine end, and the sftware ges idle again. There are sme n blcking threads running in parallel that can be enabled and disabled by the user. 8

9 Main Applicatin User Manual Main Applicatin The main widget allws t select ne f the AAVS1 SubRacks. Yu can start the applicatin with the cmmand: mattana@aavs-lmc:~/ska-aavs1/tls/pyska$ pythn ska_tpm.py This applicatin was intended t be als used t dwnlad FPGA Firmware and t cnfigure TPMs, but this functin has been intentinally disabled t avid accident n changing perating mdes t different TPMs while they were perative. SubRack Prfile cmbbx shws a list f SubRack prfile. Yu can select ne f them t cnnect t a SubRack. Yu can cnnect t multiple SubRacks nce at time. There is an xml file descriptr fr each SubRack cntaining infrmatin f what is available n that. 9

10 User Manual Here an example: <?xml versin="1.0" encding="iso "?> <prject name='ska-lab'> <!-- First entry --> <itpm id='0'> <subrack_psitin>0</subrack_psitin> <serial> </serial> <ipaddr> </ipaddr> <macaddr>d b-b0</macaddr> <udpprt>10000</udpprt> <udptimeut>1</udptimeut> <preadu_l>06/ </preadu_l> <preadu_r>07/ </preadu_r> </itpm> <itpm id='1'> <subrack_psitin>1</subrack_psitin> <serial> </serial> <ipaddr> </ipaddr> <macaddr>d8:80:39:92:5a:90</macaddr> <udpprt>10000</udpprt> <udptimeut>1</udptimeut> <preadu_l>08/ </preadu_l> <preadu_r>09/ </preadu_r> </itpm> <itpm id='2'> <subrack_psitin>2</subrack_psitin> <serial> </serial> <ipaddr> </ipaddr> <macaddr>d a8</macaddr> <udpprt>10000</udpprt> <udptimeut>1</udptimeut> <preadu_l>10/ </preadu_l> <preadu_r>11/ </preadu_r> </itpm> <itpm id='3'> <subrack_psitin>3</subrack_psitin> <serial> </serial> <ipaddr> </ipaddr> <macaddr>d8:80:39:92:31:2e</macaddr> <udpprt>10000</udpprt> <udptimeut>1</udptimeut> <preadu_l>12/ </preadu_l> <preadu_r>13/ </preadu_r> </itpm> </prject> As yu can see abve the SubRack file descriptr cntains: 1. A prject name strings, might be useful t knw where the SubRacks is cnnected (i.e. SKA-AVS1) 2. Within the Prject Level there are the TPMs having this meta data: a. The psitin within the SubRack b. The TPM-ADU Serial Number c. The IP address fr TPM management, including UDP prt and cnnectin timeut d. The MAC address (useful als t crsscheck if a bard has been replaced) e. Pre-ADUs serial numbers (left and right bards) Yu can cnnect t TPMs f a SubRack by selecting ne prfile and clicking t the buttn Start. 10

11 TPM Cnfiguratin TPM Cnfiguratin The creatin f this windw depends n the cntent f the SubRack prfile file. The TPM versin 1.2 is designed t be 6U x 21hp size, which means that a SubRack (19 inches standard rack frm) can hsts fur TPMs. Since the file descriptr is just a lgical assciatin between a SubRack and TPMs in principle yu can have als mre than fur TPMS. The abve windw is the widget generated fr the previus file descriptr example. When created it pens a cnnectin t all the TPMs. Each clumn f the widget represents a TPM. There is a main thread reading in plling every 10 secnds the status f each TPM. the result is reprted n the text labels, and, when makes sense, the text label changes the backgrund clr as cnditinal frmatting. Frm the tp f the windw there are: The status f the tw FPGAs. Green means prgrammed, Red nt prgrammed; CPLD firmware versin; 11

12 User Manual FPGA firmware versin, left empty if FPGAs are nt prgrammed; ADC Sample Rate as PLL cnfiguratin; PLL lck status (Lcked/Unlcked); PLL Reference surce (External 10 MHz signal/internal 10 MHz VCXO); PRE-ADUs status, Green means pwered n, Red means pwered ff; TPM bard temperature (Celsius degrees) measured frm a sensr placed in the center f the ADU bard (between the tw FPGAs and the ADCs). If the values is belw 60 C, backgrund clr is green, if between 60 and 65 is yellw clred (sft limit), Red fr higher temperatures; Cnnectin status (nline/ffline). When ffline is nt pssible t access t all the previus infrmatin and they lk disabled (grey and sme transparency); TPM Serial Number, IP address, MAC address as written in the SubRack prfile XML file. If MAC address des nt match with the UDP Packet cntent the MAC text label backgrund clr changes t yellw t infrm that that bard is changed and the database needs t be updated. This last feature is imprtant fr the actual status f the prject where the serial numbers are nt hardcded in the CPLD firmware. Yu can access t the PRE-ADUs cnfiguratin by clicking ver the PRE-ADU text label. If pwered n a new windw will be pened. 12

13 Receivers Cnfiguratin Receivers Cnfiguratin The TPM is equipped with tw PRE-ADU bards. There are tw SPI links cnnecting the TPM CPLD and the PRE-ADU registers t set the cnfiguratin. Prgrammable DC-DC cnverters nbard f TPM-ADU prvide the supply f the PRE-ADU bards. Each PRE-ADU has eight ptical receivers. The ptical mdules use the WDM technlgies (wavelength multiplexing) t transmit mre than ne ptical signal n the same fiber. These mdules manage tw wavelengths, 1270 nm and 1330 nm, and they are used t transmit the tw plarizatin f ne antenna. Therefre, each PRE-ADU manage 16 input channels cming frm 8 antennas. One TPM is able t acquire 32 input signals f 16 antennas. Tile is the name f a grup f 16 antennas. Depending f the prspective yu can call PRE-ADU Left and Right (lking t a TPM in a SubRack) r PRE- ADU Tp and Bttm (referring t the PCB surface f the TPM-ADU where Tp is the side with the ADCs and FPGAs). 13

14 User Manual The PRE-ADU windw is a cllectin f 32 receivers bject, therefre, 32 instance f the class Receivers. A Receiver class prvides functin t: set the value f the digital step attenuatr f the receiver; select the band f the filter; terminate the signal t a 50 Ohms. The windw is dived per PRE-ADU (lef and right) and grup f eight signal since there are 2 cnnectrs (driving 8 signal each) linking a PRE-ADU bard t a TPM-ADU bard. Each line is a receiver. Frm left t Right there are: The crrespnding TPM-ADU number (it starts frm 0 t 31); The Hexadecimal cde t be sent t the receiver register t set the cnfiguratin; The digital step attenuatr db value in the range between 0 and 31 (1 db step); Tw push buttns t decrease (-) and increase (+) by ne db the attenuatin value; Tw active clred text labels, LO fr the 375 MHz Lw pass filter, HI fr the MHz pass band filter. Yu can set a filter by pushing a text label like fr a buttn. The Green backgrunded is the selected filter, yellw the nt used. Yu can select nly ne filter at time, the selectin affect all the bard s whatever yu select, all the 32 receivers change the cnfiguratin; RF Channel. It is a text label reprting the number f the crrespnding RF path (that means the wavelength f the ptical signal). It is an active label. If green clred the RF input signal is enabled, yu can disable the signal by clicking t this label (like a buttn) t terminate the signal t a 50 Ohm resistance; The last label shws the number f the crrespnding ptical input as seen frm the TPM frnt panel. While each line is setting a different cnfiguratin t receivers, there are buttns t the bttm f the windw that applies a changed t all the receivers. Whenever a change is dne, the crrespnding SPI hexadecimal cde fnt becmes bld style telling that there is a change between what is shwn in the windw and the cnfiguratin f the bard. Yu can discard all changes r yu can apply all changes t the bard by using the buttns. When a change is applied, the TPM receives the new cnfiguratin, writes it t the tw SPI lanes. The sftware reads again the cnfiguratin as crsscheck. If everything went k, the new hexadecimal SPI cde is shwn with the regular fnt style. 14