SRTCS Scalable Readout Test and Configuration Suite
April 2, 2012
Volkan Gezer –
[email protected]
SRTCS Version: 1.0 Manual Version: 1.0
Contents Purpose .................................................................................................................... 3 Features ................................................................................................................... 3 Installation ................................................................................................................ 3 Windows: Using Installer (approx. 124 MB) ................................................................ 3 Windows: Using ZIP File Package (approx. 4 MB) ........................................................ 3 Any operating system: Using VI Files (approx. 2 MB) ................................................... 3 Usage ....................................................................................................................... 4 Preparation ............................................................................................................. 4 Hardware............................................................................................................. 4 Software.............................................................................................................. 4 Instructions ............................................................................................................ 4 FEC Card Test ...................................................................................................... 5 FEC Card Configure ............................................................................................... 7 ADC Card Test ...................................................................................................... 8 Hybrids Test (not implemented yet) ........................................................................ 9 FEC Firmware ....................................................................................................... 9 Reporting ................................................................................................................ 10 Help ....................................................................................................................... 12 Context Help......................................................................................................... 12 Expert Mode ............................................................................................................ 12 UDP Flow.............................................................................................................. 13 Expert .................................................................................................................. 13 To-do List................................................................................................................ 14
Purpose •
Test of SRS electronics cards for production conformance
•
Configuration or Reconfiguration of parameters
•
To be used both for production and end-users
•
Scope: FEC card, ADC card, (Hybrid)
Features •
Full range of conformance tests
•
User-friendly error reporting
•
Auto MAC address generation and programming
•
Fully documented buttons with context help
•
Save as HTML and/or Print Reports with success or fail messages
•
Expert mode, enabling manual commands and error decoding.
Installation Windows: Using Installer (approx. 124 MB) If you obtained installer file, run setup.exe and follow instructions. Application shortcut will be placed both on All Users Desktop and Start Menu.
Windows: Using ZIP File Package (approx. 4 MB) If you have application ZIP file, extract all files to a folder. To execute SRTCS, you need at least LabVIEW 2010 Run-Time Engine which can be found here (if the link is outdated, please use www.ni.com/drivers or go to National Instruments website -> Support -> Drivers and Updates. Then choose LabVIEW Run-Time Engine).
Any operating system: Using VI Files (approx. 2 MB) If you have VI files, extract all files in the same folder. You need to have at least LabVIEW 2010 installed to run interface. Also make sure your VI files and impact.txt, impact2.txt, fec_v206.bit, and fec_top.bit files are in the same directory with SRTCS.vi.
Usage Preparation Hardware Depending on the card which needs to be tested, the other cards should be reference. For example, testing FEC card will require CTF, ADC and Hybrids to be reference. Also, it is needed to have 4 special cables indicated on the SRS Test Procedures manual. Xilinx USB Programmer is required to install specific firmware while test procedure. Ethernet card (configured with 10.0.0.3 and netmask 255.255.0.0 parameters) should be connected to FEC. Turn ATX power off Connect power cable to FEC and plug required cards (ADC, master-slave Hybrids pair) Connect Xilinx USB Programmer using JTAG connector on FEC. Switch clock and trigger switches on CTF to INT (internal) mode. Power on ATX Software See installation section first. To program FPGA, you need Xilinx ISE Webpack (for all users) (freely available here).
Instructions If you are using stand-alone application, it is recommended to stop after opening application by clicking
or using Ctrl+. key combination.
Figure 1 – SRTCS Main Window
Follow these steps to start SRTCS: 1. Type target FEC IP to Local FEC IP field (if it is different). 2. Type your ethernet IP to Computer IP field (if it is different). 3. 4. 5. 6. 7.
Run SRTCS using button on the toolbar or use Ctrl+R key combination. Unlock buttons using Enable Conf. And Test button. Choose an operation from the main window. After tests, Save and/or Print reports The stable firmware will automatically be activated after reboot. FEC Card Test
FEC Card test mainly includes Front Panel Connector Tests, ADC Connection Test, and I2C tests. FEC Card Test button will display the following tab:
Figure 2 – FEC Card Test Tab
Follow steps below for testing: 1. Program Connector Test Firmware using relevant button. See FEC Firmware section for details. 2. If you would like to perform all tests click on Start button for automatic checks. The interface will ask the operator which cables to connect or what operation to do. 3. If you would like to do partial test, you can click one of buttons below Manual Checks text. 4. After each test, the LEDs will be green if test is successful also results will be shown on Messages field on the right. 5. If any errors occur, they will be displayed on Errors occurred field. 6. Click on Finish if you would like to show detailed report and for report saving/printing options (Figure 5). If you would like to test another card, click on Back (see report format: Figure 7). Finishing will hide all controls to prevent additional tasks. You need to stop and restart interface again to do another test (Figure 3).
Figure 3 – Interface after clicking Finish button
Important: In Automatic Check mode, interface will program another firmware for ADC Connection Check. Please click OK and remove all cables (except for JTAG ethernet and power cable) from FEC Card. For manual check, the firmware needs to be programmed manually. See FEC Firmware section for details. Note: If automatic test is being done, after an unsuccessful test, the user will be asked to repeat test. FEC Card Configure For FEC Card Configuration, 1. 2. 3. 4.
Click FEC Card Configure button. By default, the Local FEC IP will be copied to New IP field. New Serial Number data is read from srtcs.txt file in the same folder with application. Change IP and/or serial number then click DONE (no further actions are allowed after this command). 5. After this operation you need to Write Constants to apply changes. Note: The new IP and serial number will be activated after rebooting FEC card. You can either use Reboot FEC button or the reset switch (U56) placed on the FEC. Note: The given number will be increased by one to be used by next FEC serial number. This number will be used to generate MAC address.
Figure 4 – FEC Card Configuration Tab
ADC Card Test ADC Card tests include I2C tests, voltage/current measurements, PCI connectors, baselines and HDMI connector tests. Click on ADC Card Test to enter following tab:
Figure 5 – ADC Card Test Tab
Before starting ADC Card Tests, you should remove all cables on the front panel of the FEC Card (except for power, ethernet and JTAG cables). Otherwise, PCI Connectors, ADC Baselines, and HDMI Connectors tests may fail.
Follow these steps for testing: 1. Program ADC Test Firmware using appropriate button. See FEC Firmware section for details. 2. Click on Start to do automatic checks. You will only need to follow instructions for tests. 3. If you would like to do partial tests, you can use buttons below Manual Checks text. 4. After each test, the LEDs will be green if test is successful also results will be shown on Messages field on the right. 5. If any errors occur, they will be displayed on Errors occurred field. 6. Click on Finish if you would like to show detailed report and report for saving/printing options. This report will have similar format to FEC Card Test Report (see Figure 10). If you would like to test another card, click on Back. Note: If automatic test is being done, after an unsuccessful test, the user will be asked to repeat test. Finishing will hide all controls to prevent additional tasks. You need to stop and restart interface again to do another test (Figure 3). Hybrids Test (not implemented yet) Not implemented yet. FEC Firmware
Figure 6 – FEC Firmware Tab
This section will explain how to program test firmwares using SRTCS. Firmware programming with SRTCS is not permanent. In other words, the firmware will be reverted to previous version after reboot. For a permanent programming you should use iMPACT (See Connection, Programming and Testing Manual).
FEC Firmware tab is shown on Figure 6. It can be reached either by choosing this tab after enabling Expert Mode or clicking on Program xxx Test Firmware buttons on test tabs. The latter method will choose correct firmware automatically. Find and choose ISE_DS path, check 32/64 bit settings, and the firmware you would like to program, and then click PROGRAM. If path is empty, click on yellow folder icon to choose a folder. See Figure 7 to see how to save changes (The default directory will probably be C:\Xilinx\xx.x\ISE_DS where xx.x is the version number.).
Figure 7 – Programmer folder selection
This path information is stored in path.txt folder in the same directory with application. Wait till command window opens and finishes the operation. The LED and messages field will show the status after operation has been completed. A log file will be saved as impactlog.txt in the same folder with SRTCS.
Reporting After clicking any button, the operation will be done and a message related to operation will be shown on Messages field (whether it is successful or not).
Finishing tests by clicking Finish buttons on FEC or ADC test tab, two options will be shown to user (Figure 8):
Figure 8
The user can either save report to file or print the report. The report will include all messages field including details about tests (if any). It is possible to create combined reports by clicking Back button on either FEC or ADC test tab and doing another operation. For example, to create a report for ADC & FEC Test and FEC Configuration the user can follow steps below: 1. FEC Test -> Back 2. ADC Test -> Back 3. FEC Configuration -> DONE After saving/printing report, it will include all three operations with their details (See Figure 9 and Figure 10 for sample reports).
Figure 9 – Sample FEC Card Test Report
Figure 10 – Sample ADC Card Test Report
Help Context Help It is strongly recommended to turn Context Help feature of LabVIEW on to use SRTCS easily. To turn on click on
on the toolbar or choose Help -> Show Context Help.
Hovering your mouse on a control or an indicator for one second will display an explanation about it. All SRTCS controls and indicators are fully documented.
Expert Mode Expert mode allows switching between tabs without using navigation buttons and also enables two extra tabs:
Figure 11 –Tab selector after enabling Expert mode
UDP Flow Currently, UDP Flow tab only can be used to see incoming data. This feature will not work if you have FEC Connector firmware installed. To start initialization, click on Initialize. You can check Test Pulse checkbox if you do not want to use external trigger. If any error occurs, some of the LEDs will be red and Errors Occurred message field include a message. Hover your mouse on a led to see explanation (context help must be on). Clicking on STOP will stop readout and clear Raw Data field. If you would like to keep the data shown here, you need to pause interface using Pause button on the toolbar.
Figure 12 – UDP Flow Tab
Expert Expert tab allows executing every command that the firmware supports.
This tab also creates a random request id to communicate with FEC card. You need to type commands to Request field (excluding request id) and a Target Port to Target Port field. Clicking on Send will send the commands and the reply will be seen on the right. If there is an error, they will be shown on the right side with LEDs. Also, errors occurred field will include the type of the error. Two LEDs next to Send Request button shows the status of commands if they are sent or not. PC Port field is slow control port and has no effect if changed after running VI.
Figure 13 – Expert Tab
To-do List - Hybrids test - More error code explanations
