MKS Ophir EA-1 User manual

Ophir Optronics Solutions Ltd.
E A -1
Ethernet Adapter
Ethernet Adapter
User Manual
EA-1
EA-1

EA-1 User Manual 2
Contents
About this document: ....................................................................................................................................................... 4
Definition of Terms: ...................................................................................................................................................... 4
Chapter 1 - Introduction: .................................................................................................................................................. 5
General Description: ..................................................................................................................................................... 5
Package Contents:......................................................................................................................................................... 6
Connection Protocols:................................................................................................................................................... 6
Ethernet Cables and Ground Connections to EA-1 Device: .......................................................................................... 7
Chapter 2 - Configuration: ................................................................................................................................................ 8
Device Default Configuration:....................................................................................................................................... 8
Choosing New IP address for EA-1 Device: ................................................................................................................... 8
Setting up a static IP address using HTTP: .................................................................................................................... 8
Setting up a static IP address using Telnet: ................................................................................................................ 10
Setting up a static IP address using the USB Virtual COM Port: .................................................................................12
Setting up a static IP address using the “OphirEthernetApp” software:.....................................................................12
Changing to Dynamic IP Address Allocation Mode:.................................................................................................... 14
Setting the User Device Name: ...................................................................................................................................15
Setting the “Mains” Frequency:..................................................................................................................................15
Returning to Factory Default Settings:........................................................................................................................ 16
Chapter 3 - HTTP and the Built-In Web Server: ..............................................................................................................17
Connecting to the built-in web server: .......................................................................................................................17
Using the built-in web server:.....................................................................................................................................17
Chapter 4 - Using the “OphirEthernetApp” Application: ................................................................................................19
Getting started:........................................................................................................................................................... 19
Starting the program and connecting to the EA-1 Adapter:....................................................................................... 19
Choosing Network:......................................................................................................................................................20
The main sensor window: ...........................................................................................................................................20
Power Display and Statistics: ......................................................................................................................................20
Choosing Measurement Range:.................................................................................................................................. 21
Choosing Wavelength Option, Discrete Laser Points: ................................................................................................ 21
Choosing Wavelength Option, Calibration Curve: ...................................................................................................... 22
Saving the Startup Settings:........................................................................................................................................ 23
Sending User Commands: ...........................................................................................................................................23
Measuring Energy: ...................................................................................................................................................... 23
Measuring Average Power for Low Frequency Pulsed Lasers - “Low Freq. Power Mode”: .......................................25
Configuration and Setup: ............................................................................................................................................26
Firmware Upgrade: .....................................................................................................................................................27
Zeroing: .......................................................................................................................................................................28
Help Menu: .................................................................................................................................................................28

EA-1 User Manual 3
Log Files and Buffer Files:............................................................................................................................................29
Chapter 5 - Other Features and Protocols:.....................................................................................................................31
Using HTTP Protocol: .................................................................................................................................................. 31
Searching for EA-1 Devices on the Network: ..............................................................................................................31
Summary of TCP Port Numbers: .................................................................................................................................32
Chapter 6 - Details of User Commands:..........................................................................................................................33
General Rules: ............................................................................................................................................................. 33
Using the USB Connection: .........................................................................................................................................33
Special Rules When Using Telnet:...............................................................................................................................33
UDP Protocol:..............................................................................................................................................................34
Ethernet Commands: .................................................................................................................................................. 35
General Notes on Commands:.................................................................................................................................... 36
Device Specific Commands: ........................................................................................................................................37
General Commands: ................................................................................................................................................... 37
Zeroing Commands: ....................................................................................................................................................38
Power Measurement Commands: .............................................................................................................................. 38
Using the Low Freq. Power Mode (Photodiode Sensors): ..........................................................................................40
Energy Measurement Commands (Thermopile Sensors): ..........................................................................................40
Wavelength Commands:.............................................................................................................................................42
Continuous Send Commands:..................................................................................................................................... 43
Misc. Commands:........................................................................................................................................................44
Commands for Pyroelectric/PD-C Sensors:................................................................................................................. 45
Continuous Send Modes for Pyroelectrics/PD-C Sensors:.......................................................................................... 46
Appendix 1 - Device Specifications - EA-1 Ethernet Adapter:......................................................................................... 49
Appendix 2 - Configuring a PC to Connect Directly to the EA-1 Device:.........................................................................50
Appendix 3 - Considerations Regarding Cables and Grounding: ....................................................................................55
Appendix 4 - Version History: .........................................................................................................................................56

EA-1 User Manual 4
About this document:
This manual contains instructions for using the Ophir “EA-1 Ethernet Adapter” device.
The manual is divided into several sections:
Introduction to the EA-1 and general description of the product
Instructions for initial configuration and setup
Instructions for using the accompanying PC application
Instructions for using the device via user commands
Device specifications
Note: For the latest version of this document please see our website: www.ophiropt.com/photonics
Definition of Terms:
The word “device” used throughout this manual refers to the EA-1 adapter itself.
Instructions regarding computer control of the adapter (for example, opening a Telnet connection or using the USB
port) refer to a PC running Windows 7. Instructions for a PC running XP or newer versions of Windows are similar or
identical in most cases but minor variations may be required.
Note: It is possible to perform all these tasks using a computer running another operating system and not just with
Windows, for example a MAC or Linux PC, but in that case the instructions will be different according to the specific
operating system being used. All the tasks should still be possible using a different platform, as they are not specific
to Microsoft Windows (for example, Telnet and USB Virtual COM Port) but instructions are included specifically for
Windows as that is how the device and software have been tested.

EA-1 User Manual 5
Chapter 1 - Introduction:
This chapter provides some basic information about the EA-1 and a general description of the device.
General Description:
The EA-1 is an Ethernet Adapter intended for OEM customers. It is designed to work with standard or OEM Ophir
smart-plug sensors using a D15 connector. The EA-1 supports Ophir thermopile, photodiode, pyroelectric (PE-C) and
PD10 series sensors.
The EA-1 device is supported by a special PC Application “OphirEthernetApp” or by Ophir’s StarLab software package.
Physical connections to the device are as follows:
On the rear panel:
Mini-USB input, used for configuration and factory calibration
RJ-45 connector to Ethernet
12-24v DC power input socket, using standard Ophir connector (mating with 2.1/5.5mm axial plug)
On the front panel:
D15 socket to Ophir smart-sensor plug

EA-1 User Manual 6
On the sides:
Two M3 mounting holes are provided along each side of the device allowing attachment of an optional
bracket (as shown in the illustration above). The bracket makes it easier for the customer to attach the
device into his mechanical system. A set of two brackets and four screws are supplied with the device.
Full device specifications are included in Appendix A below.
Package Contents:
The EA-1 package includes the following items:
EA-1 adapter
Ethernet cross cable (for initial configuration)
USB-A to USB-Mini-B cable (for initial configuration)
Ophir 12v DC power supply
2x mounting brackets, 4x M3 screws for attaching the brackets to the device, 1x Allen Key
The “OphirEthernetApp” PC application and drivers for using the USB Virtual COM Port are available on the Ophir
website, www.ophiropt.com, search for “EA-1” and “Software”.
The device can be powered either via ‘Power over Ethernet’(PoE) if available, or via the 12-24v DC input.
Connection Protocols:
There are four ways to connect to the device:
Telnet
HTTP
UDP
USB Virtual COM Port
Telnet:
A Telnet connection can be used to send commands and receive back replies from the device. The connection is
established by using the device’s IP address. The host device (for example, a PC) is the “client” and the EA-1 device is
the “server”. This type of connection can be used manually from a Telnet terminal, or can be programmed into the
user’s software application to add automation, in much the same way as using a COM port. This type of connection
protocol is used in the “OphirEthernetApp”PC application to control the device. Details are listed later on in this
document.
HTTP:
Using a web browser, a connection can be established to the device which allows basic configuration, sending
commands, monitoring power from the sensor, and viewing general information about the device. The user needs to
enter the IP address in the browser and a connection is made to the device. A top level “web-page” is displayed with
several buttons that allow entry into several lower level pages. In addition, there is an option to send software

EA-1 User Manual 7
commands directly using the HTTP protocol. As for the Telnet connection, the host device is the “client” and the EA-1
device is the “server”. Details are listed later on in this document.
UDP:
For situations where Telnet is not available (for example - working with some PLCs) another option is to connect to
the device using a UDP connection. A special protocol is defined for working with UDP, see details below in the
section "Details of User Commands”.
USB Virtual COM Port:
A Mini-B USB connector is provided on the EA-1 device in addition to the RJ-45, to allow customers to connect to the
device separately from the Ethernet for configuration purposes. This connection can be used to query or set the IP
address for the first time, or to switch between dynamic and static IP address modes. For example, if the user is not
certain of the IP address of the device and therefore cannot connect via the Ethernet connector, they have the
option to connect via the USB port and query the IP address in an independent way from the Ethernet.
More details of using this connection are added below together with the basic configuration information.
This type of connection is supported also by the “OphirEthernetApp”software supplied with the device.
Ethernet Cables and Ground Connections to EA-1 Device:
See Appendix 3 below for information on what type of Ethernet cables are recommended to be used with the EA-1
device, and for information on issues of grounding and isolation.

EA-1 User Manual 8
Chapter 2 - Configuration:
Configuration of the EA-1 adapter is necessary before using the device for the first time. In particular, the IP address
(and other related settings) must be set. Two IP address modes are supported - static allocation (default) or dynamic
allocation (using DHCP).
In addition, the customer can optionally choose a “User Device Name” for the EA-1 adapter to make it easier to
identify the device on the network. This is particularly useful if there are several EA-1 devices connected on the
customer’s network at the same time.
This chapter describes how to set a static IP Address, how to change over to dynamic mode and how to change the
user device name. Several configuration methods are described in detail, including using the “OphirEthernetApp”
provided with the EA-1 Adapter, if using a PC running Windows. The user can choose whichever method is most
convenient.
The last section in this chapter describes how to return the device to factory default settings.
Device Default Configuration:
The device is shipped with the following default configuration settings:
IP Address…………………………………………. 10.0.0.2
Subnet Mask………………………………....... 255.255.255.0
Default Gateway………………………………. 10.0.0.1
User Device Name……………………………. (blank)
IP Address allocation……………………….. static (DHCP disabled)
Note: The default IP address “10.0.0.2” is a special IP address reserved for connecting directly to the device via a PC
rather than via a network. In most cases it will not be possible to connect to the device via a network with this IP
address. Conversely, if the IP address is changed by the customer to a new value, for example 172.16.16.49 as in the
examples below, it will still be possible to connect to the EA-1 device directly from a PC, but only if the default
gateway setting on the PC is also set to the correct value, in this example 172.16.16.1. See Appendix 2 for more
details.
Choosing New IP address for EA-1 Device:
The first stage in the EA-1 setup is to choose a new IP address for the device. In order to choose a new IP address,
reference must be made to the network to which the device will be attached. Most networks have a subnet IP
address (the first 2 or 3 parts of the IP address) which is fixed for all the devices on the network. Consult with your
network administrator to obtain a suitable IP address for your device.
Alternatively, it is possible to choose a “dynamic” IP address (DHCP mode) which is allocated automatically by the
network. The advantage of doing this is that there is no need to choose an IP address by hand. The disadvantage is
that the user may not know what IP address has been allocated to the device and therefore it will be more difficult
to connect to the device “by hand” via a Telnet connection or otherwise. The OphirEthernetApp will be able to
search and find the device when using DHCP mode.
Setting up a static IP address using HTTP:
In order to set a new static IP address using HTTP, the device must first be connected directly to a PC via its network
port (RJ-45 socket) using the supplied cross-over cable, and a web browser opened to IP Address “10.0.0.2”

EA-1 User Manual 9
An IP address for the EA-1 adapter needs to be obtained from the network administrator; this example uses an IP
Address 172.16.16.49, Subnet Mask 255.255.255.0 (default), IP Gateway 172.16.16.1
Note: In order to connect to the device using a PC, it may be necessary to first set the PC to a static IP address.
Instructions for doing this are shown in Appendix 2 below.
The following page should be shown on the web browser once a connection is established for the first time:
Click on “Ethernet Properties” and the following page should be displayed (on the left):
>>
Enter the new IP address, and click on “Save”. The following message will be displayed at the bottom of the
webpage:

EA-1 User Manual 10
The settings have been saved in the device EEPROM but will only become active after the next power up of the
device.
Before disconnecting, repeat the above process for the Subnet Mask and Default Gateway settings, and press “Save”
for each one. See example above (on the right).
Now the device should be powered down (if using PoE, disconnect the Ethernet cable; if using the 12v DC input,
disconnect the power cable). Reconnect the cable to power up the device again, and reestablish the HTTP
connection as above. The IP address to use for connecting the second time will be the new IP address entered above,
for example 172.16.16.49.
Note: At present there is no option to switch on DHCP (Dynamic IP address allocation) using a button, this can be
done using other methods, see below, or by typing the command “$ND 1” in the web browser from the “Standard
Command” page (see details for this command below).
Setting up a static IP address using Telnet:
If using a Telnet connection, the method is similar to the process described above for HTTP, except that a connection
must first be established using Telnet, and changing the IP address and other settings must be done manually by
sending commands.
In order to open a Telnet terminal on a Windows PC, the user should first check that Telnet is enabled on the PC.
Open “Control Panel”, then choose “Programs”, then choose “Turn Windows features on or off” (this requires
administrator privileges on the PC):
The “Windows Features” box will open; it might take a few seconds for it to be populated: