- Introduction
- ABOUT
- ADC
- AUGer
- BELl
- Cal
- CLK
- CLose
- CLS
- CON
- DAC
- DAS
- DIS
- EXT
- FFT
- FLUX
- GET
- GETS
- Group
- HLT
- HP
- KEY
- Lab
- LABMaster
- LDIS
- LGT
- LST
- MEMory
- Mouse
- NUL
- Open
- PUT
- PUTS
- RESDas
- REWind
- ROUTing
- RUNID
- SAVer
- SCA
- SET
- SIN
- Spec
- SWP
- SYStem
- TEMP
- Timer
- TRap
- VERBose
- VSM
- Xport
Introduction
online help for program CONTROL, used in the DAS data aquisition systemsLast update: November 3, 2001
ABOUT
ABOUT
The data acquisition program CONTROL is written in Microsoft-C
version 7.0. It is (almost) fully compatible with the CIO interface,
allowing among others the use of alternate input (see LGO, LOAD, RUN
and CALL), program flow (see DO, IF, REPEAT and WHILE), and the
online creation of variables (see CHAR, INT, FLOAT, DOUBLE and VAR).
Execution of preset-time and cyclic measurements are built-in options.
Type HELP TIMER and HELP TRAP for more information.
CONTROL works standard in graphics mode. At the top of the screen
there is a menu bar with a maximum of 20 buttons. The remainder of
the screen may be exclusively assigned for text (text mode: 27 rows
of text) or shared by spectrum display and text (display mode: 6 rows
of text). Display is controlled by issuing a command at the prompt,
by pressing a hotkey, or by a mouse click on one of the menu buttons.
CONTROL will automatically switch to a screen saving mode.
Type HELP SAVER for more information.
The shape of the mouse cursor indicates whether it is positioned on a
spectrum window (vertical line), or on the menu bar (arrow) or a menu
button (swiss cross). When the cursor changes to an hour-glass, CONTROL
is reading a command from keyboard. The mouse cursor is hidden while
it is on the text window or on a spectrum window that is being displayed.
Help on the menu button is displayed in a popup window at a right mouse
click on the button. Type HELP KEY for more information.
Command flow in CONTROL proceeds as follows:
--------
| main |
-------- -----------<-----------
| | |
/--------------\ yes /--------------\ no ----------------
--->--| buffer empty ? |-->--| keyboard hit ? |-->--| polling loop |
| \--------------/ \--------------/ ----------------
| | no | yes
| ---------------- ----------------
| | read command |---<---| get new line |
| | from buffer | ----------------
| ----------------
| |
| -------------------
---<--| execute command |
-------------------
Note that a CIO script is stored in a single buffer and that the entire
script is executed before the polling loop is called again. During this
time display is not updated, keyboard is not read, mouse is not active,
and timer and trap handler flags are not acknowledged. Therefore, do not
use the trap handler to build wait loops inside a CIO script.
For general information see the CIO documentation:
CIO command language
CIO help
CIO program flow
ADC
ADC <number> <dvar>
LABMaster ADC <number> <preset> [<spec>]
Sample ADC line <number> and store result (in millivolt) in variable
<dvar>. Variable <dvar> must be of type double (see DOUBLE).
If <dvar> does not exist, variable adcval of type double is
automatically created.
As subcommand of LABMaster, (de)activate ADC line <number>. After a
preset time interval every active ADC line (0..7) is sampled. The
result in mV either replaces or is added to the contents of the next
channel of the associated spectrum <spec> (see NUL).
The time interval is equal to the product of <preset>=(0..65535) and
the unit of time (see parameters <timestep> and <deadtime> of CLK).
If <preset>=0, the line is deactivated and parameter <spec> must be
omitted. The sweep number is incremented and the channel number is
reset to zero at the end of the spectrum. The channel number is also
reset at the end of each full DAC sweep (see DAC).
The maximum number of sweeps may be defined at any moment (see
parameter <sweep> of SWP). To stop the measurement at the end of a
sweep, reduce <sweep> to some small non-zero value.
The full range of the ADC is from -10 volt to +10 volt.
Command LABM ADC is ignored when SIN is on.
AUGer
AUGer <option> ...
Call various Auger utilities. Possible options are:
<symbol>
Lst
DIF <src_spec> <dst_spec> <smooth>
SCN
SEL [ALL|<symbol> ...]
ANA
If a valid chemical symbol is entered, the corresponding Auger lines are
either plotted (display on) or listed (display off).
If LST is specified, all elements are listed that have an Auger line at the
current position of mrk0. Main Auger lines are tagged in the list.
Option DIF differentiates <src_spec> using smooth factor <smooth>.
Result is stored in <dst_spec>. Source and destination must be different.
Option SCN searches the differentiated Auger spectrum for statistically
significant lines. If the line is a main line, the corresponding element is
listed. If the line is not a main Auger line and the associated main line is
outside the energy range of the spectrum, the element is also listed but the
chemical symbol is followed by a question mark.
Specify SEL to (de)select elements that will be used in a quantitative
analysis (see option ANA). Chemical symbols may be preceded by an optional
sign: Cu and +Cu select element copper, -Cu deselects element copper, and
keywords ALL, +ALL and -ALL remove all previously selected elements from
the list. SEL without further parameters prints the current list of selected
elements.
Option ANA calculates the relative contributions of the elements selected
by SEL. The summed intensity is normalized to 100%.
BELl
BELl <option> ...
Posssible options are:
<command>
Init
Flux <dvar>
Temp <dvar>
LST
Abbreviations are allowed; required letters are written in upper case.
For example: 'bell init' may be shortened to 'bel i'.
If option starts with '*' or ':', it is assumed to be a Bell command
and the command is sent to the gauss meter. Commands that contain
white space must be quoted. Combine a command that does not start with
'*' or ':' with another command that does; use ';' as separator
between commands.
INIT will search all COM ports and, on success, initialize the meter.
FLUX starts a flux measurement and stores the result in variable
<dvar>. Variable <dvar> must be of type double (see DOUBLE). If <dvar>
does not exist, variable belval of type double is automatically
created (see FLUX).
TEMP starts a temperature measurement and stores the result in variable
<dvar>. Variable <dvar> must be of type double (see DOUBLE).
If <dvar> does not exist, variable belval of type double is
automatically created (see FLUX).
LST prints info about the Bell gauss meter.
Options <command>, FLUX and TEMP are ignored if the meter is not
connected.
Cal
LABMaster CAL <number> <dig1> <dig2> <ana1> <ana2>
SET Cal [Auto] <option> [<cal0> <cal1>]
Subcommand of either LABMaster or SET.
As subcommand of LABMaster, calibrate DAC <number>. The full digital
range is from <dig1>=0 to <dig2>=4095 while the full analogue range
is from <ana1>=0 volt to <ana2>=+10 volt for each DAC. Of coarse,
the analogue output values may be specified in more practical units.
Calibration according to <dig>=<cal0>+<cal1>*<ana>.
Command LABM CAL is ignored when SIN is on.
As subcommand of SET, define calibration of the x-axis. Possible
options are:
Channel trivial calibration: <cal0>=0 and <cal1>=1
Energy calibration in units of eV
Frequency calibration in units of Mrad/s
Time calibration in units of ns
Velocity calibration in units of mm/s
Gauss calibration in units of gauss
Abbreviations are allowed; required letters are written in upper case.
For example: 'set cal time 1.0 3.4' may be shortened to 'set c t 1.0 3.4'
If keyword AUTO is specified, the values <cal0> and <cal1> are linked
to the left and right marker positions. This makes it possible to specify
a calibration line that not necessarily coincides with the origin.
Calibration according to <x_value>=<cal0>+<cal1>*<channel>.
The calibration constant <cal1> must be <>0.
CLK
LABMaster CLK <number> <preset> <timestep> <deadtime>
Connect internal clock if <number>=0 or external clock if <number>=1.
Specify <timestep> and <deadtime> in seconds for internal clock, and
in number of pulses for external clock.
At the end of the preset time interval the measurement is stopped.
If <preset>=0, this interval is supposed to be infinit.
The time interval for each particular device is equal to the product
of <timestep> and the value of <preset>=(0..65535) for that device.
If <deadtime><>0, the clock operates with a load (=deadtime) and
hold (=timestep) cycle. The clock is disarmed while executing the
interrupt handler. The clock output can be used to gate a scaler
line. Provided <deadtime> is large enough, the dwell time is exactly
equal to <timestep>.
If <deadtime>=0, the clock is not disarmed while executing the
interrupt handler and the elapsed real time is exactly equal to
<timestep> times the number of interrupts.
Use commands SIN, HLT and CON to start or stop Labmaster. However,
Labmaster is not started when <timestep>=0.
Command LABM CLK is ignored when SIN is on.
CLose
CLose <file_type>
Close file and the associated logical unit. Possible file types are:
DSP data file
DAT export file
LOG log file
PRO program file
DMP dump file
Type HELP OPEN for more information.
CLS
CLS
Reset video mode and mouse. Clear terminal screen.
CON
CON
Resume data acquisition after HLT has been issued.
The timer is not reset.
DAC
DAC <number> <value>
LABMaster DAC <number> <preset> [<begin> <end> <step>]
Set output of DAC <number> to <value> volt.
As subcommand of LABMaster, (de)activate DAC line <number>. After a
preset time interval the output of every active DAC line (0..1) is
incremented by <step> from <begin> to <end>; specify these analogue
values in accordance with the calibration (see CAL). By issuing the
command, the DAC output is reset to <begin>. The calibration must be
defined.
The time interval is equal to the product of <preset>=(0..65535) and
the unit of time (see parameters <timestep> and <deadtime> of CLK).
If <preset>=0, the line is deactivated and parameters <begin>, <end>
and <step> must be omitted.
The channel numbers of the spectra associated with active ADC and SCA
lines are reset to zero at the end of each DAC sweep.
The maximum number of sweeps may be defined at any moment (see
parameter <sweep> of SWP). To stop the measurement at the end of a
sweep, reduce <sweep> to some small non-zero value.
If <sweep>=0, the measurement is stopped after the first step.
The full range is from 0 volt to +10 volt for each DAC.
Command LABM DAC is ignored when SIN is on.
DAS
SET DAS [<address>] <option> ...
Possible options are:
ADC pulse-height analysis mode
MCS multichannel scaling mode
PACON PAC mode on
PACOFF PAC mode off
BITON hardware/software routing on
BITOFF hardware/software routing off
Set the attributes of the data acquisition system with IEEE
address=<address>. The value of <address> is automatically set if
one DAS is talking. If more than one DAS is talking, the user is
requested to select <address> from the list of talking DAS. If no DAS
is talking, <address> is defaulted to zero. The address of the
selected DAS is displayed on the menu bar.
If PACOFF is specified, spectrum offsets in DAS memory are multiples
of 4k and the number of spectra is limited to 16.
If PACON is specified, PAC routing is assumed to be used. The number
of spectra in DAS memory may be as large as 256. PAC spectra form one
contiguous data space. The combination PACON and MCS is illegal.
Type HELP MEMORY or HELP ROUTING for more information.
Command SET DAS is ignored when SIN is on.
DIS
DIS <fspec> <nspec> [<option> ... ]
DIS [<option> ... ]
Possible options are:
SCL <ymin> <ymax>
OFF <offset>
LIN
LOG
SAF
Static display of <nspec> spectra beginning with <fspec>.
The value of <offset> determines which part of DAS memory is mapped
on the <ndas> spectra that are defined in PC memory. Non-zero values
of <offset> are displayed in the spectrum text window.
Type HELP MEMORY for more information about <offset>.
The vertical scale runs from <ymin> to <ymax>.
Keywords LIN and LOG select linear and logarithmic display,
respectively.
Previous display is not erased if keyword SAF is given.
CONTROL allocates <nspec> spectrum windows.
EXT
SET EXT <option>
Some extended features. Possible options are:
IEEE <control> <DAS> <timeout> [<tim>]
reset system controller if <control>='yes'
reset selected DAS if <DAS>='yes'
change timeout to <tim> ms if <timeout>='yes'
this option is ignored while SIN is on
IRQ <irq>
set interrupt line used by Labmaster motherboard
this option is ignored when Labmaster not installed
IN <port>
get one byte from specified port
OUT <port> <value>
put one byte to specified port
VIDEO <mode> <bkg> [<bkgcolor>]... <txt> [<txtcolor>]... <light>
if <mode>='yes' change video mode from '16 colors VGA' to
'black and white', and vice versa
change background color to <bkgcolor> until <bkg>='no'
change text color to <txtcolor> until <txt>='no'
make text color bright if <light>='yes'
note that command CLS resets mode and colors to the default
values
FFT
FFT <src_spec> <dst_spec> <first> <last> <weight>
Calculate fast Fourier transform of <src_spec> over specified region,
result in <dst_spec>. The (real) weigh factor <weight> must be
[0..9]. A value of 4 is recommended by Tilman Butz. The source
spectrum is mirrored with respect to <first>.
FLUX
FLUX <dvar>
BELl Flux <dvar>
Start a flux measurement and store the result in variable <dvar>.
Variable <dvar> must be of type double (see DOUBLE). If <dvar> does
not exist, variable belval of type double is automatically created.
GET
GET <fspec> <nspec> <runid>
HP Dat GET <fspec>
Independent command or subcommand of HP. File type DSP must be open.
As independent command, GET reads <nspec> consecutive spectra from
data file, starting with run number <runid>. Data will be put in
<fspec> to <fspec>+<nspec>-1.
As subcommand of HP, GET transfers real and imaginary parts of
trace 1 for both channel 1 and 2 as well as the stimulus from the
HP analyzer to memory. The data are stored in a set of 5 consecutive
spectra, starting with <fspec>.
GETS
GETS
Get settings.
File type DMP must be open. At start the file name $PATH\CONTRLxx.DMP
is assumed by default (xx=DAS address, $PATH=full path to the
directory from where program CONTROL is executed).
Group
SET Group <grp>
Select spectrum <grp> for data acquisition. BITON must be specified.
The selected group number is displayed in the spectrum text window
and the corresponding window frame(s) is (are) enhanced.
Type HELP MEMORY or HELP ROUTING for more information.
Command SET GROUP is ignored when SIN is on.
HLT
HLT
HP Dat HLT
Independent command or subcommand of HP.
As independent command, stop data acquisition. Use CON to continue
or SIN to restart.
As subcommand of HP, stop HP analyzer.
HP
HP <option> ...
Possible options are:
<command>
Init
Dat <...>
Set <...>
Back <...>
Lst
Abbreviations are allowed; required letters are written in upper
case. For example: 'hp init' may be shortened to 'hp i'.
If option starts with '*' or contains ':', it is assumed to be an HP
command and the command is sent to the HP analyzer. Commands that
contain white space must be quoted. Combine a command that does not
start with '*' nor contains ':' with another command that does; use
';' as separator between commands.
INIT searches the IEEE addresses 16..20 for a talking analyzer and,
if success, gets some parameters from the analyzer.
The subcommands DAT, SET and BACK are described below.
Options <command>, DAT, SET and BACK are ignored if the analyzer is
not connected.
HP DAT <option> ...
Possible options are:
SIN
HLT
GET <fspec>
PUT <fspec>
STATus <dvar>
Abbreviations are allowed; required letters are written in upper
case. For example: 'hp dat status' may be shortened to 'hp d stat'.
SIN starts a measurement.
HLT stops a measurement.
GET transfers real and imaginary parts of trace 1 for both channel 1
and 2 as well as the stimulus from the HP analyzer to memory. Data
are stored in a set of 5 consecutive spectra, starting with <fspec>.
PUT transfers real and imaginary parts of trace 1 for both channel 1
and 2 from memory to the HP analyzer. Data are taken from a set of 5
consecutive spectra, starting with <fspec>. The last spectrum of this
set is supposed to contain the original stimulus.
STATUS queries the Status Byte Register of the analyzer and stores
the result in variable <dvar>. Variable <dvar> must be of type
double (see DOUBLE). If <dvar> does not exist, variable hpval of
type double is automatically created. Note that bit #2 is set after
a group of <sweep> sweeps has been completed.
HP SET <option> ...
Possible options are:
Freq <ffreq> <lfreq>
Length <nchan>
SWp <sweep>
LIN
LOG
(Re)set selected item. Abbreviations are allowed; required letters
are written in upper case. For example: 'hp set length 801' may be
shortened to 'hp s l 801'
FREQ sets begin and end of the frequency sweep; <ffreq> and <lfreq>
must be in the range (1 MHz..1.8 GHz).
LENGTH sets the number of steps in the sweep to <nchan>=(2..801).
SWP set the maximum number of sweeps to <sweep>=(1..999).
LIN set a linear spacing for frequency sweep and x-scale.
LOG set a logarithmic spacing for frequency sweep and x-scale.
HP BACK <option> ...
Possible options are:
SAVe <fname>
RECall <fname>
DELete <fname>
CDir <dname>
MKDir <dname>
OK
Abbreviations are allowed; required letters are written in upper
case. For example: 'hp back cdir <dname>' may be shortened to
'hp b cd <dname>'. This backup utility uses the floppy disk in the
analyzer's built-in disk drive. File name <fname> and directory name
<dname> are either a full path, or a path relative to the current
directory. Special DOS characters like \, . or .. are allowed.
SAVE backups the HP analyzer status to file <fname>.
RECALL recovers the HP analyzer status from file <fname>.
DELETE deletes file <fname>.
CDIR changes the working directory to <dname>.
MKDIR creates directory <dname>.
OK queries the system error string. All registers are reset after the
query.
KEY
MENU BUTTON HOTKEY ACTION
=========== ====== ======
0 acquire off/on
1 (DAS address)
2 PgUp / <shift>PgDn display following spectrum
3 PgDn / <shift>PgUp display preceding spectrum
4 - / <shift>+ expand vertical scale
5 + / <shift>- squeeze vertical scale
6 F9 logarithmic display off/on
7 F7 live display off/on
8 F8 zoom off/on
9 <shift>ScrlLck mrk1+mrk2 -> left
10 ScrlLck mrk1+mrk2 -> right
11 Tab increment |mrk1-mrk2|
12 <shift>Tab decrement |mrk1-mrk2|
13 F5 / <shift>F6 mrk1+mrk2 -> left ROI
14 F6 / <shift>F5 mrk1+mrk2 -> right ROI
15 F3 / <shift>F4 mrk1+mrk2 -> preceding spectrum
16 F4 / <shift>F3 mrk1+mrk2 -> following spectrum
17 Ins insert ROI
18 Del delete ROI
19 F10 display mode off/on
Home display first spectrum
End display last spectrum
MOUSE BUTTON HOTKEY ACTION
============ ====== ======
single left LfAr RgAr UpAr DnAr set position mrk0
double left F1 / <shift>F2 set position mrk1
double right F2 / <shift>F1 set position mrk2
Hit popup mrk0 position
dwell on curve popup mouse position
dwell on menu popup help on menu button
Lab
SET Lab <label>
Define new spectrum label=<label> ('raw' line of < 256 characters).
LABMaster
LABMaster <option> [<option> ... ]
Set various Labmaster parameters. Possible options are:
CLk <number> <preset> <timestep> <deadtime>
Adc <number> <preset> [<spec>]
Dac <number> <preset> [<begin> <end> <step>]
Cal <number> <dig1> <dig2> <ana1> <ana2>
Sca <number> <preset> [<spec>]
Lgt ON|OFF
Vsm X|Y|Z|OFF
Nul ON|OFF
SWp <sweep>
LST
Abbreviations are allowed; required letters are written in upper
case.
The options ADC, CAL and SCA are ignored when no spectrum space is
allocated. The options CLK, ADC, DAC, CAL and SCA are ignored when
SIN is on. All options are ignored if the Labmaster motherboard is
not installed. LST prints the Labmaster configuration.
Type HELP CLK, HELP ADC, HELP DAC, etc. for more information.
Since commands SIN, CON and HLT involve both DAS and Labmaster, it
may be wise to select DAS <address>=0 while working with Labmaster
(see DAS).
LDIS
LDIS <fspec> <nspec> [<option> ... ]
LDIS [<option> ... ]
Possible options are:
SCL <ymin> <ymax>
OFF <offset>
LIN
LOG
SAF
Live display of <nspec> spectra beginning with <fspec>.
The value of <offset> determines which part of DAS memory is mapped
on the <ndas> spectra that are defined in PC memory. Non-zero values
of <offset> are displayed in the spectrum text window.
Type HELP MEMORY for more information about <offset>.
The vertical scale runs from <ymin> to <ymax>.
Keywords LIN and LOG select linear and logarithmic display,
respectively. Previous display is not erased if keyword SAF is given.
CONTROL allocates <nspec> spectrum windows.
LGT
LABMaster LGT ON|OFF
Switch logic gate on/off.
LST
LST <option>
List various things. Possible options are:
DAS DAS configuration (data acquisition system)
Dis display configuration
Free memory resources
IEEE IEEE configuration (PC<>488 driver)
Lab all headers on data file
LABM Labmaster configuration
LU open files
MEM memory configuration
Mouse mouse configuration
SAVer screen saver configuration
Spec spectrum configuration
Timer timer configuration
TRap trap handler configuration
Video video configuration
Print configuration of selected item. Abbreviations are allowed;
required letters are written in upper case. For example:
'lst timer' may be shortened to 'lst t'.
Use CIO command DLU to list also the files that are opened by CIO.
MEMory
Due to the limited size of conventional computer memory, only part
of the DAS data space can be mapped on the spectra defined in PC
memory, and only this part can be displayed. The number <ndas> of
DAS spectra that can be mapped is limited by CONTROL to 16 or <Ndas>,
whichever is smaller, or by the available memory resources of the
computer.
The display attribute <offset> determines which part of the DAS data
space is mapped on the spectra defined in PC memory according to the
following scheme:
<------------------------- spectra in DAS memory ---------------------->
0 1 ....... <offset> <offset>+1 .. <offset>+<ndas>-1 ....... <Ndas>-1
/ / /
/ / /
/ / /
/ / /
/ / /
/ / /
/ / /
/ / /
0 1 ....... <ndas>-1 0 1 ............ <naux>-1
<--- DAS spectra ---> <-- auxilliary spectra -->
<----------- spectra in computer memory ----------->
Obviously, <offset> can take any value that is smaller than or equal
to the difference <Ndas>-<ndas>. The number of displayed spectra
should not exceed the sum <ndas>+<naux>. By a proper choice of
<offset> and by proper paging any spectrum in DAS memory can be
displayed.
Note that the CIO variables sp[i] and spx[i] are linked to the
spectra in PC memory and, thus, refer to the offset spectra in DAS
space. The commands RESDAS and PUT will issue a message if
<offset><>0 in order to warn the user that he is going to reset/save
an offset spectrum.
There are some subtle differences between the display attribute
<offset> and the spectrum attribute <group>. The former indicates one
or more blocks of <Nchan> channels, which is the effective spectrum
length in DAS space. The latter refers to a single spectrum (= block
of <Nchan> channels in DAS space) if PACOFF, or to a complete PAC
data space (= contiguous block of 16x<Nchan> channels in DAS space)
if PACON.
If software routing is used, CONTROL will take care to set the
correct route bits. If hardware routing is uses, however, it is the
user's responsibility to connect the external route signal(s) to the
proper route input(s).
Mouse
See KEY.
NUL
LABMaster NUL [ON|OFF]
If NUL is on, channel contents are cleared before adding ADC or SCA
result.
Open
Open <file_type>
Open file and the associated logical unit. Possible file types are:
DSP data file <lu>=1 access mode: a+
DAT export file <lu>=2 access mode: a+
LOG log file <lu>=8 access mode: a+
PRO program file <lu>=15 access mode: r
DMP dump file <lu>=11 access mode: r+
Program and dump files must exist before they can be opened.
All files are opened in text mode (ASCII).
Note that CIO uses <lu>=14 for logging.
PUT
PUT <fspec> <nspec>
HP Dat PUT <fspec>
Independent command or subcommand of HP. File type DSP must be open.
As independent command, PUT writes <fspec> to <fspec>+<nspec>-1 on
data file. Data are preceded by a header containing label, runid,
spectrum length, elapsed time, calibration constants, and calibration
unit.
Note that the spectra may be linked to an upper region in DAS memory
(see parameter <offset> of DIS and LDIS).
The run number will be automatically incremented.
As subcommand of HP, PUT transfers real and imaginary parts of
trace 1 for both channel 1 and 2 from memory to the HP analyzer. Data
are taken from a set of 5 consecutive spectra, starting with <fspec>.
The last spectrum of this set is supposed to contain the original
stimulus.
PUTS
PUTS
Put settings.
File type DMP must be open. On exit the file name $PATH\CONTRLxx.DMP
is assumed by default (xx=DAS address, $PATH=full path to the
directory from where programm CONTROL is executed).
RESDas
RESDas <spec>
Reset <spec> and corresponding DAS memory block.
Note that the spectra may be linked to an upper region in DAS memory
(see parameter <offset> of DIS and LDIS).
If <spec>=-1, all spectra are reset.
REWind
REWind <file_type>
Rewind file. Possible file types are:
DSP data file
DAT export file
LOG log file
PRO program file
DMP dump file
Type HELP OPEN for more information.more information.
ROUTing
If PACON is selected, CONTROL assumes that the special PAC routing is
used. A standard PAC data space consists of 4x4=16 spectra that form
a contiguous data space in DAS memory. The length of a PAC data space
is therefore limited to 64k/16=4k, and the number of channels <nchan>
per spectrum should be selected from the series 256, 512..4k. The
number of addressable spectra in DAS memory is <Ndas>=64k/<nchan>.
The number of groups that can be selected by routing is
<Ngrp>=<Ndas>/16.
If PACOFF is selected, the spectrum length is limited to 4k by the
peripheral devices PHA and MCS, and the number of channels <nchan>
may be chosen from the series 256, 512..4k.
The number <Ndas> of addressable spectra in DAS memory is 16, and the
number of selectable groups is <Ngrp>=<Ndas>.
In either case the distance <Nchan> between two consecutive spectra
in DAS memory is 64k/<Ndas>. The spectrum offsets in DAS space are
listed by the command LST MEM.
=== PAC ===== nchan ===== ndas ===== Nchan ===== Ndas ===== Ngrp ===
on 256 0..16 256 256 16
512 0..16 512 128 8
1k 0..16 1k 64 4
2k 0..16 2k 32 2
4k 0..16 4k 16 1
====================================================================
off 256 0..16 4k 16 16
512 0..16 4k 16 16
1k 0..16 4k 16 16
2k 0..16 4k 16 16
4k 0..16 4k 16 16
====================================================================
Memory management depends only on the parameter PACON/PACOFF but not
on BITON/BITOFF. The latter parameter merely tells CONTROL whether or
not software routing should be enabled.
Note that it is not possible to disable the hardware routing.
RUNID
SET RUNID <runid>
Define new run identification number=<runid> (unsigned long int).
SAVer
SET SAVer <tim>
Set screen saver attributes The preset time <tim> should be expressed
in seconds. The screen saver is disabled by setting <tim>=0.
Screen saving mode starts after <tim> seconds have elapsed.
CONTROL uses the 18.2 Hz interrupts of the PC, defining time slices
of approximately 55 msec.
SCA
LABMaster SCA <number> <preset> [<spec>]
(De)activate SCA line <number>. After a preset time interval the next
active SCA line (0..15) is sampled. The result either replaces or is
added to the contents of the next channel of the associated spectrum
<spec> (see NUL).
The time interval is equal to the product of <preset>=(0..65535) and
the unit of time (see parameters <timestep> and <deadtime> of CLK).
If <preset>=0, the line is deactivated and parameter <spec> must be
omitted.
The sweep number is incremented and the channel number is reset to
zero at the end of the spectrum. The channel number is also reset at
the end of each full DAC sweep (see DAC). The maximum number of
sweeps may be defined at any moment (see parameter <sweep> of SWP).
To stop the measurement at the end of a sweep, reduce <sweep> to
some small non-zero value.
Command LABM SCA is ignored when SIN is on.
SET
SET <option>
HP SET <option> ...
Independent command or subcommand of HP. Set various things.
As independent command, the possible options are:
Cal <option> [<cal0> <cal1>]
DAS [<address>] <option> ...
EXT <...>
Lab <label>
RUNID <runid>
SAVer <tim>
TRap <tim> <cvar>
The following options are ignored when SIN is on.
Group <grp>
Spec <nchan> <ndas> <naux>
Timer <tim>
(Re)set selected item. Abbreviations are allowed; required letters
are written in upper case. For example: 'set spectrum 512 16 0'
may be shortened to 'set s 512 16 0'
Type HELP CAL, HELP EXT, HELP LAB, etc. for more information.
As subcommand of HP, the possible options are:
Freq <ffreq> <lfreq>
Length <nchan>
SWp <sweep>
LIN
LOG
(Re)set selected item. Abbreviations are allowed; required letters
are written in upper case. For example: 'hp set length 801' may be
shortened to 'hp s l 801'
FREQ sets begin and end of the frequency sweep; <ffreq> and <lfreq>
must be in the range (1 MHz..1.8 GHz).
LENGTH sets the number of steps in the sweep to <nchan>=(2..801).
SWP set the maximum number of sweeps to <sweep>=(1..999).
LIN set a linear spacing for frequency sweep and x-scale.
LOG set a logarithmic spacing for frequency sweep and x-scale.
Command HP SET is ignored if the HP analyzer is not connected.
SIN
SIN
HP DAT SIN
Independent command or subcommand of HP.
As independent command, reset timer and start data acquisition. Use
HLT to stop. The clocks of the trap handler and the screen saver are
not affected by command SIN.
As subcommand of HP, start HP analyzer.
Spec
SET Spec <nchan> <ndas> <naux>
Set spectrum attributes. CONTROL allocates <ndas> spectra for
data acquisition and <naux> spectra for data manipulation. All
spectra have a common length of <nchan>=[256,512..4k]; <ndas> is
limited to 16.
Clear high byte of DAS mode word, and reset spectrum <grp> and
display <offset>. Set trivial calibration.
Type HELP DAS or HELP GROUP for more information.
The following CIO variables are automatically (re)created:
sp refers to the total spectrum space
spx, x=0..<ndas>+<naux> refers to an individual spectrum
spnchan <nchan>
spndas <ndas>
spnaux <naux>
spnspec <ndas>+<naux>
spgroup <grp>=0
spcal0, spcal1 calibration constants
Note that sp[i] and spx[i] are only updated during live display.
Command SET SPEC is ignored when SIN is on.
SWP
LABMaster SWp <sweep>
HP SET SWp <sweep
Set maximum number of sweeps. Subcommand of either LABMaster or HP.
As subcommand of LABMaster, stop the measurement when for any
active device the number of sweeps exceeds <sweep>=(0..65535).
If <sweep>=0, the measurement is stopped after the first step of any
active DAC.
As subcommand of HP, stop the measurement when the number of sweeps
exceeds <sweep>=(1..999).
SYStem
SYStem <shell_command>
Read a line of text, then execute this line as a shell command line.
Pipe output through tempory file. List output in page mode.
TEMP
TEMP <dvar>
BELl Temp <dvar>
Start temperature measurement and store result in variable <dvar>.
Variable <dvar> must be of type double (see DOUBLE). If <dvar> does
not exist, variable belval of type double is automatically created.
Timer
SET Timer <tim>
Set timer attributes. The preset time <tim> should be expressed
in seconds. If <tim>=0, data acquisition never stops.
CONTROL uses the 18.2 Hz interrupts of the PC, defining time slices
of approximately 55 msec.
Command SET TIMER is ignored when SIN is on.
TRap
SET TRap <tim> <cvar>
Set trap attributes. The preset time <tim> should be expressed
in seconds. The handler is disabled by setting <tim>=0. The timer
of the trap handler starts to run as soon as the handler is set,
and is not halted while SIN if off.
The handler will reset the current time and execute the instructions
stored in variable <cvar> after <tim> seconds have elapsed.
Variable <cvar> must exist and be of type char. The instructions may
be loaded from a file or subfile (see LGO, LOAD and RUN), or stored
by (re)defining variable <cvar> (see CHAR).
Note that the preset time must be explicitely set to zero by the user
in order to stop the trap handler.
CONTROL uses the 18.2 Hz interrupts of the PC, defining time slices
of approximately 55 msec.
VERBose
VERBose ON|OFF [<line>]
Switch verbose on/off. Commands that involve settings, timing, IEEE
errors or file manipulation are logged if verbose is on. Each message
is preceded by a time stamp.
An optional line ('raw' line of < 256 characters) is echoed to
LOG-file. File type LOG must be open.
See CIO command LOG for logging of CIO commands.
VSM
LABMaster Vsm X|Y|Z|OFF
Set pseudo routing bits 0-4, according to following table:
OFF -> 0000
X -> 0001
Y -> 0010
Z -> 0011
The 2 lowest bits are used to configure the VSM pick-up coils.
Xport
Xport <spec> <first> <last> [<label>]
Write data in specified region of <spec> on data file. Data are
preceded by an optional string <label>, and written in two columns:
first column contains x-values in calibration units (see CAL) and
second column contains y-values. All values in floating point format.
File type DAT must be open.