4 Target File Processing

The Enterprise accepts X,Y position information from the workstation which stores .TRG files on disk. After the information for a set of probe targets has been downloaded, the Enterprise converts the coordinates into motor addresses for the two motors which move each probe.

4.1 Enterprise Coordinate Buffers

The Enterprise stores its coordinates (both types) in nine buffer locations in memory. Seven of these are available for observer use. To be consistent with convention in this manual, the first four buffers are assigned to patterns of probes in a circle. The next three are routinely used for storage of observing targets. The next to last one contains coordinates for the neutral position at the edge of the field. The last buffer always contains the last set of coordinates that were downloaded. Coordinates must be converted to motor steps after they are downloaded. To get a directory of the buffer contents type `` B0000 ''. After processing downloaded coordinates, the observer will give a command for the probes to move to the postions in the active buffer.

4.1.1 Example Buffer Listing

<01:1>B:0000
...Coordinates at: B000       CIRCLE         0
...Coordinates at: B400       CIRCLE     32768
...Coordinates at: B800       CIRCLE     65536
...Coordinates at: BC00       CIRCLE    131072
...Coordinates at: C000       m92obs1.trg     
...Coordinates at: C400       a2089s5.trg     
...Coordinates at: C800       a2666s3.trg     
...Coordinates at: CC00       NEUTRL    133120
...Coordinates at: D000       m92obs1.trg     
 
Active Buffer:     C000       m92obs1.trg     
Probes Currently at:            NEUTRL    133120
<01:1>

B000

-- Circle of zero radius, only one probe at a time please!

B400

-- Circle of 32,000 micron radius

B800

-- Circle of 65,000 micron radius

BC00

-- Large angle circle

C000

-- Observation 1

C400

-- Observation 2

C800

-- Observation 3

CC00

-- Neutral Circle at edge of field

D000

-- Recent Download Storage

4.2 Downloading Target Files to Enterprise

4.2.1 Condition of the System

• ``mxpackage'' and ``mxobserve'' loaded
• ``listen'' task running on workstation
• Enterprise: Powered Up
• User: Sitting Calmly at Workstation, Shoes tied.

4.2.2 To Download .TRG File to Enterprise

• ``starget a1795s5.trg''
• If Enterprise prompt is $, type `` G0100 ''

If you have trouble, you may be sending data too fast, or there may have been a stray character in the input buffer. The Enterprise will echo Q's from the EPROG3 program. Communication is safer when Enterprise is in monitor mode.

Bug: Due to a problem with buffer overflow, it is expedient to type a ``DEL'' character to Enterprise before sending a target file from another window.

See the tasks ``atarget'' and ``sensors'' below for a more automated procedure which is highly recommended.

4.2.3 ``starget'' parameters

starget.par

        tfile =                 Name of the target file
    (portname = "/dev/ttya")    Name of the serial port
       (delay = 75)             Serial delay in milliseconds
  (instrument = "mxspect")      Instrument pset
   (verbosity = 4)              Output verbosity parameter
        (mode = "ql")

4.3 Processing Targets Inside Enterprise

4.3.1 Generate Coordinates in Enterprise Buffers

• `` B0000 '' to show selection of Enterprise buffers
  • The neutral position buffer is always CC00.
  • The most recent download is at D000.
• `` BC000 '' to select new active buffer C000
• `` # '' to CONVERT download coordinates into selected active buffer
• After this step, wait until you are ready to move the probes (integration done).

4.3.2 Lazy Man's Way Move Probes to Next Coordinates

• `` DEL '' key to clear buffer (temporary)
• `` BC000 '' to select new active buffer C000
• `` A/ '' to reset all motor controllers
• `` AM '' to move all probes to neutral position and then to next coordinates
• In about 60 seconds, you will get ``Photon Torpedos Armed and Ready'' message.
• Check the collision LED
• `` DEL '' key to clear buffer (temporary)
• `` A: '' to verify all probes at proper coordinates
• `` DEL '' key to clear buffer (temporary)

4.3.3 Educational Method to Move Probes to Specified Coordinates

• `` DEL '' key to clear buffer (temporary)
• `` BC000 '' to select new active buffer C000
• `` A/ '' to reset all motor controllers
• `` A '' to move all probes to neutral position
• Repeat `` A? '' until all probes have arrived at neutral
• `` DEL '' key to clear buffer (temporary)
• `` A@ '' to move probes to coordinates in new active buffer
• Wait about 50 seconds or repeat `` A? ''
• Check the collision LED on the remote box (it always has a faint glow)
• `` DEL '' key to clear buffer (temporary)
• `` A: '' to verify all probes at proper coordinates
• `` DEL '' key to clear buffer (temporary)

4.4 Automatic Processing in Enterprise

These tasks provide an automated high level interface for downloading a target file, processing targets and moving the probes.

4.4.1 Condition of the System

• ``mxpackage'' and ``mxobserve'' loaded
• ``listen'' task running on workstation
• Enterprise: Powered Up
• User: Sitting Calmly at Workstation, Shoes tied.

4.4.2 To Download and Process Targets

• If Enterprise prompt is $, type `` G0100 ''
• ``atarget a1795s5.trg''

The Enterprise will echo Q's from the EPROG3 program during the download process. Then, after a short pause, commands will be sent to automatically convert the coordinates inside the Enterprise. This may overwrite your previous coordinates. If you use ``move=yes'' or ``move+'', ``atarget'' will also send the commands to move the probes immediately.

4.4.3 ``atarget'' parameters

atarget.par

        tfile =                 Name of the target file
      (buffer = "C000")         Address of the conversion buffer
    (portname = "/dev/ttya")    Name of the serial port
        (move = no)             Move the Probes?
       (delay = 75)             Serial delay in milliseconds
  (instrument = "mxspect")      Instrument pset
   (verbosity = 4)              Output verbosity parameter
        (mode = "ql")

4.4.4 Sample ``atarget'' Interaction

On the workstation

mx> atarget m92obs1.trg move+
ATARGET Program, SPP Version of 22-JUL-93
       Executed on: Sat 10:16:37 11-Sep-93
READ_TARGET:  Reading target file: m92obs1.trg
ATARGET:  Sent target file: m92obs1.trg     
ATARGET:  B C000        Using buffer C000.
ATARGET:  #             Conversion to steps.
ATARGET:  A/            Reset controllers.
ATARGET:  AM            Moving all probes.
 
ATARGET is complete.

On the Enterprise

<01:1>#...Converting... m92obs1.trg     
...Coordinates at: C000       m92obs1.trg     
 
<01:1>AM Loading all probes, buffer = NEUTRL    133120
<20:1> Loading all probes, buffer = m92obs1.trg     
<20:1> target: 1DEB target: 183A
Photon Torpedos Armed and Ready!

4.4.5 ``sensors'' parameters

sensors.par

      (buffer = "C000")         Buffer address
    (portname = "/dev/ttya")    Name of the serial port
       (delay = 120)            Serial delay in milliseconds
  (instrument = "mxspect")      Instrument pset
   (verbosity = 4)              Output verbosity parameter

4.4.6 Sample ``sensors'' Interaction

On the workstation

mx> sensors
SENSORS Program to Check the ENTERPRISE Probes, SPP Version of 14-SEP-93
       Executed on: Fri 23:26:28 08-Jul-94
SENSORS:  B C000        Checking against buffer C000.
 
SENSORS is complete.
mx>

On the Enterprise

<01:1>B:C000          
Active Buffer:     C000       a2022s2.trg     
Probes Currently at:            a2022s2.trg     
<01:1>: 1=2752 1=2752   AOK     2=18EE 2=18EE   AOK    
<02:1>: 1=2C33 1=2C33   AOK     2=17F0 2=17F0   AOK    
<03:1>: 1=22CC 1=22CC   AOK     2=1810 2=1810   AOK    
................................
<1E:1>: 1=277B 1=277B   AOK     2=1821 2=1821   AOK    
<1F:1>: 1=13C9 1=13C9   AOK     2=1A1A 2=1A1A   AOK    
<20:1>: 1=276E 1=276E   AOK     2=18E3 2=18E3   AOK    
<01:1>B:0000                    a2022s2.trg
...Coordinates at: B000       CIRCLE         0
...Coordinates at: B400       CIRCLE     32768
...Coordinates at: B800       CIRCLE    131072
...Coordinates at: BC00       CIRCLE    131072
...Coordinates at: C000       a2022s2.trg     
...Coordinates at: C400       ................
...Coordinates at: C800       ................
...Coordinates at: CC00       NEUTRL    133120
...Coordinates at: D000       a2022s2.trg     
 
Active Buffer:     C000       a2022s2.trg     
Probes Currently at:            a2022s2.trg

4.5 How to Create a Circle Target Pattern

Sometimes you may wish to move the probes into a tight circular pattern. For example, you may wish to take a fiber flat field with similar illumination on all the fibers. 32000 microns (00008000) radius is the smallest radius circle which will hold all the probes comfortably. 65000 microns (00010000) is the smallest circle which will allow a single probe to proceed to the center of the field. Enterprise has a special command to generate a circular target pattern without downloading a target file. The command generates x-y coordinates in the download buffer (D000) just as if you had a circle target file (and destroys previously downloaded coordinates). The arguments to this command are the radius of the circle in microns and the rotation of the pattern in microradians (0 rotation orients the probes radially towards the center.). Both arguments are given in hexadecimal format (you must supply all 8 digits in legitimate hex characters).

• `` xxxxxxxx yyyyyyyy '' to enter radius and rotation
• `` AF 01 '' to select fiber 1
• `` Bzzzz '' to select coordinate buffer
• `` # '' to convert coordinates to motor steps
• `` AM '' or `` A@ '' to move the probes