Teledyne USB VISION BLACKFLY S User manual

INSTALLATIONGUIDE
BLACKFLY®S
Version 28.0
Revised 2/14/2023
2/14/2023
©2015-2023 FLIR Integrated Imaging Solutions Inc. All rights reserved.

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 BlackflyS 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
contact us.
Trademarks
Names and marks appearing on the products herein are either registered trademarks or trademarks of Teledyne FLIR,
LLC 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?
2/14/2023
©2015-2023 FLIR Integrated Imaging Solutions Inc. All rights reserved.

Table of Contents
1 BlackflyS Installation Guide 1
2 Handling Precautions and Camera Care 2
3 BlackflyS Installation 3
3.1 Preparing for Installation 3
3.2 Installing your Interface Card and Software 4
3.3 Installing Your BlackflyS—Cased Models 5
3.4 Installing Your BlackflyS—Board-level Models 7
3.5 Powering Your BlackflyS 8
4 Tools to Control your BlackflyS 9
4.1 Using the Spinnaker® SDK 9
4.1.1 SpinView Camera Evaluation Application 9
4.1.2 Custom Applications Built with the Spinnaker API 9
4.2 Using GenICam Applications 10
5 Configuring BlackflyS Setup 11
5.1 Configuring Camera Drivers 11
5.2 Configuring the IP Address—GigE 11
5.3 Allocating Bandwidth—GigE 12
5.3.1 Determining Bandwidth Requirements 12
5.4 Configuring Other Ethernet Settings—GigE 13
5.4.1 Stream Channel Destination Address 13
5.4.2 Heartbeat 13
5.5 BlackflyS Firmware 14
5.5.1 Determining Firmware Version 14
5.5.2 Upgrading Firmware 14
6 BlackflyS Physical Interface 16
6.1 BlackflyS Cased Physical Description 16
6.2 BlackflyS Board-Level Physical Description 17
6.3 BlackflyS Dimensions 18
6.3.1 Keepout Layer—Board-level Models 22
6.4 Interface Connector 23
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide i

6.4.1 Ethernet Connector 23
6.4.2 USB3.1 Connector 23
6.5 Interface Cables 25
6.6 Interface Card 25
6.7 General Purpose Input/Output (GPIO) 26
6.8 Mounting your BlackflyS 26
6.9 Camera Temperature and Heat Dissipation 27
6.10 Lens Mounting 28
6.10.1 Back Flange Distance—Cased Models 29
6.11 Non-Volatile Flash Memory 29
6.12 Dust Protection—Cased Models 29
6.13 Infrared Cut-Off Filters—Cased Models 31
6.14 Readout Method 33
6.14.1 Global Shutter 33
6.14.2 Rolling Shutter with Global Reset 33
7 Input/Output Control 35
7.1 General Purpose Input/Output (GPIO) 35
7.2 GPIO Electrical Characteristics 38
7.3 Input Timing Characteristics 42
7.4 Output Timing Characteristics 44
8 Troubleshooting 46
8.1 Support 46
8.2 Status Indicator LED 47
Contacting Us 48
Revision History 48
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide ii

1 BlackflyS Installation Guide
1 BlackflyS Installation Guide
Welcome to the BlackflyS camera. We offer a number of resources to assist you with the BlackflyS.
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.
Blackfly SUSB3 Support Articles Blackfly SUSB3 Resources
Blackfly SGigE Support Articles Blackfly SGigE Resources
Blackfly S Board-level Support Articles Blackfly S Board-level Resources
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 1

2 Handling Precautions and Camera Care
2 Handling Precautions and Camera Care
Warning! Do not open the camera housing. Doing so voids the
Hardware Warranty described in the Terms and Conditions on our
website.
Your Teledyne 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.
nIf you have purchased a board-level camera you should take the following additional protective measures:
nEither handle bare handed or use non-chargeable gloves, clothes or material. Also, use conductive shoes.
nInstall a conductive mat on the floor or working table to prevent the generation of static electricity.
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
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 2

3 BlackflyS Installation
3 BlackflyS Installation
3.1 Preparing for Installation
What system configuration is recommended?
Recommended System Configuration:
nOS—Windowsor Linux (32- or 64-bit)
nCPU— Intel i5 or greater
nRAM—4GB
nPorts—USB3 host controller GigE network adapter
nSoftware—Microsoft Visual Studio 2015 (to run and compile example code)
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)
nFor GigEcameras— Powered Ethernet switch or Ethernet power injector (if using PoE)
nFor USB3 cameras—USB3 cable (see Interface Cables)
nFor board-level models—TF38 to FPC USB3 or RJ45 PoE panel mount adapter
nFor board-level models—Heatsink (recommended)
nFor board-level models—FPC cable
nGPIOcable (see General Purpose Input/Output (GPIO))
nFor board-level models—Lens mount and lens (see Lens Mounting )
nFor cased models—Lens (see Lens Mounting ) (type of lens mount is model dependent)
nTripod adapter (optional) (see Mounting your BlackflyS)
nInterface card (see Interface Card)
Teledyne FLIR sells a number of the additional parts required for installation. To purchase, visit the Accessories page.
Have you visited the Teledyne FLIR website?
A downloads account is required to download software and firmware.
1. Go to www.flir.com/account.
2. Enter your email address and click Continue.
3. Complete the Create an account form and click Continue.
4. You will receive an email with a link to activate your account.
5. Once activated, you can login using the credentials you've created.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 3

3 BlackflyS Installation
The Blackfly S GigE resources page /Blackfly S USB3 resources page /Blackfly S Board-level resources page has many
links to help you operate your camera effectively, including:
nSpinnaker®SDKsoftware, including drivers (login required)
nFirmware updates and release notes (login required)
nDimensional drawings and CADmodels
nDocumentation
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 . USB3 cards appear under Universal Serial Bus Controllers . 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.
Forge requires Spinnaker version 3.0 or later.
a. Go to the Spinnaker SDK page.
b. Click the Download button. You are prompted to login, if not already.
c. Select your operating system. Depending on your selection there may be other versions to select.
d. After download is complete, open the file to start the Spinnaker setup wizard.
e. Follow the steps in each setup dialog.
3. For GigE cameras—Enable jumbo frames on the Ethernet card
a. In StartÒAll ProgramsÒSpinnaker SDKÒSpinView, right click on the Network Adapter and select Adapter
Configuration, then select IP Configuration.
b. Click Open Network Connections.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 4

3 BlackflyS Installation
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.
See How to Optimize GigENetwork Adapter Settings for more information on configuring for best performance.
3.3 Installing Your BlackflyS—Cased Models
1. Install the Tripod Mounting Bracket (optional)
The ASA and ISO-compliant tripod mounting bracket attaches to the camera using the included
screws.
2. Attach a Lens
Unscrew the dust cap from the lens holder to install a lens. Note: the camera can be used with a removable 5 mm C-
mount adapter.
3. 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.
a. If using PoE, connect a powered Ethernet switch or Ethernet power injector in between the card and the
camera.
4. Plug in the GPIO connector if required
GPIOcan be used for power, trigger, and strobe.
5. Confirm Successful Installation
Run the SpinView application: StartÒAll ProgramsÒSpinnakerÒSpinView
The SpinView application can be used to test the camera's image acquisition capabilities.
6. Configure IPSettings if necessary
For GigE cameras 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, in SpinView change the IPaddress of the camera to be on
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 5

3 BlackflyS Installation
the same subnet as the NIC.
Changes to your camera's installation configuration can be made using the SpinView application.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 6

3 BlackflyS Installation
3.4 Installing Your BlackflyS—Board-level Models
1. Prepare the lens mount.
The board-level models can use C-mounts, CS-mounts, or S-mounts.
For C- and CS-mounts, install the retainer, flip over and place IR filter in it then install the gasket.
2. Remove sticker and install lens mount.
The sensor is covered with a protective sticker. Remove the sticker. If any residue is present, clean the
sensor surface with a non-abrasive cotton swab and isopropyl alcohol cleaning solution. Immediately
install the image board over the prepared lens mount.
3. Install a heat sink.
A heatsink (ACC-01-7000) is recommended but depends on your design and usage.
4. Connect the FPC cable to the panel mount adapter then connect the adapter to the interface card.
A TF38 to FPCUSB3 panel mount adapter allows a USB3 cable connection to a PC.
A TF38 to FPC RJ45 PoE panel mount adapter allows a GigE cable connection to a PC.
5. Attach a Lens
6. Plug in the GPIO connector if required
GPIOcan be used for power, trigger, serial input output, and strobe.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 7

3 BlackflyS Installation
7. Confirm Successful Installation
When the camera is first connected, the operating system automatically installs the camera driver. Camera drivers are
available with the Spinnaker SDK installation.
Run the SpinView application: StartÒAll ProgramsÒ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.5 Powering Your BlackflyS
For cased GigE cameras—Power can be provided over the Ethernet interface (PoE). To use PoE, you must also have a
powered Ethernet card, a powered Ethernet switch, or an Ethernet power injector.
Power can also be provided externally through the GPIO interface: 12 V nominal (8 - 24 V). Power consumption is 3W
maximum.
For board-level GigE cameras—Power can be provided over the Ethernet interface (PoE) with the RJ45 PoE bulkhead
accessory (ACC-02-7002).
Power can also be provided externally through the GPIOinterface:5Vnominal (4 - 5.5 V).
For cased USB3 cameras—Power can be provided over the USB3 connector to the host computer. The ideal input
voltage is nominal 5 V DC. For the USB3 connector to provide power, the host controller must be connected to the
computer's power supply.
Power can also be provided externally through the GPIO interface: 12 V nominal (8 - 24 V). Power consumption is 3W
maximum.
Note: Some systems, especially those with laptop computers or
longer cable lengths, may not provide adequate power through the
USB3 cable which could result in intermittent operation. The use of
external power through the GPIOis required for these systems.
For board-level USB3 cameras—Power is provided over the USB3 connector to the host computer. The ideal input
voltage is nominal 5 V DC. For the USB3 connector to provide power, the host controller must be connected to the
computer's power supply.
If both power sources are connected the camera always uses external power over the GPIO connector.
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.
How can I power my USB3 camera?
Related Knowledge Base Articles
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 8

4 Tools to Control your BlackflyS
4 Tools to Control your BlackflyS
The BlackflyS'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®SDK
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.
The Spinnaker SDK is available for download from the Spinnaker page.
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.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 9

4 Tools to Control your BlackflyS
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.
USB3 Vision is a communication interface for vision applications based on the USB 3.0 technology. All cameras
supporting USB3 Vision interact the same way with software also supporting USB3 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.
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
Using USB3Vision cameras with National Instruments' Acquisition Software
Using USB3Vision cameras with A&BSoftware's ActiveUSB
Using USB3 Vision cameras with Matrox Imaging Library
Using USB3 Vision cameras with MVTec's Halcon software
Using USB3/USB2 cameras with Cognex VisionPro
USB3 Vision and Third-Party Applications Resources
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 10

5 Configuring BlackflyS Setup
5 Configuring BlackflyS 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 BlackflyS Firmware.
5.1 Configuring Camera Drivers
Camera drivers are provided as part of the Spinnaker SDK. The first time the camera is connected to the computer, the
operating system installs the driver.
To manage and update drivers use the SpinView application:
1. Start SpinView:
Start Menu Ò All Programs Ò FLIRSystems Spinnaker SDK Ò SpinView
2. From the Devices list, select the camera and click the Switch Driver button.
3. Select the driver from the drop-down list.
4. Click Install Driver.
5.2 Configuring the IP Address—GigE
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 Teledyne 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.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 11

5 Configuring BlackflyS Setup
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 ÒSpinnaker SDK ÒSpinView
5.3 Allocating Bandwidth—GigE
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.
5.3.1 Determining Bandwidth Requirements
The maximum bandwidth available is 125 MB/s. This includes image data, control data and image resends, which occur
when frames are being dropped. Each image and each packet has a certain amount of overhead that will use some
bandwidth. Therefore, when calculating your bandwidth requirements, you should not attempt to use the full
maximum of 125 MB/s.
To calculate your bandwidth requirements:
Determine your required resolution, frame rate, and pixel format (bytes per pixel)
(Height x Width x Frame Rate x Bytes per Pixel)/1000000 = Bandwidth in MB/s
For example, for an image that is VGA, 82 FPS, Mono8:
640 (H) x 480 (W) x 82 (FPS) x 1 (BPP) = ~25 MB/s
Once you have calculated your required bandwidth, you can allocate an amount to each camera by adjusting the Device
Throughput Limit. Allocating a specific amount to each camera helps to avoid dropped packets due to a data burst. You
would do this in a set up with multiple cameras, or in a situation where the system bandwidth might be limited or
shared due to hardware architecture.
Bandwidth Requirements for Multiple Cameras
Multiple cameras can be set up in two ways: 1) Each camera is connected directly to a single Ethernet port; or, 2)
multiple cameras are connected to a single port through an Ethernet switch.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 12

5 Configuring BlackflyS Setup
If using the first method, each camera has the full bandwidth allocation available to it. If using the second method, the
combination of all cameras on a switch cannot exceed the available bandwidth.
Setting Up Multiple GigECameras
Related Knowledge Base Articles
5.4 Configuring Other Ethernet Settings—GigE
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.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 13

5 Configuring BlackflyS Setup
To disable Heartbeat use:
nGenICam—Under Transport Layer Control GevGVCPHeartbeatDisable.
nSpinnaker API—The Spinnaker SDK supports disabling heartbeat.
5.5 BlackflyS Firmware
Firmware is programming that is inserted into the programmable read-only memory (programmable ROM) of most
Teledyne 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 Firmware
Firmware can be upgraded or downgraded to later or earlier versions using SpinView, part of the Spinnaker SDK.
Before upgrading firmware:
nInstall the Spinnaker SDK, available from the Spinnaker page.
nDownload the latest model package zip file for the product, available from the camera's resources page:
BFS-PGE Camera Resources BFS-U3 Camera Resources BFS-Board-level Camera Resources
To upgrade the firmware:
1. Start Menu Ò All Programs Ò 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.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 14

5 Configuring BlackflyS Setup
Teledyne FLIR machine vision software and firmware version numbering systems
Determining my camera's firmware version
Should I upgrade my camera firmware or software?
Related Knowledge Base Articles
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 15

6 BlackflyS Physical Interface
6 BlackflyS Physical Interface
6.1 BlackflyS Cased Physical Description
GigE USB3
1. Lens holder
See Lens Mounting
2. Glass/IR filter system
See Dust Protection—Cased ModelsInfrared Cut-Off Filters—
Cased Models
3. M2x2.5 mounting holes
See Mounting your BlackflyS
4. General purpose I/O connector
See General Purpose Input/Output (GPIO)
5. Status LED
See Status Indicator LED
6. Interface connector
See Interface Connector
7. M2x2.5 mounting holes
8. M3x2.5 mounting holes
See Mounting your BlackflyS
9. Camera label
Contains camera information such as
model name, serial number and required
compliance.
2/14/2023
©2015-2023 FLIR Integrated Imaging
Solutions Inc. All rights reserved.
Teledyne FLIR Blackfly®S Installation Guide 16