ICEFAT

ICE module test routines (NextMidas Only)

<tab>    Table File with test cases
<entry>  Case in table file to run

This macro performs Factory Acceptance Tests on ICE modules. Waveforms are 
collected using special purpose macros. Signal levels and properties are 
compared to the values in the table file using the icemeasure primitive.
A summary of the results is provided after each test.

A module can be tested with another module or an external signal generator.
Testing with a signal generator requires an entry in your hwconfig.key file.
For information on how to add hardware to your config file run an explain on
'HWDRIVER'. There is also an example below.

The valid tests are:
  ALL      - Run all the tests in the table file
  ATTEN    - CW input signal with swept Attenuation
  BAND     - L-Band bandwidth tests
  CMSE     - Complex mean-squared error
  CNPR     - Complex noise power ratio
  CTWO     - Complex two-tone input signal
  NOSIG    - No input signal (just noise)
  NOTCH    - L-Band carrier suppression
  OUT      - L-Band signal out-of-range
  RAMP     - CW input signal with swept Amplitude
  SMSE     - Scalar mean-squared error
  SNPR     - Scalar noise power ratio 
  STWO     - Scalar two-tone input signal
  TIMECODE - Valid timecode received
  TONE     - CW input signal
  TRANS    - A2Dm14 DCM test
  TRIG     - Trigger digital-to-analog module on valid timecode

Valid modules are:
  A2DM14
    Applicable tests: all,atten,cmse,cnpr,ctwo,nosig,ramp,smse,snpr,stwo,
                      timecode,tone,trig,trans
  A2DR11 
    Applicable tests: all,atten,nosig,smse,snpr,stwo,timecode,tone,trig
  A2DR13
    Applicable tests: all,atten,cmse,cnpr,ctwo,nosig,ramp,smse,snpr,stwo,
                      timecode,tone,trig
  D2AWGR2
    Applicable tests: all,atten,cmse,cnpr,ctwo,nosig,ramp,smse,snpr,stwo,
                      timecode,tone,trig
  LB2D
    Applicable tests: all,atten,band,nosig,notch,out,ramp,timecode,tone
  SONET
    Applicable tests: all,sonet
  UDP
    Applicable tests: all,udp
 
Examples:
  1. Test a2dm14 with Signal Generator (tone test)
    icefat nxm.ice.tbl.a2dm14_auto.tbl tone

  2. Test a2dm14 with Signal Generator (all tests in table file)
    icefat nxm.ice.tbl.a2dm14_auto.tbl all pic1 module1

  3. Test a2dm14 with d2awg (ramp test)
    icefat nxm.ice.tbl.a2dm14_d2awg.tbl ramp

  4. Test lband with Signal Generator specifying cable loss (notch test)
    icefat/cableloss=1.5 nxm.ice.tbl.lband_auto.tbl notch

  5. Test a2dr11 with External Signal Generator with plots (tuner test)
    icefat/plotson nxm.ice.tbl.a2dr11_auto.tbl tuner

  6. Test sonet
    icefat nxm.ice.tbl.sonetr6.tbl oc48_1

  7. Test udp 
    icefat/plotson nxm.ice.tbl.udp.tbl all

  8. Test d2awg
    icefat nxm.ice.tbl.d2awg_auto.tbl cnpr

  Adding an entry to your hwconfig.key file
    Add the Signal Generator's IP to your host's file
      ! Add a network controlled signal generator entry ('rssig')
      ! note 1: Sig. Gen. ipaddress=192.168.0.1
      ! note 2: Sig. Gen. port=1234
      ! note 3: Add PROLOG entry to /etc/hosts
      ! # cat /etc/hosts | grep PROLOG
      ! 192.168.0.1    PROLOG
    Add the Signal Generator as a Midas Hardwire Device
      ! open the hwfile
      nM> pic edit hwfile
      ! insert data
      RSSIG=RODHE,RS232,SOCKET:PROLOG_1234,CR, 
      TAG==RODHE
        FREQ==F{SOUR:FREQ:CW ^f MHZ},W, // set frequency (MHz)
        AMPL==F{SOUR:POW ^f},W, // set amplitude (dBm)
      ! end insert, save and exit
      ! build new config
      nM> hw cfg
      ! confirm entry
      nM> hw show alias rssig

  Table Files
    Some example table files are located in nxm.ice.tbl
        (i.e. a2dm14_auto.tbl and a2dm14_d2awg.tbl)

Switches:

  /CABLELOSS=num  Specify the cable loss between the signal generator and 
                  the L-Band module
  /PLOTSON        Turn the plots on 

Widgets: NONE

See Also:  ICE, ICECOPY, ICEMEASURE, HW, HWDRIVER, PIC, PICD