Astronomical Instrument Markup Language 0.1 Sample Document
From: http://pioneer.gsfc.nasa.gov/public/aiml/HAWCv1dtd.xml
Date: 1999-01-28

--------

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE InstrumentRoot PUBLIC 
	"-//NASA//Astronomical Instrument Markup Language 0.1//EN"
	"http://pioneer.gsfc.nasa.gov/public/aiml/aiml.dtd">
<!-- DOCTYPE InstrumentRoot SYSTEM "aiml.dtd" -->

<!-- Need to define entities so things like terminator="&#10;" can become "&Newline;" -->

<InstrumentRoot id="HAWC">

  <Instrument id="ADR">
	<!-- ADR commands -->
	<Port name="ADR" function="command" number="2201" type="ASCII" serverPort="false">
	    <Command name="HouseKeeping" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
		<Data name="RATE"    type="java.lang.Integer" required="true" >
		    <ValidRange low="0" high="120000" />
		</Data>
	    </Command>
            <!-- Note the special XML decimal-like encoding for  NEWLINE terminator -->
	    <RecordFormat name="HouseKeeping" size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="HOUSEKEEPING" size="-1" />
		<Format name="RATE"    format="%s" ordered="false" header="RATE=" />
	    </RecordFormat>

	</Port> 
	<!-- Second Port: Responses to ADR commands not implemented in XML yet -->
  </Instrument>

  <Instrument id="Detector">
	<!-- Port function="data" name="Detector" number="2000" type="BINARY" serverPort="false" >
	</Port -->
  </Instrument>

<!-- No nested comments allowed. -->

  <Instrument id="Telescope">
<!-- ================================== Telescope enabled -->

	<Port name="Telescope" function="command" number="2101" type="ASCII" serverPort="false" >

	    <Command name="Move" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
		<Data name="RA"    type="gov.nasa.gsfc.irc.datatypes.Sexagesimal" required="true" >
		    <ValidRange low="00:00:00.0" high="23:59:59.99" />
		</Data>
		<Data name="DEC"    type="gov.nasa.gsfc.irc.datatypes.Sexagesimal" required="true" >
		    <ValidRange low="-89:59:59.99" high="89:59:59.99" />
		</Data>
		<Data name="Epoch"    type="java.lang.Float" required="false" >
		</Data>
	    </Command>

	    <RecordFormat name="Move"  size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="MOVE" size="-1" ordered="true" />
		<Format name="RA"    format="%s" size="-1" ordered="false" header="RA=" />
		<Format name="DEC"    format="%s" size="-1" ordered="false" header="DEC=" />
		<Format name="Epoch"    format="%.1f" size="-1" ordered="false" header="EPOCH=" />
	    </RecordFormat>

	    <Command name="Nod" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
		<Data name="Beam"    type="java.lang.String" required="true" >
		    <ValidList name="Beam">
			<Choice>left</Choice>
			<Choice>right</Choice>
			<Choice>switch</Choice>
		    </ValidList>
		</Data>
		
	    </Command>

	    <RecordFormat name="Nod"  size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="NOD" size="-1" ordered="true" />
		<Format name="Beam"    format="%s" size="-1" ordered="false" header="BEAM=" />
	    </RecordFormat>

	    <Command name="HouseKeeping" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
		<Data name="RATE"    type="java.lang.Integer" required="true" >
		    <ValidRange low="0" high="120000" />
		</Data>
	    </Command>

	    <RecordFormat name="HouseKeeping" size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="HOUSEKEEPING" size="-1" ordered="true" />
		<Format name="RATE"    format="%s" size="-1" ordered="false" header="RATE=" />
	    </RecordFormat>


	    <Command name="Status" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
	    </Command>

	    <RecordFormat name="Status" size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="STATUS" size="-1" ordered="true" />
	    </RecordFormat>

	</Port>
<!-- Telescope Response DISABLED -->
<!-- ==================================
	<Port function="data" name="Telescope" number="2100" type="ASCII" serverPort="false" >

	    <Data name="Status" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Time"    type="java.lang.Integer" required="true" />
		<Data name="Beam"    type="java.lang.String" required="false" />
		<Data name="errtext"    type="java.lang.String" required="false" />
		
	    </Data>

	   <RecordFormat name="Status" size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Time"     format="%d" size="4" ordered="true" />
		<Format name="Beam"    format="%s" size="-1" ordered="false" header="BEAM=" />
		<Format name="errtext"    format="%s" size="-1" ordered="false" header="BEAM=" />
	    </RecordFormat>

	</Port>
 ================================== -->
  </Instrument>

  <Instrument id="Opto">

	<Port function="command" name="Opto" number="2301" type="ASCII" serverPort="false" >

	    <Command name="Move" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
		<Data name="FILTER"    type="java.lang.Integer" required="true" >
		    <ValidRange low="0" high="6" />
		</Data>
	    </Command>

	    <RecordFormat name="Move"  size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="MOVE" size="-1" ordered="true" />
		<Format name="FILTER"    format="%s" size="-1" ordered="false" header="FILTER=" />
	    </RecordFormat>

	    <Command name="HouseKeeping" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
		<Data name="RATE"    type="java.lang.Integer" required="true" >
		    <ValidRange low="0" high="120000" />
		</Data>
	    </Command>

	    <RecordFormat name="HouseKeeping" size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="HOUSEKEEPING" size="-1" ordered="true" />
		<Format name="RATE"    format="%s" size="-1" ordered="false" header="RATE=" />
	    </RecordFormat>

	    <Command name="Status" required="true" >
		<Data name="tag"     type="java.lang.String" required="true" />
		<Data name="Command" type="java.lang.String" required="true" />
	    </Command>

	    <RecordFormat name="Status" size="-1" ordered="true" terminator="&#10;" attributeSeparator=" ">
		<Format name="tag"     format="%s" size="16" ordered="true" />
		<Format name="Command" format="STATUS" size="-1" ordered="true" /> 
	    </RecordFormat>
	</Port>

<!-- skip Opto data for now
	<Port function="data"    name="Opto" number="2300" type="ASCII" serverPort="false" >
	</Port>
-->
  </Instrument>

</InstrumentRoot>