eyesuiteperimetry setup guide 03 eng

HAAG-STREIT AG, Switzerland, Phone: (+41-31) 978 0111, Fax: (+41-31) 978 0282, [email protected]

HAAG-STREIT AUSTRIA GmbH, Austria, Phone (+43-1) 895 0364, Fax (+431) 895 0368, [email protected]

HAAG-STREIT DEUTSCHLAND GmbH, Germany, Phone: (+49-4103) 709 02, Fax: (+49-4103) 709 370, [email protected]

HAAG-STREIT FRANCE, France, Phone (+33-4) 5009 0033, Fax (+33-4) 5009 7190, [email protected]

HAAG-STREIT UK, United Kingdom, Phone (+44-1279) 414969, Fax (+44-1279) 635232, [email protected]

HAAG-STREIT USA, INC., USA, Phone: (+1-513) 336 6858, Fax: (+1-513) 336 7828, [email protected]

OCTOPUS 900OCTOPUS 900OCTOPUS 900OCTOPUS 900

EyeSuite Perimetry EyeSuite Perimetry EyeSuite Perimetry EyeSuite Perimetry

Setup Guide © Haag-Streit AG #7220060 (Rev 3, 12/2007)

OCTOPUS 900 & EyeSuite Perimetry Setup

/21 © Haag-Streit AG

CONTENTS

1 General Issues 3

1.1 Requirements 3 1.2 Included materials 3 1.3 Disclaimer 3 1.4 Safety measures 3

2 Software Installation 4

2.1 Standard installation 4 2.1.1 MySQL Server CD 4 2.1.2 MySQL Server in different folders 5 2.1.3 EyeSuite Perimetry CD-ROM 6

2.2 Network Installation (Preliminary) 7 2.2.1 Small network: Control PC acts as Server 7 2.2.2 Network with dedicated server 7

3 Connecting and Updating the Octopus 900 10

3.1 Resetting the IP address 10 3.2 Setting the IP address and ports 10 3.3 Flash and FPGA update 10 3.4 Dongle codes 12

4 Individualize EyeSuite Perimetry 13

4.1 Owner address and user information 13 4.2 Adapt printout and viewing options 13 4.3 Default examination settings 14

4.3.1 Initial Basic settings 14 4.3.2 Operating procedures 14

5 Import and Export settings 15

5.1 Interface to Octopus 300 & 1-2-3 15 5.1.1 Serial connection to Octopus 1-2-3 and 300 15 5.1.2 Ethernet connection to the Octopus 300 15

5.2 Identification of incoming examinations 15 5.3 Import from PeriTrend 16 5.4 Export settings 16

5.4.1 PeriData export 16 5.5 Function tests 17

5.5.1 Monitoring the state of the instrument 17 5.5.2 Actively performing functional tests 17

6 Addendum 18

6.1 Octopus 900 Standard configuration (single PC) 18 6.2 Octopus 900 in small networks (no dedicated server) 19 6.3 Octopus 900 in standard networks (with dedicated server)20 6.4 Octopus 300 standard configuration (single PC) 21


© Haag-Streit AG /21

1 GENERAL ISSUES

The EyeSuite™ Perimetry software evaluates visual field data, imports visual fields from various perimeters and controls the OCTOPUS® 900.

1.1 Requirements

Minimum PC requirements for EyeSuite Perimetry are

• Windows XP SP2 (Home or Professional)

• P4 or compatible processor

• 1GB RAM

• 40GB free hard disk space

• CD-ROM or DVD drive

• Screen resolution 1280 x 1024 pixels (17" recommended)

For the operation of an Octopus 900:

• T100 Ethernet interface If the instrument runs in a network environments

• Network Switch Connecting the instruments

• Octopus 900Series While a connection between controlling PC and Octopus 900 via crossed ethernet cable may work, connecting via a network switch is strongly recommended.

• Octopus 300Series, 1-2-3 and 101: 1 x serial port "COM1" 9 pole and for the connection: serial cable 9pole 1:1 male/male, <10m

• Octopus 300Series network connection: Crossed Ethernet cable for direct PC connection or straight Ethernet cables for connection through a network (hub or switch).

Viewing and printing examination results is a free function of EyeSuite Perimetry to enable the use of the software in networked environments. Advanced functionality like progression analysis and the control of specific functions in the Octopus 900 require licensing and will be enabled with dongle codes. Certain functions described in this manual might not work unless you bought the respective functionality and received the corresponding dongle code.

1.2 Included materials

• CD-ROM "MySQL Server"

• CD-ROM "EyeSuite™ Perimetry"

1.3 Disclaimer

Haag-Streit has taken all required efforts to protect and safely handle any test result. The reliability of a PC environment is depending on many factors including hardware components, operating systems or even computer viruses that may cause loss of data under certain conditions.

Haag-Streit thus strongly recommends to perform a regular backup of all examination data to external media –for example CD-R or Flash memories.

Haag-Streit AG does not warrant for any consequences, complications or data loss caused by the usage of and/or decisions based on this software. By applying this software you agree with this disclaimer.

All HAAG-STREIT AG software including EyeSuite™Perimetry is copyright protected by HAAG-STREIT AG.

1.4 Safety measures

To avoid any risks, special messages appear.

Caution: Instructions that must be followed to avoid risk to the patient and / or the operator.

Attention: Instructions that must be followed to prevent damage to the perimeter.

Note: Hints for guaranteeing error-free functioning.

We strongly recommend to perform regular backups.

Attention: HAAG-STREIT is not responsible for damages resulting from the interpretation of examination-data.

HAAG-STREIT is not responsible for any data (Patient examinations) being lost.



2 SOFTWARE INSTALLATION

2.1 Standard installation

Please make sure you have the latest release of EyeSuite Perimetry.

Updates can be downloaded from http://www.octopus.ch

2.1.1 MySQL Server CD

EyeSuite Perimetry saves the examination data to a MySQL server. The MySQL server software can either be installed on a local PC (in single PC application or small networks) or on a dedicated server (in standard network environments).

Start with inserting the "MySQL Server" CD-ROM

Run Setup.bat from the MySQL CD

Click "Next >" (always use the default option)

Click "Next >"

MySQL will install in the C:\mysql folder. Click "Next >"

Leave the button on "Typical" and click "Next >"

Click "Finish" to complete.

If you installed mySQL in a different folder than the default folder (c:\mySQL) proceed with the next chapter. If you used the default folder continue here:

Click "Sart", "Run", and with Browse select the batch file

<CD-ROM drive>\Start_MySQL_Server.bat

Click "OK" to confirm the file and "OK" to run it, the following screen appears

followed by this screen

Close it again using the "X" symbol. An -icon in the taskbar shows that the server is now running.

MySQL server now always runs in the background.



2.1.2 MySQL Server in different folders

Especially on dedicated servers it is necessary to install mySQL on different drives and or folders than c:\mysql. If you changed the folder, proceed as follows:

In the 3rd screenshot on the previous page you

chose a different folder. This is the <installation folder>.

Now open the Windows Explorer (right click on "Start", then "Explorer". Open the <installation folder>\bin and run "winmysqladmin.exe"

MySQL-Administrator aus dem Explorer starten.

In der Tasklist a traffic light appears, furtherhand showing a red light.

Right click the traffic light and select "Show me".

The mySQL-Administrator window opens. Click on the tab "my.ini Setup"

Enter the following section (as shown in the example):

[mysqld]

basedir=<installation folder>\

datadir=<installation folder>\data\

Click on „Save Modifications“.

The traffic light turns green.



2.1.3 EyeSuite Perimetry CD-ROM

EyeSuite Perimetry contains the perimetry application and requires the prior installation of the mySQL server software either local or on a dedicated server.

Insert the "EyeSuite Perimetry" CD-ROM

Run "Setup.bat"

Choose the preferred language for the installation menues (German or English), click "OK"

Follow the recommendations in the setup menu, click "Next".

If you would like to continue with the installation you need to choose "I accept the terms of the License Agreement" and click "Next"

We recommend you use the suggested installation path. If you require multiple installation paths – for example to support EyeSuite Perimetry viewing stations under Windows Terminal Server – you might want to alter the installation path.

This is just an information overview. Click "Install"

Click "Done" once the installation is finished.

If the installation was performed on the PC controlling the Octopus 900, proceed as follows:

1. "Start", "Control panel", "Network connections"

2. Right click on the network connection and select "Properties"

3. "Advanced","Windows Firewall",button "Settings"

4. Go to "Exceptions" and click "Add Port"

5. Enter Port number 49153 Protocol TCP & UDP



2.2 Network Installation (Preliminary)

If you would like to access perimetry data from multiple PCs you need to make a network installation. In the addendum 6 you find the templates for various configurations to document your environment.

2.2.1 Small network: Control PC acts as Server

It is required that a local PC controls the Octopus 900. Local means, it needs to be on the same network switch.

If you have a small network you might want to use the OC controlling the Octopus 900 also as a server for your perimetry data. The according configuration is documented in Figure 5.

2.2.1.1 Server and control PC side

The server needs to open the communication port to exchange data with the viewing stations:

1. Follow the procedure in Standard installation for the PC controlling the Octopus 900

2. "Start", "Control panel", "Network connections"

3. Right click on the network on which the other PCs are connected (may be the LAN connection or the wireless network) and select "Properties"

4. Go to Advanced, "Windows Firewall", button "Settings"

5. Go to "Exceptions" and click "Add Port"

6. Enter Port number 3306 Protocol TCP

7. Confirm and quit the network settings

2.2.1.2 Viewing stations

In every viewing station perform the following steps

8. Follow the procedure in EyeSuite Perimetry CD-ROM

9. Open the folder C:\program files\EyeSuite in Windows explorer explorer

10. Rename the file EyeSuiteOctopus.jar to EyeSuiteOctopus.aaa

11. Do a right click on "Start", "EyeSuite", "EyeSuite" (or on the shortcut on the desktop) and click on "Properties"

12. Add "-db_server" to the target and confirm with "OK"

13. Double click the shortcut to run EyeSuite Perimetry, confirm the following error with "OK"



14. Now the file "c:\program files\eyesuite\octosoft.ini" has been created. Open it with the notepad.

15. Change the entries net.hostname and net.host_name from "localhost" to either the IP address or the PC name of your server (in this example the control PC for the Octopus 900).

16. To simplify the process you can change one "octosoft.ini" file and then copy it to all viewing stations.

2.2.2 Network with dedicated server

In any case the control PC for the Octopus 900 will require a local installation of EyeSuite perimetry according "2.1.3 EyeSuite Perimetry CD-ROM".

There are two possibilities to run EyeSuite Perimetry on a dedicated Server:

1. With local viewer installations

2. With Windows Terminal services

2.2.2.1 Server installation with local viewer installations

1. Follow "2.1.1 MySQL Server CD" to install MySQL Server on the dedicated Server

2. Follow steps 2 to 7 of 2.2.1.1 on the server

3. Follow 2.2.2.1 for all viewer stations. Note paragraph 16 of that procedure.



2.2.2.2 Server installation with Windows terminal services or Citrix

The database and viewing station installation will be on the server. Proceed as follows

1. Follow "2.1.1 MySQL Server CD" to install MySQL Server on the dedicated Server

2. Follow steps 2 to 7 of 2.2.1.1 (on the server)

3. Follow the procedure in" 2.1.3 EyeSuite Perimetry CD-ROM"

4. Open the folder C:\program files\EyeSuite in Windows explorer

5. Rename the file EyeSuiteOctopus.jar to EyeSuiteOctopus.aaa

6. Do a right click on "Start", "EyeSuite", "EyeSuite" (or on the shortcut on the desktop) and click on "Properties"

7. Add "-NoSingleInstanceCheck" to the target and confirm with "OK"

8. The software can now be called from all terminals simultaneously



3 CONNECTING AND UPDATING THE OCTOPUS 900

The Octopus 900 has the default IP address 172.16.42.32. Commands are sent from the PC to the Octopus using the TCP protocol. The video stream from the Octopus is transmitted from the Octopus 900 to the PC using the UDP protocol.

To change the IP address you need to configure your computer to be in the same address range 172.16.nnn.mmm with the subnet mask 255.255.0.0. nnn and mmm can be any number between 1 and 254.

Attention: To separate the UDP video stream which takes a considerable amount of the network bandwidth from the rest of your network you have to use a network switch between the Octopus 900, the controlling PC and the Ethernet wallplug (the connection to the network).

If the Octopus 900 and the Control PC are directly connected to the network, the network may become slow or even hang.

3.1 Resetting the IP address

If the IP address of the Octopus 900 has accidentally been changed or is not known, it is not possible to establish connection to the instrument. In this case the instrument has to be reset to the original IP address 172.16.42.32. To do so keep the following 3 buttons pressed while turning on the instrument.

Figure 1: Reset combination for the IP address.

3.2 Setting the IP address and ports

Note: Every PC with EyeSuite Perimetry within the same network potentially is able to connect to the Octopus 900. To prevent unintended remote control and image data flow in the network, change the Octopus 900 IP address prior to the connection with any network.

To configure the Octopus 900 you might need to temporarily change the IP address of your PC to 172.16.nnn.mmm. The change of the IP address requires Administrator rights and can be done under "Start", "Control Panel", "Network Connections". Please contact the responsible person for your network to define the final static IP address of your Octopus 900.

Please refer to your computer's operating system manual for further details on setting the computers IP address.

To change the IP address of the Octopus 900

1. Make sure your computer's IP address is in the same range as the Octopus 900's IP address

2. Connect the Octopus 900 and your PC either directly via a crossed Ethernet cable or via a network Switch using straigt Ethernet cables.

3. Run EyeSuite Perimetry, go to "Perimetry", "Service / Diangostic", "Connection"

4. Click "Connect to OCTOPUS"

5. The connection is established if the information on serial number is shown and the status line shows the according statement.



6. Enter the foreseen IP address into the "OCTOPUS addresses", "IP address" field and click "Save to OCTOPUS"

7. Wait about 30 seconds until you heard the instrument gave one high and 3 low beep sounds

8. Change the IP address under "OCTOPUS connection", "IP address" and click on "Connect to OCTOPUS" to reconnect again. It may be required that you change the IP address of your own computer to become part of the same network address range again

9. To save the new Octopus 900 IP address in your EyeSuite Perimetry software click the disk icon.

3.3 Flash and FPGA update

Note: For the correct operation of the Octopus 900 it is required to check and if necessary update the Flash and FPGA software as part of an installation or update.

1. Go to "Perimetry", "Service / Diagnostic", "Version information"

2. Compare the Flash version and FPGA version with the ones under "c:\program

files\EyeSuite\dataocto\download". Updates are available on http://www.octopus.ch

3. If the installed version is older, click on the "…" button to select a new programming file

4. For the Flash update select the "*.bin" file, for the FPGA update select the "*.pom" file and click "Open"

5. Click on "Save to OCTOPUS". The following message confirms the start of the process

6. When the software is transmitted to the Octopus the following message appears. Keep waiting.

7. Wait until the instrument stopped making beeping sounds for about 30 seconds, then confirm with "OK".

8. If you started with the Flash software update, continue with the FPGA if there is a new version and vice versa.



9. Click "Print" to receive a documentation of the Octopus 900 settings and versions. This is also helpful when talking to the Octopus tech support.

10. Following is an example of the Version printout:

3.4 Dongle codes

Specific functions of EyeSuite Perimetry and the Octopus 900 are optional and require a dongle code for operation.

To receive a dongle code proceed as follows:

1. Go to "Configuration", "Setup", "Options"

2. Select all the options that have been bought initially or additionally click options you intend to buy

3. When you click "Print", the PC-ID is shown on the right side and a form is printed out.

4. Fill in the form and fax it to your Octopus representative or call them with the PC-ID at hand.

5. You receive the following form with the dongle information:

6. Enter the dongle code and click "Save". You will then need to restart EyeSuite Perimetry.



4 INDIVIDUALIZE EYESUITE PERIMETRY

4.1 Owner address and user information

Under "Configuration", "Setup", "Administrative information" you can enter two address lines, a logo, a list of referring physicians and standard diagnosis expressions. Click in the "Enable" fields to activate your entries.

Make sure to click Save before you leave the screen.

The printout will include the information as follows:

4.2 Adapt printout and viewing options

In "Analysis", "Setup" you can define the representation of left and right eyes on screen and printouts as well as define the graphs for the 4-in-1 representation.

The binocular view with the setting "Left (OS) / Right (OD)" will provide the same view as for the patient. This allows to more easily assess the full extension of binocular viewing.

Figure 2: Binocular printout in "Left (OS) / Right (OD)" mode

Also the single and series display of both eyes is influenced with this setting:

Figure 3 Series overview in "Left (OS) / Right (OD)" mode



4.3 Default examination settings

There are two kind of presettings. The general preferred settings "Basic settings" and the "Operating procedures"

4.3.1 Initial Basic settings

Go to "Perimetry", "Setup", "Basic settings" to change the general operation features of the Octopus 900.

� Buzzer: This turns on and off the audible beep that comes with a stimulus and catch trial presentation. It is to the preference of the operator if the buzzer should be turned on or off.

� Chinrest sensor: This sensor automatically recognizes the position of the head and interrupts the examination if the patient moves the head off the chinrest. It should always be turned on.

� Background illumination: The Octopus 900 allows to define the standard background illumination to be either 4asb (as with all prior Octopus full field perimeters) or to be set to 31.4asb (as with the Octopus 1-2-3, 300 and Humphrey perimeters). This setting will influence new examinations. If a follow up examination is performed, the background intensity will be taken from the previous examination.

All other settings should reflect the most common program / strategy and preferences of the physician.

In future versions of the EyeSuite Perimetry software there will be a follow up button that automatically allows to perform the same test that was done with a patient at the last visit.

4.3.2 Operating procedures

In order to facilitate standard examination settings the procedure codes allow to define the most common combinations of program pattern, strategy and examination method. In the future, these procedures can be selected with labelled buttons.

To create a new Standard Operating Procedure SOP: Click "New", set the desired parameters, click "Save":

� Select the test method (white/white or blue/yellow)

� Choose the background in white/white to be the same as defined in the "Basic settings"

� Choose the examination program. Most common are * G1 for screening and follow up in the central 30° * M1 as macular test * 32 as equidistant pattern in the central 30° * 07 as an overview test up to 75° * LVC as Low vision test in advanced disease stages

� Test strategy: Normal: double bracketing method; 10-15 minutes per eye

Dynamic: Optimized threshold strategy: 5-7 minutes p.e.

TOP: Optional fast strategy: 2-3 minutes per eye

� Fixation target: Cross marks: For tests like G1 including the center spot Central point: Recommended for macula and blind spot Ring: Recommended in central vision losses

� Phases and Stages: Allows to predefine the inclusion of peripheral areas or the double testing of areas.

Please refer to the program overview for detailed information what area and which test locations are being examined with which Program and Phase.

�

�

�

�

�

�

�

�

�



5 IMPORT AND EXPORT SETTINGS

EyeSuite Perimetry can import visual field examinations either from files, the serial cable or via network. The first supported instruments are the Octopus 1-2-3 and 300. Others are to follow.

EyeSuite Perimetry has an interface to EMR systems. To configure this interface and to test the operation please refer to the "EyeSuite Perimetry EMR Interface" manual.

5.1 Interface to Octopus 300 & 1-2-3

5.1.1 Serial connection to Octopus 1-2-3 and 300

For the serial interface connection go to "Import", "Setup", "Basic settings".

� In "Device type" select "OCTOPUS 1-2-3/301/311"

� In "Interface" choose the serial port to be used

� In "Baudrate" choose "9600"

Click on the "Enable" field below the baudrate.

5.1.2 Ethernet connection to the Octopus 300

This requires the separate installation or configuration of an FTP server transmitting data between the Octopus 300 and the PC (Server). Please refer to the Octopus 300 LAN manual for installation and setup of the FTP server and the Octopus 300. A schematic template is shown in section "6.4 Octopus 300 standard configuration (single PC)"

� Select the folder where data is stored by the FTP server, transmitting between the PC and the Octopus 300. This usually is c:\zzd\1

All examinations transmitted to this folder will automatically be received

5.2 Identification of incoming examinations

When visual fields are received, a window quickly pops up to inform about the import process.

As soon as the import process is finished, the following message remains until confirmed with "OK":

All examinations with name and first name are identified automatically. Examinations that only contain the date of birth require separate identification. This is shown with blinking "Import" and "Identify examination data" fields.

� Select an existing patient to assign the visual field

� Select the visual fields to be assigned In case multiple visual fields have been imported, select the correct one(s) with a right click on the perimeter icon and the selection of the specific examination line

� Click the "Assign" button to finalize the import

�

�

�

�

�

�

�



5.3 Import from PeriTrend

EyeSuite Perimetry directly imports PeriTrend static and GKP kinetic examinations.

To import existing data from Peritrend go to "Import", "Import examination data" and click the button "…"

Now you can select the file untersuchungen.mdb to import existing kinetic examinations (default path c:\program files\octopus\KinDat) or multiple files *.pvd to import static examination results (default path c:\program files\octopus\ExDat)

When you selected the examination file(s) click open

Click on "Import" to start the import of all files. Wait until all files are imported.

5.4 Export settings

EyeSuite Perimetry does support sorted exportation of results for statistical analysis as well as interface functions to third party software. These functions will be extended in the future.

5.4.1 PeriData export

Peridata is a perimetry analysis software by Dr. Jörg Weber, Germany.

In order to export visual fields to PeriData go to "Export", "Setup", "Perimetry".

The most simple means of transferring examination results to Peridata is to select the "Standard folder" �. No further settings are needed.

For individual Peridata installations it is possible to deselect "Standard folder" and select a specific folder instead. We do not recommend "Export and delete" as there currently is no simple means of re-importing PeriData examinations to EyeSuite Perimetry.

To export a visual field to Peridata go to "Patients", "Data management", "Examination directory".

�



Select the examination(s) to export and click the export

button

If the export is successful the following message appears; confirm with "OK"

If the last exported exported examination was not imported to PeriData yet, this message pops up:

Make sure to run PeriData with an open Peridata examination file and then try to export again.

The following setting is required in Peridata under "Extra", "Options":

5.5 Function tests

5.5.1 Monitoring the state of the instrument

To perform simple tests like the function of the response button or head position recognition go to "Perimetry", "Service / Diagnostic", "Monitoring". All switch positions and the camera image are shown online.

5.5.2 Actively performing functional tests

Using the built in test functions easily allows to check the basic functionality of the instrument for calibration and verification.

The functional tests are described in details in the service manual. If they have been used for any reason, the instrument will not allow regular examinations until it is turned off and back on again.



6 ADDENDUM

6.1 Octopus 900 Standard configuration (single PC)

Figure 4: Always set a network switch between the Octopus 900 and the PC. This ensures correct data flow.



6.2 Octopus 900 in small networks (no dedicated server)

Figure 5 Never attach the Octopus 900or its control PC to a hub or to a wall plug directly. Always use a local network switch for connection.



6.3 Octopus 900 in standard networks (with dedicated server)

Figure 6 Never attach the Octopus 900or its control PC to a hub or to a wall plug directly. Always use a local network switch for connection.



6.4 Octopus 300 standard configuration (single PC)

eyesuiteperimetry setup guide 03 eng

Documents