SIGGEN

Combines multiple signal waveforms of various shapes.

SIGGEN - combines multiple signal waveforms of various shapes

<card>    Name of card or output data file name for /offline mode
<flags>   Special flags to use opening the PIC card
<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 remaining lines define the parameters for the individual signals.
An example config file can be found at $ICEROOT/cfg/siggen_cfg.txt

When called from SNAPAPP, these parameters are seeded from the SNAPAPP case table
unless the /USEGLOBAL switch is specified.

With the /LIVE switch, the waveforms can be generated on-the-fly on an ICEPIC card
loaded with the AWG or MOD core, like icepic8_hhwg.  
There are 4 live modes supported.
  Module    - full waveform is generated in software and output the D2AWG 
  TBank-FSR - channels generated at fixed SR and multiplexed into single stream on host with upsample/shift/add on card (FixedSampleRate)
  TBank-MCS - channels generated at diff SR and multiplexed into single stream on host with upsample/shift/add on card (MultiCoreStream)
  TBank-MSP - channels generated at diff SR on host with the muliple stream upsample/shift/add on card (MultiSinkPic)
  TBank-AWG - channels generated/upsampled/shifted/added with FPGA's Arbitrary Waveform Generator cores all on card
The Sample Rate (SR) for the TBank/FTD 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,CoreX x=1|2|3)
  SOURCE	- Data Source (AWG,FTD,MCS,MSP)
  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)
  /USEGLOBAL	- Use global parameters in config to override SNAPAPP case table
  /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 (LRS) signal at this period in seconds
  /RTM=x	- real-time feedback monitor
  /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]