File Exchange

image thumbnail

FLIR Spinnaker support by Image Acquisition Toolbox

Spinnaker adaptor for Spinnaker supported cameras using Image Acquisition Toolbox

57 Downloads

Updated 21 Nov 2019

View License

This file exchange submission enables FLIR Spinnaker supported cameras to work with Image Acquisition Toolbox™. The Spinnaker adaptor is compatible with Spinnaker SDK Version 1.15 only.

Follow these instructions to install the adaptor:

Step 1: Install the Spinnaker SDK.

a) Download and run the EXE file.
Full EXE: https://www.dropbox.com/s/zc86tl3l280g95v/SpinnakerSDK_FULL_1.15.0.63_x64.exe?dl=1
Web EXE: https://www.dropbox.com/s/grq96dts265ct8q/SpinnakerSDK_WEB_1.15.0.63_x64.exe?dl=1

b) Proceed with setup. In the Installation Profile, select the ‘Camera Evaluation’ option.
c) Complete the installation process.

Step 2: Download the Spinnaker adaptor as MATLAB Toolbox (recommended) or as a zip file from the Download dropdown.

To install the adaptor as a Toolbox:
a) Download the Toolbox. This downloads an MLTBX file.
b) Drag and drop the MLTBX file into the MATLAB Command Window. This automatically opens the file and completes the installation.

To install the adaptor from a .zip file:
a) Download the zip file.
b) Unzip the file to a desired location.

Step 3: Register the Spinnaker adaptor in MATLAB.

a) Restart MATLAB if you have a session open.
b) If you previously registered an adaptor, unregister it using ‘imaqregister’.
c) Register the latest adaptor using ‘imaqregister’. (Refer to the readme.m file for instructions and an example.)

Notes:
1. This adaptor is only compatible with Spinnaker SDK Version 1.15.
2. This adaptor can be used with R2018b, R2019a, and R2019b.
3. Device-specific properties are only supported in R2019b.

Cite As

MathWorks Image Acquisition Toolbox Team (2019). FLIR Spinnaker support by Image Acquisition Toolbox (https://www.mathworks.com/matlabcentral/fileexchange/69202-flir-spinnaker-support-by-image-acquisition-toolbox), MATLAB Central File Exchange. Retrieved .

Comments and Ratings (40)

@John - You should use the DLL located in a subfolder whose name matches with the MATLAB version you are using. For example, if you are using MATLAB R2019b use the DLL located in the R2019b subfolder of the .zip attached to this submission.

@Hanlin - Sorry for the delay. I did notice an issue with R2018b DLL attached to this submission, will add a fix and update the submission soon.

Thanks,
Janak

Yiyu Zhou

With MATLAB 2019b I am able to change the settings (exposure, gain, etc) in MATLAB.

John

Where is the mwspinnakerimaq.dll located? Which subfolder is it located in?

Hanlin Zhu

I some how get rid of the "\mwspinnakerimaq.dll is not a valid adaptor" issue by switch to a .dll downloaded at the early stage of this post, it is 210kb in size, the current one for 2018b is 213kb, leave an email if you want me to share it to you, but it would be great if this old version can be included in this package

Thomas

Hello,
I'm inquiring about a linux compatible version of this? Any chance there is a beta version or a release in the near future?

Thanks,
Nolan

@Janak Thotakura , Thank you for your response! Unregistering and reregistering solved the problem!
Best,
Vasiliy

To those having crash issues with access violation, make sure you have the version of Spinnaker SDK cited in the readme above and not the newest one from FLIR.

Hi Ann,

Is the issue only with the 'imaqtool'? Were you able to use the adaptor in MATLAB from the command line?

A quick thing to try is to unregister the DLL and register it again.
- imaqregister('<path to DLL>', 'unregister')
- Restart MATLAB
- imaqregister('<path to DLL>')

If the issue continues to exist, please reach out to our support team along with the crash files generated to investigate the issue further.
https://www.mathworks.com/support/contact_us.html

To locate crash files,
https://www.mathworks.com/matlabcentral/answers/100816-how-do-i-locate-the-crash-dump-files-generated-by-matlab

Thanks,
Janak

Ann T.

Hello.. after I imaqregister the .dll, when I tried t oopen imaqtool, it crashes and complained about access violation. Do you have any pointer what I could do? thanks, Ann

thojuf

Hi,
is there an option to access device properties like frame rate, exposure time, gain,... I couldn't find it.
Thank you,
Thomas

Janak,

Thanks for the quick response! That solved the issue and now I have control over camera resolution.

Thanks!
Nolan

Hi Nolan,

The issue you are running into might be due to the binning setting of the device. Currently, these properties are not supported by the adaptor.

You can try the following,

1) Close all instances of MATLAB
2) Open SpinView GUI, double click on camera from the interface list and navigate to 'Image Format' section
3) Select 'ISP Enable'
4) The 'Binning Horizontal' and 'Binning Vertical' in the same window in GUI should be set to '1'
5) Click on 'Max Image Size' to set the ROI to maximum image size.
6) Close SpinView and open MATLAB to connect with the device and access available supported formats.
>> hwinfo = imaqhwinfo('mwspinnakerimaq')
>> hwinfo.DeviceInfo.SupportedFormats

Did the resolution change?

If the issue continues to exist, please reach out to our technical support.
https://www.mathworks.com/support/contact_us.html

-Janak


Hello,

I have a question in regards to supported image formats using the spinnaker SDK adapter. The camera that I am connecting using the SDK adapter allows a 12MP (4000 x 3000) resolution, however all of the available supported formats are at 1/4 of the available resolution (2000 x 1500). Are there resolution limits defined in this adapter that aren't immediately apparent or is this potentially a hardware related issue that I should discuss with FLIR?

Thanks,
Nolan

Hi Vasiliy,

It looks like the spinnaker adaptor you registered for R2018b is still in the MATLAB user preferences, which is causing a name conflict when you try to register a newer version of the adaptor.

You can try the following steps to resolve this issue.

1) Execute 'imaqregister' command in MATLAB to get all the registered 3rd party adaptor DLL paths.
2) Execute the below command to unregister the earlier version of Spinnaker adaptor in MATLAB. Replace <path> with the complete path to the Spinnaker DLL obtained after executing step 1.
>> imaqregister('<path>', 'unregister')
Ex: imaqregister('C:\Users\**\Downloads\FLIR Spinnaker support by Image Acquisition Toolbox\mwspinnakerimaq.dll', 'unregister')
3) Repeat step 1 to confirm that the Spinnaker adaptor is unregistered.
4) Register the new version of the Spinnaker adaptor by following the instructions mentioned in the description.

-Janak

Hello,
The camera was working fine before but after an update of 2018b literally during work it started giving me an error: "The name mwspinnakerimaq conflicts with a toolbox or third party adaptor." I removed 2018b, updated to 2019a, same thing. I have the Spinnaker SDK SpinView 1.15.0.63 and Image Acquisition Toolbox version 6.0 installed. Is there something I should try to jump start?
Thanks,
Vas

Hi Tar,

The recent update to this submission makes the adaptor functional in MATLAB R2019a. Download the latest files and register the right version of the DLL as mentioned in the description.

Thanks,
Janak

Tae Jin Kim

Hi everyone. Did anyone succeed in getting this to work in versions other than R2018b?
I'm crossing my fingers that this is not 'only for' R2018b only, but is also compatible with the newest R2019a version.

Jacky Lyu

@ Francesko Molla, @yuhai li. I did figure it out. Install the Spinnaker SDK Version 1.15 with Full SDK option rather than 'Camera Evaluation'. Then register the .dll file as describe above. You should be good to go.

Hi Az,

1) Spinnaker Adaptor is different from the Point Grey adaptor, this adaptor is only supported for R2018b version. Unfortunately, we do not have plans to support Spinnaker adaptor with earlier versions of MATLAB.

2) There is no direct support for USB3 vision in MATLAB. However, if the manufacturer provides GenTL producer drivers you can use this, https://www.mathworks.com/hardware-support/gentl.html

- Janak

Can I request: a) compatibility with R2014a and later as with previous PtGrey adapter? b) USB3 Vision native support?
Is there a formal process for either? Thanks! A

yuhai li

Hello Everybody. Could you solve the problem
"...\mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?"

@Mitya Reznikov @Jacky Lyu Same Problem for me.. any idea why would that be?

Jacky Lyu

@Mitya Reznikov, I have the same situation. The MATLAB will crash when I run the sample code. Do you find any solutions?

@Konstantinos For me registering the dll with Matlab launched using admin mode and restarting it on standard mode solved that problem.

I was able to install the adapter, but MATLAB crashes with "Access Violation Error" when I try to start the acquisition. Please help.

Hello Everybody. Could you solve the problem
"...\mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?"

I have exactly the same problem. Unfortunately, lack of functionality makes my camera useless at this point. Is there a chance to upgrade this package to fully functional version - as the one for FlyCap? Thanks!
Maybe anyone knows a workaround that would be useful for BFS-U3-51S5M-C ?

This driver adaptor is only a packaged version of the winvideo adaptor. What about the functionality we had with the previous adaptor that gave us full control of camera settings and functionality?

I have the same observation as Jeremy, this driver functionally is no better than the winvideo adaptor. With a blackfly S I see 30 fps and no other function than ROI. With some tweaking this camera is capable of ~400 fps with the point grey software which includes extensive controls. It would be good to have performance that at least approximates this...

@Jeremy @Dongjun, After installing the Spinnaker drivers please restart MATLAB so that the necessary paths added by the Spinnaker driver installation are reflected.

Jeremy, Thomas: Properties for the spinnaker adaptor will be added in a future release. The Image Acquisition toolbox development team is looking into it.

I don't have access to exposure properties either.

For me this adpator provides access to image bit number and ROI properties. I tried to drive a Blackfly S in the past using the winvideo adapter and I nearly had access to the same options I have with this new adapter.

I expected access to useful properties like exposure time as well, to be able to easily use my Blackfly S in a realistic configuration...

thojuf

Hi, can anyone of you access device properties such as Exposure with this adaptor? Under 'Device properties' all I get is 'Selected Source: Spinnaker', but nothing else. Thanks for your help.

Same error : "mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?".

I specified the full path as requested.

Get this error while registering the dll
mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?

@Brian, please refer to the updated instructions. Thanks

Brian Ofrim

Also unable to locate the mentioned .mltbx file

Attached .mltbx file is missing.

Updates

3.1

The issue with registering R2018b DLL fixed

3.0

Update for Spinnaker adaptor to work with MATLAB R2019b.

2.0

Update for Spinnaker adaptor to work with MATLAB R2019a

1.2

N/A

1.1

Installation instructions in the description have been updated.

MATLAB Release Compatibility
Created with R2019b
Compatible with R2018b to R2019b
Platform Compatibility
Windows macOS Linux