Selecting the devices: online.xml syntax

The file online.xml contains the configuration for Online. The file onlineSardana.xml, which is used by the Sardana setup script SardanaStartup.py, is generated by SardanaConvert.py by converting online.xml. Both files are Online-compliant. If devices have to be added/removed/renamed the changes have to be made in online.xml which is then converted. The conversion allows for some reconfiguration.

Here is an example for an entry from online.xml:

<device>
 <name>exp_mot01</name>
 <sardananame>diffx</sardananame>
 <tags>expert</tags>
 <type>stepping_motor</type>
 <module>oms58</module>
 <device>p09/motor/exp.01</device>
 <control>tango</control>
 <hostname>haspp09mono:10000</hostname>
</device>

Some notes about this tags (except for the entries corresponding to the diffractometer and to the measurement groups, that will be described below):

• <sardananame> is an optional tag. If it is given, this will be the name with which the device will be created in Sardana and therefore seen in Spock, and <name> has not any use in Sardana. If it is not give, <name> is used instead. Within Online devices are created always using <name> and a symbol <sardananame>, in case given, is defined which refers to <name>.

  Usually if <name> and <sardananame> are defined, the tag <name> refers to the physical device and <sardananame> refers to role of the device in the experimental setup.

• <tags> is an optional tag.

• <type> is not used by Sardana. Possible values are:
  • stepping_motor, for motors of the class OmsVme58
  • timer, for timers
  • counter, for counters
  • dac, for DACs
  • adc, for ADCs
  • mca, for MCAs
  • input_register, for input registers
  • output_register, for output registers
  • DETECTOR, for detectors
  • type_tango, for other tango devices

• <module> refers mainly to the Tango class. Possible values are: oms58, motor_tango, oxfcryo700 (for devices of the class OxfordCryostream700), dgg2, pilctimer (for the use of the PiLCTriggerGenerator as timer), pilcgtvfctimer (for the use of the PiLCGateTriggeredVFC as timer), pilc_module (to introduce PiLCs to TngTool.py), sis3820, vfcadc, sis3610, tip830, spk, mca_8701, mca_xia, mca_8715, mca_sis3302new (for devices of the class sis3302), mca_sis3302 (for device of the class sis3302Client), kromo (for kromo detectors), avantes (for avantes spectrometer), spadq (for SPADQDigitizer), module_tango.

• <device> is the name of the Tango device.

• <control> is tango (not used in sardana, since we work only with Tango).

• <hostname> is the Tango Host in which the Tango device in <device> runs.

The conversion of the above entry to onlineSardana.xml would be:

<device>
 <name>exp_mot01</name>
 <sardananame>diffx</sardananame>
 <tags>expert</tags>
 <type>stepping_motor</type>
 <module>oms58</module>
 <device>p09/motor/exp.01</device>
 <control>tango</control>
 <hostname>haspp09mono:10000</hostname>
 <pool>pool_haspp09</pool>
 <controller>omsvme58_exp</controller>
 <channel>1</channel>
 <rootdevicename>p09/motor/exp</rootdevicename>
</device>