Opto22 Ethernet Brain Setup Notes

Opto22 Ethernet Brain Initial Setup Notes
Revised 23 Aug 2005

1. Before the initialization process:

Before running the initialization software, attach the brain to the local
Ethernet. An Ethernet crossover cable can also be used for directly
connecting brain to PC's network card. If the brain has not yet been set up
with an IP address, a direct connection is sometimes better since the BootP
required by the process may otherwise get replies from hardware anywhere
on the network. Once the IP address has been established, the brain can
be directly addressed on the network like any other network device.

You will need to know the brain's MAC address, so here is a list of brains
(SNAP-ENET-S64) used by the TCS3:

hostname MAC address configuration files Description
-------- ------------------ ------------------ ----------------
t3fioa 00-a0-3d-00-81-9f t3fioa_config.ota FIO A
t3fiob 00-a0-3d-00-81-90 t3fiob_config.ota FIO B
t3fioc 00-a0-3d-00-81-8c t3fioc_config.ota FIO C
t3fiod 00-a0-3d-00-81-89 t3fiod_config.ota FIO D
t3fioe 00-a0-3d-00-a0-79 t3fioe_config.ota FIO E
t3fiof 00-a0-3d-00-a9-e4 t3fiof_config.ota FIO F

t3fioelab 00-a0-3d-00-b1-cf t3fioe_lab_config.ota Hilo tcs FIO_E
t3fiolab 00-a0-3d-00-7b-a5 t3fiolab_config.ota lab test unit

Saved configuration files can be accessed from (and should be saved to):
//duke/tcs3/public_html/tcs3/computers/opto22

2. Setting a Brain's Ethernet interface

2.1. Initialize Configuration:

1. Connect the brain to the subnet or use a crossover cable.
2. Start the ioManager software.
3. Power on the brain.
4. Under Tools in the ioManager, select Assign IP Address.
5. A window should pop up containing a line showing the brain's MAC address
6. Double click the line with the MAC address and then fill in the IP address,
gateway address, and subnet mask fields below.
7. Click Assign and then OK in the resulting popup box.
8. To verify the operation, highlight the line containing the MAC again and
press Test. A window will open with a 'ping' issued to the brain.
9. If the ping is successful, the brain's IP address has been configured. See
the ioManager User's Guide (form 1440) for suggestions if problems are encountered.

Note: at this point, the brain may be connected directly to the network
if desired since the remaining configuration steps all refer to a
specific IP address (or range of addresses).

2.2. Changing an existing IP address:

1. Power on the brain.
2. Start the ioManager software.
3. Go to Tools->Change IP Settings.
4. Enter the existing IP address in the Current IP Address field.
5. Press Read Current Settings.
6. Make any modifications desired to IP address, gateway address, etc.
7. When done, press Change IP Settings.
8. The new settings will be sent to the I/O Unit and it will then automatically restart.

Note: There is procedure to reset the brain to factory defaults. It shouldn't be needed,
but if it is consult the ioManager manual for the directions.

3. Configuring a Brain's IO modules definitions.

The general steps are:
1. Create a configuration file
2. Add an IO Unit (a Brain plus its rack).
3. Add IO points (modules on a rack and the points for each module).
4. Send the configuration to the brain.

3.1. create a configuration file

1. Start the ioManager software.
2. Go to File->New and chose a name and location for the configuration file.
3. Click Open.
4. Save the file with File->Save.

Note: saving an empty configuration file doesn't seem to actually write the
file, but this step appears to be necessary - just don't close it
until at least one I/O unit has been added and the file is saved
again.

3.2. Adding an I/O Unit (the brain plus its rack) to the configuration file:

1. Open the desired configuration file if it's not already open.
2. Double click on the I/O Unit's folder to open the configuration dialog box.
3. Press Add to open the Add I/O Unit dialog box.
4. Fill in a name for the brain (eg. t3op22a) and add an
optional description.
5. Select the type: SNAP Mixed 64 Simple(SNAP-ENET-S64)
6. List the addresses of all the brains that are to receive this configuration.
(Click Add to bring up the IP dialog box. Usually the configurations will
be specific to just one brain/IP address).

3.3. Adding an I/O module to the configuration file:

1. Make a note of the type and rack location of each module to be added to the
configuration. Also decide what names you want to assign to each point
on each module (and, optionally, a description for each). Names are
required, but may be generic.
2. Open the desired configuration file if it's not already open.
3. Click the + next to the configuration file folder to show the I/O Units
folder, then click the + next to the I/O Units folder to open the list of
I/O units. In the TCS3 application there will usually be only one I/O unit.
4. Click the + next to the I/O unit to be configured to expand its display.
This should expand to show a Points folder and a Memory Map Values selection.
5. Double click the Points folder to bring up the Configure I/O Points dialog.
6. In the dialog box, double click on the number corresponding to the module to be
configured.
7. In the Add Module popup, first select the type of module you're configuring
from the drop-down list, and then the specific module type from its drop-down
list. Note that serial modules are not configured this way (they don't have points).
See Section 4 below for serial module configuration.
8. Click on the + next to the I/O module description to start assigning its
points (four per module).
9. Double click on the point you want to set up.
10. In the resulting popup, enter the name (and optional description) for the
point. The other fields will mostly already be filled in. For a digital
point, there may be optional features you can add from the drop-down list.
For analog input, there may be options you can chose in the Module:
window. For example, the SNAP-AIV-4 module lets you chose from +/- 10VDC,
+/- 10VDC (scalable), and +/- 5VDC for each point. See 3.5 below.
11. Continue this procedure (steps 6-10) for every I/O module to be configured.
12. Remember to save the I/O configuration file when you're done!

Note: if a module type needs to be changed, all of its point definitions must be deleted first.

3.4. Sending the configuration to the brain:

1. Open the desired configuration file if it's not already open.
2. Go to Tools->Send Configuration to I/O Unit.
3. Make sure the desired brain unit is highlighted in the popup.
4. Pressing Send will send the configuration to the brain's RAM, but won't save it
in the brain's static memory. To send the configuration to the brain's flash
memory (preserved through power cycles), check the Save to Flash box before
pressing Send. Since some configurations require the brain to be
restarted before they take effect, it's also a good idea to also check the
Restart I/O Unit box before sending the configuration. Any previous
configuration data in flash memory is overwritten. If a brain is being
reconfigured, it's generally a good idea to press Clear Flash before
sending the new configuration.

3.5 Notes on analog input module extra features:

The SNAP-AIV-4 module has several options for each of its points. Using
the Configure I/O popup, double click on a point under the AIV-4 module to
get the Edit Analog Point popup. The drop-down list in the Module: window
defaults the point to +/- 10 VDC. A second option allows the point to be
set to +/- 10VDC with scaling (so readouts can be in engineering units etc).
A point may also be set to a +/- 5VDC range in this window. Chapter 2 of
the ioManager User's Guide has details on these options. Chapter 2 of the
ioManager User's Guide also describes in detail the procedures for calibrating
offset and gain for analog points.

4. Notes on serial modules:

Serial I/O modules are unlike other SNAP modules in that they don't have "points" and
are not configured like other modules. They do, however, have configurable options
including 2-wire or 4-wire mode (essentially a choice between Rs-232 and RS-422) and the
serial parameters for each port. In 2-wire mode, the module will support two ports - A and B.
In the 4-wire configuration, only the A port is available.

The default parameters for a serial module are:

[1 start bit (not configurable)]
9600 baud
no parity
8 data bits
1 stop bit
no handshake
send test message when module is turned on
SNAP-SCM-232: no flow control
SNAP-SCM-485-422: 2-wire mode

If desired, all parameters except the last two may be changed in the I/O
Unit's configuration as follows:

1. Open the configuration file.
2. Right-click on the name of the I/O Unit the serial module is on.
3. In the popup, chose Configure.
4. In the resulting Configure I/O Units dialog box, make sure the correct
I/O Unit is highlighted and then press the Modules button.
5. Chose Serial Modules from the popup menu.
6. Click the status cell for the module number of the serial module.
7. In the resulting popup, chose Enabled.
8. Click on the cell containing the parameter to be changed and then enter
the new value (either by typing it in or by using a drop-down if one
appears).
9. When done, click OK to close the dialog box and continue with other
configuration or save the modified configuration file.
10. For tcs3 we are only using a serial module for dome position input. Its configuration is
fioa, module 15, port A, IP port 22530, 9600, Even, 7, 1.

Configuring flow control or 2-wire mode:

1. In the ioManager main window, press the Inspect button.
2. Make sure the correct IP address is set in the IP Address window
of the Inspect dialog box.
3. Click the Communications button and chose Serial Modules from the
popup.
4. Select the proper serial module number in the Serial Module Number
drop-down list.
5. To change a parameter, click on its displayed value and either type in
a new value or select from the drop-down list.
6. When done, click Apply.

NOTE: changes made to these parameters are sent to the I/O Unit and applied to the
serial module, but are NOT part of the configuration file and will be lost
when the I/O Unit is powered off. There is no way to save modified flow control
or 2-wire setting parameters, so non-default values must be resent to the
I/O Unit after each power cycle.