OKOS Controls Config.xml

Obsolescence

As of ODIS-IC 3.19.98, this file is obsolete and the settings below are integrated into the <appSettings> sections of ODIS-3.exe.config. ODIS-NDT still uses this file though it will eventually be converted as well.

Summary

The OKOS_Controls_Config.xml file configures certain features of the Acquisition controls in ODIS. The file is located in the same directory as the ODIS program.

Note: depending on the location, a user may need Administration privileges to edit and save changes to this file.

All entries in OKOS_Controls_Config.xml are stored in key/value pairs , e.g.:

 <add key="IGNORE" value="false"></add>

The file is fairly simple and has only one major section, shown below:

<Configuration>
  <BoardNumbers>
    <key/value pairs>
  </BoardNumbers>
</Configuration>

List of Keys

Keys are listed in alphabetical order.

Boardx

Boardx keys determine the board ordering when loaded into ODIS, where "x" is the 0-based index. These are only used if the IGNORE tag is set to false. There can be multiple Boardx tags in the file. The value attribute for the tag is the board serial number. The serial number or numbers must match those of the A/D boards in the system.

These tags must be present if the IGNORE tag is set to false. If a listed serial number does not match an existing board, an error will occur.

 <add key="Board0" value="1103883" />
 <add key="Board1" value="1103880" />

DisableHW

This will disable all hardware A/D boards in the system. Only software A/Ds (Shell and Post-Processing) will be shown.

If this key is missing, the DisableHW value is false.

 <add key="DisableHW" value="true" />

DisableRTG

This will disable the RTG gating. If RTG disabled, the user will gain two additional simultaneous peak detection gates. This applies only to 8xGTe boards for which RTG is enabled.

If this key is missing, the DisableRTG value is false.

 <add key="DisableRTG" value="false" />

HIGHSPEED

Some Acquisition Logic boards can default to a lower sampling rate than the native sampling rate, in cases where the full sampling rate is unnecessary or generates too much data to process. if the HIGHSPEED tag is present and the value attribute is set to false, the board will operate at the reduced sampling rate.

If this key is missing, the HIGHSPEED value is true.

 <add key="HIGHSPEED" value="false"></add>

IGNORE

In systems with multiple A/D boards, it is sometimes desireable to enforce a board order in ODIS, so that a particular A/D always shows as channel 1, another as channel 2, etc. (the PCI bus does not enforce a particular order). If the IGNORE tag is present and set to false, the system will use the Boardx tags to determine the order in which the A/D boards should appear in ODIS. If IGNORE is set to true, A/D boards will be loaded and presented in the order in which the PCI bus finds them.

If this key is missing, the IGNORE value is true.

If there is only one A/D board in the system, this parameter is not used.

 <add key="IGNORE" value="true"></add>

PostProcessor

If this key is present and the value attribute is set to true, a Post Processing channel will be added to ODIS.
See Also: Post Processing

If this key is missing, the PostProcessor value is false.

 <add key="PostProcessor" value="true"></add>

PostProcessSN0

This sets a serial number for the postprocessor. This number can be referenced by the Boardx tag to set the order of the post-processing "board" in the Digital Oscilloscope. The serial number must not match any numbers used by A/D boards or by Shell boards.

If this key is missing, the PostProcess serial number is 0.

 <add key="PostProcessSN0" value="1111"></add>

ShellSNx

This sets serial numbers for the Shell boards, where "x" is the 0-based index. This number can be referenced by the Boardx tag to set the order of the shell channels in the Digital Oscilloscope. The serial numbers must not match any numbers used by A/D boards or by the Post Processor.

If these keys are missing, each shell board is given a sequential serial number starting with 0.

 <add key="ShellSN0" value="111"></add>
 <add key="ShellSN1" value="222"></add>

UseShell

If this key is present, one or more simulated A/D "boards" will be added to ODIS. Any number of boards can be added, but in practice more than three will cause system lag. The value attribute specifies the number of simulated boards. To specify the order in relation to other boards, use the ShellSnx tag.
See Also: Simulation Mode

If this key is missing, the UseShell value is 0.

 <add key="UseShell" value="1"></add>