Flir Oryx r User manual

INSTALLATIONGUIDE

FLIR

ORYX®

Version 4.1

Revised 4/9/2020

Oryx part numbers with 10G and 10GS are functionally the same and differ only in dimensions and mass.

Inc.

FCC Compliance

This device complies with Part 15 of the FCC rules. Operation is subject to the following two conditions: (1) This device

may not cause harmful interference, and (2) this device must accept any interference received, including interference

that may cause undesirable operation.

Korean EMCCertification

The KCC symbol indicates that this product complies with Korea’s Electrical Communication Basic Law regarding EMC

testing for electromagnetic interference (EMI) and susceptibility (EMS). This equipment has received a conformity

assessment for use in a business environment, and it may cause radio frequency interference if it is used in a home

environment.

Hardware Warranty

The warranty for the Oryx camera is 3 years. For detailed information on how to repair or replace your camera, please

see the terms and conditions on our website.

Export Control

The ECCN for this product is EAR099.

WEEE

The symbol indicates that this product may not be treated as household waste. Please ensure this product is

properly disposed as inappropriate waste handling of this product may cause potential hazards to the

environment and human health. For more detailed information about recycling of this product, please

Trademarks

Names and marks appearing on the products herein are either registered trademarks or trademarks of FLIR Systems,

Inc. and/or its subsidiaries.

Licensing

To view the licenses of open source packages used in this product please see What open source packages does

firmware use?

Inc.

Table of Contents

1 Oryx Installation Guide 1

2 Handling Precautions and Camera Care 2

3 Oryx Installation 3

3.1 Preparing for Installation 3

3.2 Installing Your Interface Card and Software 4

3.3 Installing Your Oryx 5

3.4 Powering Your Oryx 5

4 Tools to Control your Oryx 7

4.1 Using the Spinnaker® Software Development Kit 7

4.1.1 SpinView Camera Evaluation Application 7

4.1.2 Custom Applications Built with the Spinnaker API 7

4.2 Using GenICam Applications 8

5 Configuring Oryx Setup 9

5.1 Configuring the Camera Driver 9

5.2 Configuring the IP Address 11

5.3 Allocating Bandwidth 11

5.4 Configuring Other Ethernet Settings 12

5.4.1 Stream Channel Destination Address 12

5.4.2 Heartbeat 12

5.5 Camera Firmware 13

5.5.1 Determining Firmware Version 13

5.5.2 Upgrading Camera Firmware 13

6 Oryx Physical Interface 14

6.1 Oryx Physical Description 14

6.2 Oryx Dimensions 15

6.3 Interface Connector 18

6.3.1 Ethernet Connector 18

6.4 Interface Cables 18

6.5 Interface Card 18

6.6 General Purpose Input/Output (GPIO) 18

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide i

6.7 Mounting Your Oryx 19

6.8 Case Temperature and Heat Dissipation 19

6.9 Lens Mounting 20

6.9.1 Back Flange Distance 20

6.10 Non-Volatile Flash Memory 20

6.11 Dust Protection 20

6.12 Infrared Cut-Off Filters 21

7 Input/Output Control 22

7.1 General Purpose Input/Output (GPIO) 22

7.2 GPIO Electrical Characteristics 23

7.3 Input Timing Characteristics 26

7.4 Output Timing Characteristics 28

8 Troubleshooting 30

8.1 Support 30

8.2 Status Indicator LED 31

8.3 Network Status LEDs 31

Contacting Us 32

Revision History 32

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide ii

1 Oryx Installation Guide

Welcome to the Oryx camera. We offer a number of resources to assist you with the Oryx.

nSpinnaker SDK—software development kit that provides GenICam-compliant controls to create applications for

the camera. Spinnaker is available for download. Each installation includes API documentation for C, C++, and C#.

nRelease Notes—information about the current firmware release including feature additions or changes, bug

fixes, and known issues.

nSpecifications—information about the camera model as it performs with the current firmware.

nGetting Started—quick start guide for installing the camera and software.

nInstallation Guide—information about installing the camera and SDK, the physical interface and mechanical

properties, troubleshooting and how to get help. This document is available as a PDF for download or as a

webpage included in the firmware release package.

nTechnical Reference—information about the features supported by the camera model with the current

firmware, including: image format control, acquisition control, sequencing, binning/decimation, and others. This

document is available as a PDF for download or as a webpage included in the firmware release package.

nFirmware—programming inserted into the programmable ROM of the camera that can be updated in-field. New

firmware packages are available for download and include both the firmware file and documentation.

These resources as well as knowledge base articles and application notes can be found on the Support page for the

product.

Oryx Support Articles Oryx Resources

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 1

2 Handling Precautions and Camera Care

Your FLIR machine vision camera is a precisely manufactured device and should be handled with care. Here are some

tips on how to care for the device.

nAvoid electrostatic charging.

nWhen handling the camera unit, avoid touching the lenses. Fingerprints will affect the quality of the image

produced by the device.

nTo clean the lenses, use a standard camera lens cleaning kit or a clean dry cotton cloth. Do not apply excessive

force.

nExtended exposure to bright sunlight, rain, dusty environments, etc. may cause problems with the electronics

and the optics of the system.

nAvoid excessive shaking, dropping or any kind of mishandling of the device.

Cleaning the imaging surface of your camera

Related Knowledge Base Articles

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 2

3 Oryx Installation

3.1 Preparing for Installation

What system configuration is recommended?

Operating

System CPU RAM Ports Software to run and

compile example code

Recommended

System

Configuration

Windows or

Linux (32- or

64-bit)

Intel i7 or greater 8 GB dual

channel

10GBASE-T

Ethernet port

Microsoft Visual Studio 2010,

Visual Studio 2013, or

Visual Studio 2015

Note: Refer to 10GigE Best Practices: Setting Up a Single-camera

System for information on best practices for host system

configuration, cabling, and Oryx camera settings.

Do you have all the parts you need?

To install your camera you need the following components:

nFor GigEcameras—Ethernet cable (see Interface Cables)

nGPIOcable (see General Purpose Input/Output (GPIO))

nLens (see Lens Mounting )

nTripod adapter (optional) (see Mounting Your Oryx)

nInterface card (see Interface Card)

FLIR sells a number of the additional parts required for installation. To purchase, visit the Accessories page.

Have you visited the FLIR website?

The FLIR machine vision products page has many resources to help you operate your camera effectively, including:

nSpinnaker®SDKsoftware, including drivers (required for installation)

nFirmware updates and release notes

nDimensional drawings and CADmodels

nDocumentation

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 3

3 Oryx Installation

To access these resources:

1. Go to FLIR machine vision.

2. Click on your product family.

3. Click on Go to Support Page.

nOverview tab - links to software, knowledge base articles, and application notes.

nResources tab - links to camera references, technical references, getting started manuals, imaging

performance results, drawings, PCNs, firmware, and software.

3.2 Installing Your Interface Card and Software

1. Install your Interface Card

Ensure the card is installed per the manufacturer's instructions.

Connect the internal IDE or SATApower connector on the card to the computer power supply.

Alternatively, use your PC's built-in host controller, if equipped.

Open the Windows Device Manager. Ensure the card is properly installed. Ethernet cards appear under Network

Adapters. An exclamation point (!) next to the card indicates the driver has not yet been installed.

2. Install the Spinnaker® Software

Note: For existing users who already have Spinnaker installed, we

recommend ensuring you have the latest version for optimal

performance of your camera. If you do not need to install

Spinnaker, use SpinView to install and enable drivers for your card.

a. Go to the Spinnaker SDK page.

b. Click the Download button.

c. Select your operating system.

d. Select your version. You can also read release notes here.

nPython

nFull SDK - downloads all components

nWeb Installer - downloads only the installer and then retrieves components based on your selection

during install. This version requires an internet connection for the installation.

e. Select your version. On the preview page, click Download.

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 4

3 Oryx Installation

f. After download is complete, open the file to start the Spinnaker setup wizard.

g. Follow the steps in each setup dialog.

3. For Ethernet cards: Enable jumbo frames

a. In Start->All Programs-> Point Grey Spinnaker SDK->SpinView, right click on the Network Adapter and select

Adapter Configuration, then select IP Configuration.

b. Click Open Network Connections.

c. Click Change Settings.

d. Click on the Advanced tab and from the Settings list select Jumbo Packet.

e. Set the Value to 9014 Bytes and click OK.

3.3 Installing Your Oryx

1. Attach a Lens

Unscrew the dust cap from the lens holder to install a lens.

2. Connect the interface Card and Cable to the Camera

Plug the interface cable into the host controller card and the camera. The cable jack screws can be used for a secure

connection.

When the camera is first connected, the operating system automatically installs the camera driver. Camera drivers are

available with the Spinnaker SDK installation.

3. Plug in the GPIO connector

GPIOis used for power, trigger, serial input output, and strobe.

4. Configure IPSettings

By default, a dynamic IPaddress is assigned to the camera according to the DHCP protocol. If DHCP addressing fails, a

link-local address is assigned. If necessary, change the IPaddress of the camera to be on the same subnet as the NIC.

5. Confirm Successful Installation

Run the SpinView application: Start->All Programs-> Point Grey Spinnaker->SpinView

The SpinView application can be used to test the camera's image acquisition capabilities.

Changes to your camera's installation configuration can be made using the SpinView application.

3.4 Powering Your Oryx

Power is provided externally through the GPIO interface: 12 - 24 V.

Power consumption is:

nORX-10GS-32S4 — 11.8 W (11.3 nominal)

nORX-10G(S)-51S5 — 12.3 W (11.7 W nominal)

nORX-10G-71S7 — 13.6 W (13.2 W nominal)

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 5

3 Oryx Installation

nORX-10G(S)-89S6 — 12.6 W (12.3 W nominal)

nORX-10G(S)-123S6 — 13 W (12.8 nominal)

nORX-10G-310S9 — 13.9 W (13.6 nominal)

The camera does not transmit images for the first 100 ms after power-up. The auto-exposure and auto-white balance

algorithms do not run while the camera is powered down. It may therefore take several images to get a satisfactory

image.

When the camera is power cycled (power disengaged then re-engaged), the camera reverts to its default factory

settings, or if applicable, a saved user set.

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 6

4 Tools to Control your Oryx

The Oryx's features can be accessed using various controls, including:

nSpinnaker SDK including API examples

nSpinView camera evaluation application, included in the Spinnaker SDK installation

nThird-party GenICam applications

4.1 Using the Spinnaker®Software Development Kit

You can monitor or control features of the camera through Spinnaker API examples provided in the Spinnaker SDK, or

through the SpinView camera evaluation application. A Programmer's Guide and API Reference is included in the

installation.

4.1.1 SpinView Camera Evaluation Application

The SpinView application is a generic, easy-to-use streaming image viewer included with the Spinnaker SDK that can be

used to test many of the capabilities of your camera. It allows you to view a live video stream from the camera, save

individual images, adjust the various attributes, frame rates, features and settings of the camera. It includes tools for

updating firmware, managing drivers, IP addressing, and activity logging.

4.1.2 Custom Applications Built with the Spinnaker API

The Spinnaker SDK includes a full Application Programming Interface that allows you to create custom applications to

control your camera. Included with the SDK are a number of source code examples to help you get started.

Spinnaker API examples are provided for C, C++, C#, and VB.NET languages. These examples are precompiled for your

convenience.

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 7

4 Tools to Control your Oryx

4.2 Using GenICam Applications

GigE Vision is an interface standard that allows for fast image transfer over Ethernet networks. All cameras supporting

GigE Vision interact the same way with software also supporting GigE Vision.

For more information on the standard, visit visiononline.org.

The standard defines required elements for camera identification, control, and output. It uses GenICam, a programming

interface for camera attribute control. GenICam allows camera vendors to define features and attributes in an XML file

stored inside the camera. The file is parsed by the host application when the camera is initially discovered. One of the

key benefits of GenICam is the ability for camera vendors to introduce new camera-specific features without needing to

update the host application.

Each camera attribute, such as exposure time, is controlled by a specific GenICam feature. The camera includes an XML

device description file for interfacing with third-party GenICam-compliant APIs.

For more information on GenICam, visit emva.org.

Title

Getting Started with OpenCV

Getting Started with MATLAB

Getting Started with MVTec HALCON

Getting Started with Cognex VisionPro

Getting Started with Adaptive Vision

Getting Started with Matrox Imaging Library

Getting Started with Matrox Design Assistant

Getting Started with NI-MAX and LabVIEW

Getting Started with NI Vision Builder for Automatic Inspection

Getting Started with Third-Party Applications Resources

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 8

5 Configuring Oryx Setup

After successful installation of your camera and interface card, you can make changes to the setup. Use the tools

described below to change the IP Address or the driver for your interface card.

For information on updating your camera's firmware post installation, see Camera Firmware.

5.1 Configuring the Camera Driver

For the Oryx camera, ensure that PGRLWF driver version 2.7.3.92 or above is installed.

The PGRLWF driver should already be installed automatically using the Spinnaker SDK installer when the Camera

Evaluation option is selected. Or in the case of Application Development option, the driver is installed if you select the

GigE Driver checkbox.

Alternatively, you can manually install the driver. The PGRLWF files are located in:

C:\Program Files\Point Grey Research\Spinnaker\driver64

To verify your driver:

1. Launch SpinView:

Start-->All Programs-->Point Grey-->Spinnaker SDK-->SpinView

2. Select the camera.

3. In the Feature tree search box, enter "driver". The Device Driver Version feature is highlighted.

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 9

5 Configuring Oryx Setup

4. If you need to update the driver, right-click on the device and select Filter Driver Configuration.

5. In the Filter Driver Configuration window, ensure the driver is installed and enabled. Click Refresh if making

changes.

Note: If the filter driver is not installed, a caution icon appears next

to the device. Right-click on the device and select GigEFilter driver

is not installed-->Install filter driver to resolve.

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 10

5 Configuring Oryx Setup

5.2 Configuring the IP Address

When a new GigE camera is first powered and initialized, a dynamic IP address is assigned to the camera according to

the DHCP protocol. If DHCP addressing fails, a link-local address is assigned. You can configure the IP address using the

GenICam Features Transport Layer Control.

Alternatively, SpinView is a tool included with the Spinnaker SDK that allows you to set the internet protocol (IP)

configuration for any GigE interface cards or FLIR GigE Vision cameras connected to your system. Using SpinView, you

can:

nSet the IP address for the current connection.

nProgram a persistent IP address for the camera.

nConfigure the default IP addressing behavior of the camera on startup using a persistent IP, DHCP or LLA.

nEnable Jumbo Frames on the GigE NIC.

Both your camera and host adapter must have an IP address on the same subnet. This can be assigned in three ways:

nPersistent—The camera has a fixed IP address that does not change. Generally the address is within a closed

network range of 192.168.X.X.

nDynamic (DHCP)—The camera is set to automatically obtain an IP address. This means that the IP address may

change (within a range) every time the camera or computer is restarted. It may take up to one minute for the IP

address to resolve and the camera to enumerate.

nDefault (LLA)—The camera uses an IP address from the link-local address block 169.254.x.x.

The camera assigns its current IP address in the following sequence:

1. Persistent—Uses the defined IP address. If not available, then;

2. DHCP—Attempts to find a dynamic IP address. If not available, then;

3. LLA—Uses an LLA IP address.

SpinView can automatically force an IP address refresh. This detects the IP address of the Network Interface card and

automatically sets the camera’s IP address relative to the card.

To open SpinView:

Start Menu >All Programs >Point Grey Spinnaker SDK >SpinView

5.3 Allocating Bandwidth

The User Datagram Protocol (UDP) used by the GigE Vision standard provides no guaranteed transmission or fixed

timing mechanism. Therefore, bandwidth must be managed by the Device Throughput Limit, based on desired

resolution and frame rate.

Setting Up Multiple GigECameras

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 11

5 Configuring Oryx Setup

5.4 Configuring Other Ethernet Settings

5.4.1 Stream Channel Destination Address

The stream channel destination address (SCDA) register is used to specify the streaming destination IP address. The

default SCDA is the IPaddress of the network or computer to which the camera is connected. It can be set within a

range so that the camera sends data as a multicast. As long as switches in the path between the sender and receivers

support and are configured for multicasting, multiple receivers can listen to the data stream from the camera.

Multicast addresses are between 224.0.0.0 and 239.255.255.255.

Note: For more information on multicast address assignments, see

http://tools.ietf.org/html/rfc3171

To control SCDA use:

nGenICam—GevSCDA in the Transport Layer Control

5.4.2 Heartbeat

The heartbeat is a mandatory GigE Vision feature to monitor the connection between an application and the camera.

The application must continually reset the heartbeat timer, or the camera assumes an error has occurred and shuts

down the connection.

In general, the Spinnaker API manages the heartbeat at a low level; however the following two features are

controllable: Heartbeat Timeout and Heartbeat Disable.

Heartbeat Timeout

Heartbeat timeout is the time, in milliseconds, that the camera waits before closing the connection. Heartbeat timeout

can be set between 500 ms and 10 seconds. The default setting is 3000 ms (3 seconds). If there is no communication

between the camera and the application for longer than the timeout value, the connection is shut down.

To control Heartbeat Timeout use:

nGenICam—Under Transport Layer Control, GevHeartbeatTimeout.

nSpinnaker API—The Spinnaker SDK supports configuring heartbeat timeout.

Heartbeat Disable

The heartbeat is enabled by default.

To disable Heartbeat use:

nGenICam—Under Transport Layer Control GevGVCPHeartbeatDisable.

nSpinnaker API—The Spinnaker SDK supports disabling heartbeat.

4/9/2020

Integrated Imaging

Solutions Inc.

FLIR Oryx®Installation Guide 12

5 Configuring Oryx Setup

5.5 Camera Firmware

Firmware is programming that is inserted into the programmable read-only memory (programmable ROM) of most FLIR

cameras. Firmware is created and tested like software. When ready, it can be distributed like other software and

installed in the programmable read-only memory by the user.

The latest firmware versions often include significant bug fixes and feature enhancements. To determine the changes

made in a specific firmware version, consult the Release Notes.

Firmware is identified by a version number, a build date, and a description.

5.5.1 Determining Firmware Version

To determine the firmware version number of your camera:

nQuery the GenICam Device Control feature DeviceFirmwareVersion.

5.5.2 Upgrading Camera Firmware

Camera firmware can be upgraded or downgraded to later or earlier versions using SpinView, part of the Spinnaker SDK

available from the FLIR website.

Before upgrading firmware:

nInstall the Spinnaker SDK, available from the FLIR website.

nDownload the firmware file from the Support page Resources tab for the product.

To upgrade the firmware:

1. Start Menu-->All Programs-->Point Grey Spinnaker SDK-->SpinView

2. From the Device list, right click the camera and select Update Device Firmware.

If you get a Device is Active warning, close the Display pane or click the Disconnect button and right click the

camera again.

3. Browse to select the firmware file and click Open.

4. Click Yes to continue.

Warning! Do not disconnect the camera during the firmware update

process.

FLIR machine vision software and firmware version numbering systems

Determining my camera's firmware version

Should I upgrade my camera firmware or software?

Popular Digital Camera manuals by other brands

Panasonic

Panasonic Lumix DMC-GF7K owner's manual

Canon

Canon PowerShot SD950 IS Digital ELPH brochure

Nikon

Nikon Coolpix S3600 Reference manual

Canon

Canon PowerShot SX1IS user guide

Samsung

Samsung Digimax V800 user manual

Kodak

Kodak MD81 - Easyshare Digital Camera quick start

Sony

Sony Cyber-shot DSC-W560 Handbook

Polaroid

Polaroid izone Series quick start guide

Sony

Sony DSC-S45 - Cyber-shot Digital Still Camera instruction manual

Samsung

Samsung EC-SL420BBP user manual

Tesla

Tesla TSL-CAM-PT300 user manual

Onlincam

Onlincam C36 user manual

Perenio

Perenio PEIRC01 Installation and operation manual

Panasonic

Panasonic AJHDC27V - CAMERA VTR operating instructions

Kodak

Kodak PIXPRO X42 user manual

JAI

JAI SP-5000M-USB user manual

Olympus

Olympus CAMEDIA C-770 Ultra Zoom Basic Manual

Texas Instruments

Texas Instruments DM388 user guide

FLIR ORYX R User manual

Popular Digital Camera manuals by other brands