ICEAWG

Combines multiple signal waveforms of various shapes.

ICEAWG - combines multiple signal waveforms of various shapes

<out>    Name of output data file
<config> Configuration file with an entry for each waveform 

This macro combines the outputs of multiple ICEWAVE calls to generate sample 
test environments.  See ICEWAVE for supported shapes.  The configuration file
consists of a list of parameters for each ICEWAVE primitive.

The first line of the config file contains the setting for the global parameters in a 
serialized table format. For example:

  GLOBAL={FORM=CI,LEN=1.0,RATE=100.0,GAIN=-8}

where 

  FORM  Format of output file (CI, CF, etc.)
  LEN   Length of output file in seconds
  RATE  Sample rate in MHz
  GAIN  Combined waveform amplitude scaling in dB

The /global=table switch can ge used to override this
The remaining lines define the parameters for the individual signals.
An example config file can be found at $ICEROOT/cfg/iceawg_cfg.txt

With the /LIVE switch, the waveforms can be generated on-the-fly on an ICEPIC card
loaded with the AWG core, like icepic8_hhwg.  
There are 4 live modes supported.
  Module - full waveform is generated in software and output the D2AWG 
  TBank  - individual channels generated on host at same SR with upsample/shift/add on card 
  MCStream - individual channels generated on host at diff SR with upsample/shift/add on card 
  MCore - individual channels generate/upsample/shift/add on card 
where the Sample Rate (SR) for the TBank mode is the max of the individual channel SRs.

Controls:

  ACTION	- Preview,PostView,Archive,Config,Idle,Run,Rates,Exit
  FILE		- Current file for writing/reading AWG data
  CARD		- Ice PIC card alias
  PORT		- Ice PIC card port (ModuleX,MCoreX,TBankX,NCStreamX where x=1|2|3)
  FORM		- Data Format CI|CB
  LEN		- Output File or Circular Buffer length in seconds
  GAIN		- Overall gain of combined signals in dB
  RATE		- Sample Rate of combined output
  RFFREQ	- RF Frequecy for D2AWG Modules
  RFGAIN	- RF Gain for D2AWG Modules

Messages:

  CFG_FREQ-n	- set center frequency (MHz) for channel <n>
  CFG_BAUD-n	- set baud rate (MHz)
  CFG_FBWF-n	- set Filter BandWidth Factor 
  CFG_TAPS-n	- set Filter Taps
  CFG_GAIN-n	- set Signal Gain (dB) (0=nominal for given data type)
  CFG_SPEC-n	- set Signal Specific / Modulation Index
  CFG_SHP-n	- set Signal Shape  (FSK,QPSK,CW,etc)

  CFG_SAVE	- save configuration to file
  CFG_LOAD	- load configuration from file

Examples:

  An HTTP request to change the RF Freq and RF Gain of the output Module:
    http://<host>:<port>/Controls/Set?{RFGAIN=12,RFFREQ=1200}

  An HTTP request to change the frequency of channel 3:
    http://<host>:<port>/Message/Send?{NAME=CFG_FREQ-3,DATA=35}

Switches:
  /TL=n		- Transfer Length elements [DEF=4096]
  /AUTO=ON|OFF	- Auto preview for any configuration change (def=ON)
  /GLOBAL={}	- Override global parameters
  /BATCH	- non-Interactive execution of ACTION=ARCHIVE
  /LIVE		- Use IcePIC card for waveform generation
  /ACTION=x	- Startup action to perform
  /LRSPS=(a,..z)- LRS Polynomial for data generation
  /REPEAT=x	- repeat signal at this period 
  /PSDA=n	- number of PSDs to average in live mode [def=10]
  /PSDE=n	- number of PSDs to exponentially average in live mode [def=1]
  /NFFT=n	- FFT size in live mode [def=4k]
  /XCVR=alias	- TX transmitter alias
  /XCF=x	- TX center frequency in GHz [def=2]