Scribd
Upload
151 views

Matrox IrisGTR Upgrade Procedure

This document provides instructions for upgrading the Matrox Imaging Operating System (MIOS) on a Matrox IrisGTR camera. It describes how to automatically upgrade the MIOS when connecting from Matrox Design Assistant X, or manually from a USB key or over SSH. It also describes updating the camera's BIOS after upgrading the MIOS, which is required for most upgrades. Additional backup and restoration procedures are included to preserve camera settings and data.

Uploaded by

i_aordaz
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
151 views

Matrox IrisGTR Upgrade Procedure

This document provides instructions for upgrading the Matrox Imaging Operating System (MIOS) on a Matrox IrisGTR camera. It describes how to automatically upgrade the MIOS when connecting from Matrox Design Assistant X, or manually from a USB key or over SSH. It also describes updating the camera's BIOS after upgrading the MIOS, which is required for most upgrades. Additional backup and restoration procedures are included to preserve camera settings and data.

Uploaded by

i_aordaz
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 7

Matrox IrisGTR Upgrade Procedure

Table of Contents
Introduction .............................................................................................................................................................. 1
Procedure for Automatic Upgrade of MIOS .............................................................................................................. 1
Updating the Matrox Iris GTR BIOS ........................................................................................................................... 5
Do I need to update the BIOS? .......................................................................................................................... 5
Procedure ......................................................................................................................................................... 5
Additional Procedures .............................................................................................................................................. 6
Procedure for Manual Installation of MIOS via ssh .............................................................................................. 6
Procedure for Manual Installation of MIOS from USB key ................................................................................... 6
Procedure for Installing MIOS using the Reset Camera Options menu................................................................ 7

Introduction
After installing Matrox Design Assistant X, to connect to an IrisGTR with a DA 5.0 or 5.1 runtime, it will be
necessary to upgrade the software on the camera. A new version of the Matrox Imaging Operating System
(MIOS) containing the necessary Design Assistant runtime environment will be transferred to the camera and
then will be transformed into the current operating system. The new system is distributed as an .iso file.

The MIOS upgrade can be done automatically when the DA design time tries to connect to an IrisGTR with a
lower version.

Note: If you require “downgrading” a camera – for example returning it to 5.1, use any of the methods under
Additional Procedures.

BIOS upgrade

Typically the new MIOS absolutely requires the camera’s BIOS to be updated. This must be done immediately
after upgrading the MIOS.

Procedure for Automatic Upgrade of MIOS


1. Backup any important data from your IrisGTR – the upgrade will wipe all information on the camera’s
disk.
a) In particular if you have been making many changes to deployed projects from the Operator View, it is
recommended that in Design Assistant you Synchronize recipes between the runtime and the design
time project. Import any recipes that you created at runtime and want to keep. After the camera
upgrade, you will redeploy the projects.
b) Copy any folders of images or other data that were stored on the IrisGTR that you want to keep.
c) Project Change Validator data is stored on each IrisGTR together with the deployed project. If you have
created validation sets that you want to use after the upgrade, make sure to back them up. For
example if I have deployed a project called BottleInspection, its validation information is held in
\\gtr320xxx\mtxuser\da\Projects\BottleInspection\ValidationSet. After the upgrade, after you have
redeployed the project, copy back the ValidationSet folder.

1
2. Install your new version of Design Assistant (e.g. DA X Version 1905)
3. Connect Remote to your GTR

4. It will detect a version mismatch. Click Upgrade if you are ready to upgrade now (backups done?). Note
that DA X Version 190x uses internal numbering 6.0.

5. Browse to the location where you placed the .iso file that you downloaded as part of the installation or
upgrade package, for example MIOS-01.01.125.001-DA-6.0.189.iso

Acknowledge that you have backed up your data. Click Update

6. The .iso file will be copied to the camera. This may take several minutes for each of the items that get
added to the dialog
2
The next stage may take 25 minutes overall – with nothing visibly changing for periods of 5 or 6 minutes.

The final stage should be:

NOTE: A small number of early production cameras do not have the ability to automatically power cycle
themselves.

3
In these rare cases you will be shown the following timeout message. This is normal. Simply power cycle the
camera to complete the update.

7. When attempting to connect for the first time to the new OS, you are prompted to accept the EULA.
You must follow the link and accept the agreement by clicking on I Agree. The page will change to the
Portal Home page.

>>>

8. UPGRADE THE BIOS following the instructions later in this document


9. Restore any settings that were made in MILConfig. In particular if you had enabled any Industrial
communication protocols, and made other configuration changes for Ethernet/IP, Profinet or MODBUS
you must make the changes again.

4
Updating the Matrox Iris GTR BIOS
Do I need to update the BIOS?
If a new BIOS has been provided, it is important to install it. You can verify current and available versions

on the camera’s Essential Information portal page.

Procedure
Updating the BIOS is a delicate operation that requires manual user intervention in order to ensure it is executed
at the correct moment. It also needs to be done without a power interruption.

Note: If a power failure occurs during the BIOS update process, the camera will have to be sent to Matrox RMA
for repair.

The update can be done in different ways. Choose the one that best fits your workflow.

1. Establish a terminal session


• using a local display and mouse/keyboard connected via the camera’s USB/VGA cable
• using a remote connection to the camera’s desktop, e.g. VNC
• using a remote connection to a command line session (e.g. telnet )
2. enter the commands; note that the system is case sensitive and the name of the IR file includes its
version number. The following examples shows version 11.0 build 18, but you will probably see a
more recent version, for example IR110023.

cd /opt

cd BIOS

sudo ./IR110018.bin

In the rare circumstance that you receive a message “Error: file offset + size...”

Enter the command again, for example


5
sudo ./IR110018.bin

Screen shots and more detailed instructions for users very unfamiliar with the MIOS or Linux system may be
found in the document “Updating the IrisGTR BIOS.pdf”.

Additional Procedures
In situations where it is necessary to change the version of the camera software on a large number of cameras
an alternate method may be more efficient.

Note – regardless of which method is used to update the MIOS, you must still verify the BIOS version and, if
necessary, update it as described above.

Procedure for Manual Installation of MIOS via ssh


If the IrisGTR is reachable on the network and you are familiar with ssh, putty and linux command lines, you can
use an alternate procedure of copying the iso file directly to the camera and issuing the commands to change
the recovery iso, and to use the recovery iso on the next boot. If you have a large number of cameras to
upgrade, this might be the most efficient approach. Contact Technical support if you require the detailed
procedure

1. Copy the iso file to /home/mtxuser on the camera


2. Open an ssh connection with the desired camera using putty, telnet, or equivalent.
• When prompted to log, logon with mtxuser with password Matrox
3. Change recovery iso of the camera to the new iso file copied in the first step. Working in the folder
containing the new iso,
• setrescue.sh update MIOS-‘<iso file name>’.iso
4. Configure next boot to start rescue process. Re launch setrescue.sh update with “CURRENT” as a
parameter (in uppercase)
• setrescue.sh update CURRENT
5. Reboot unit
• sudo reboot
6. Rescue process should now start
7. When complete, update the BIOS, see below.

Procedure for Manual Installation of MIOS from USB key


If the camera is not reachable through the network, we can also rescue the camera with a USB bootable drive.

1. Burning an ISO to a bootable USB key


a. Connect a blank USB key with a capacity of 2 G bytes, or more to your Microsoft Windows
development computer.
b. Launch Rufus (the Reliable USB formatting utility) on your development computer. This
utility can be downloaded from the web or from the camera by entering http://gtrxxxx:8080
and clicking on the Rufus link.
c. When using Rufus, make sure to specify a FAT32 partition on your USB key, and to select the
appropriate ISO image.
d. Follow all on-screen instructions.
2. Upgrading the MIOS using a USB key
a. Connect your bootable USB key, a monitor, mouse, and keyboard to your Matrox Iris GTR,
using a USB hub and the IrisGTR’s USB/VGA cable.
b. Reboot your Matrox Iris GTR. When the BIOS logo appears, press the ESC key to open the
BIOS utility menu.
c. When the BIOS utility menu opens, select the Boot Manager utility icon to load the BIOS boot
device menu.
d. On the BIOS boot device menu, select the Legacy USB entries option. Matrox Iris GTR will
then boot from the USB key.

6
e.After the Welcome to Matrox Imaging operating system dialog appears, select Install to Hard
Drive option. Warning! This will replace the contents of your hard drive.
f. Follow all on-screen instructions.
3. When complete, update the BIOS, see below.

Procedure for Installing MIOS using the Reset Camera Options menu
A DA 5.0 IDE design time trying to connect to an IrisGTR with a newer runtime platform will show the following
message.

If you wish to “downgrade” the IrisGTR, use the Design Assistant Platform menu IrisGTR>> Reset Camera
Contents option. Browse to the location where you have the .iso file for the version you wish to downgrade to,
for example MIOS-01.00.589.001-DA-5.0.1158. After making a backup of information you wish to keep, as
described at the beginning of this document, click Update to install the iso.

You might also like