Fire-i software

Overview

Fire-i software

WDM drivers and control application software based on Microsoft or Unibrain’s 1394 stack & DirectShow;
for comprehensive control, display and capture of IIDC compliant Firewire (1394a – 1394b) Digital Cameras.

NEW! Fire-i™ 4.x Software is a major new release which introduces many new features and support of new advanced 1394b cameras from AVT, PointGrey, Sony, Toshiba-Teli, Basler etc.
This new release adds support for Windows 8 and S1600 (1600 Mbps) 1394b standard.
In specific, special support has been added for AVT’s ‘jumbo packets’ mode, PointGrey’s dual packet mode and Sony’s software broadcast trigger modes.

Fire-i™ software now supports software DMA multiplexing functionality. This provides the ability to connect and stream simultaneously more cameras that the hardware DMA limit of the firewire adapters allow. (Typical firewire adapters have 4 DMA channels).
Note: Multi-DMA functionality is available only in Fire-i software, running under ubCorePro drivers.

Fire-i™ software main features:

  • IIDC 1.31 & 1.32 compliant.
  • DirectShow – WDM based drivers, WIA compatible.
  • Multiple cameras operation from same control panel.
  • Cameras preview shared by several computers.
  • Frames, timed frames and live video capture in any encoding format.
  • Advance IIDC features support like Pixel Binning, automatic bus synchronization, broadcast trigger etc.
  • TCP/IP streaming, integrated Web Server.
  • Full user-configurable 16 bits support.
  • Support for control by absolute values.
  • Ability to resize, rotate, flip the image.
  • Title and time/date inclusion in the picture (timestamp).
  • Support of any format including user-defined, partial scan (Format_7).
  • Color RAW and RAW-8/16 mode conversion.
  • Capture frames in BMP (uncompressed), JPEG, TIFF & TIFF-16 bit and video in any video codec.
Unibrain’s Fire-i™ Camera drivers are compatible with:   
Note:  In order for Labview to support WDM drivers (and our drivers), a separate SDK (IVision) has to be installed. For more information, visit: http://www.hytekautomation.com/Products/IVision.html

Features

Supported Cameras:

  • Generic driver for all IIDC compliant models
  • Specific drivers for models of Unibrain, Sony, AVT, Basler, Hamamatsu, Pixelink, IMI-Tech, Toshiba-Teli, PointGrey, Sony, ISG, Hitachi, Baumer, IMI-Tech, ISG etc.

Operating Systems supported:

Windows XP/2003/Vista/Windows 7/8, 32 bit and 64 bit

Hardware supported:

Fire-i™ application operates with Unibrain’s or any third party 1394 OHCI PCI/PCMCIA/PCI-express/Express card compliant adapter, or any Desktop/Portable PC with built-in 1394 OHCI support.

For non-Unibrain cameras, permanent operation requires the use of a software license Product Key or a harware licensed special Unibrain Firewire PCI or PCI express adapter.

For advanced multi-camera video recordings:

Software for distributing and controlling uncompressed video recordings on different systems is available from Unibrain as
Fire-i™ Remote application.

For Developers:

Full SDK of Fire-i™ 4.0 is available from Unibrain as Fire-i API™ Vision – Imaging toolkit.

Package contains:

  • Fire-i™ 4.0 camera drivers and application.
  • Driver support for all 1394b (Firewire-800) IIDC cameras (using the Fire-i ubCore package).
  • One software activation product key code for one camera or one firewire adapter (user’s choice).

You can download an evaluation (demo) version of the software from here:
Note: The demo version is fully functional and includes the drivers for all supported IIDC firewire digital cameras. It will display only a floating watermark with the Unibrain logo while streaming or capturing frames. The watermark is removed when the drivers become licensed.

Fire-i™ Software Order Part Number: 1137

Fire-i API™ drivers & SDK version history

4.00 (November 2012)

  • Added: support for DAP Technology S1600 standard and Sony S1600 cameras.
  • Added: support for Windows 8, WHQL signed drivers for Windows 8.
  • Added: support for the new Fire-i 550, Fire-i 850 1394a CMOS camera models.
  • Added: option to save the frame buffer to a raw file (Fire-i Application).
  • Added: Fire-i NET SDK library is now merged into ubCore installation.
  • Fixed: Saving frames in Tiff16 format, the info was truncated to 8-bit (Fire-iApplication).
  • Fixed: Changing packet size in Format7, is not updated on the camera (Fire-iX, Fire-i.NET).

3.90 (September 2011)

  • Added support for choosing jpeg quality level when saving frames (Fire-i application).
  • Added trigger parameter set box, in the trigger dialog (Fire-i application).

3.83 (February 2011)

  • Added: support for absolute camera registers in DLL interface (UB1394.DLL).
  • Added: software absolute support for Unibrain cameras in the DLL interface (UB1394.DLL).
  • Added: ReadBlock and WriteBlock methods in Firei.NET(X) API (Firei.net.dll).

3.81 (December 2010)

  • Fixed: Unintended frame skip when using Snapshot button (Fire-i app).
  • Added event for getting full frame buffer access in Fire-i X SDK.
  • Added Call for pulling software trigger in Fire-i X SDK.
  • Fixed: Camera license tool updates license for adapters for UB1394.DLL usage

3.80 (April 2010)

  • Added software absolute shutter support for Unibrain Fire-i board Pro and industrial cameras.
  • Added option for desired time of video recording.

3.75 (October 2009)

  • WHQL certified IIDC camera driver for Windows XP/Vista/7.
  • Added support for Unibrain Fire-i 980 5 Mpixel 1394b camera.
  • Fixed: Problems with saving frames from Little-Endian cameras.

3.74 (April 2009)

  • Added: Support for Windows 7, 32/64 bit.
  • Added: FrameCapture dialog – select frames to skip instead of time intervals.
  • Fixed: Fire-i application should remember last FPS selected.
  • Fixed: Fidcam.sys IIDC driver must first stop the camera before detaching isochronous descriptors.
  • Fixed: Fire-i application now remembers the last selected RAW mode conversion for a camera.

3.73 (December 2008)

  • Added: Support for new Unibrain 1394b cameras.
  • Fixed: YMONO16 properties menu item disabled if camera supports only Raw16
  • Fixed: Directshow video image disrupted after standby-resume.
  • Fixed: YMONO_16 little endian conversion occurs in kernel mode.

3.71 (June 2008)

  • Added: Add capability in CFiCamera to select the video format with a GUI.
  • Added: Add FiGetLUT and FiSetLUT functions for LUT functionality for Unibrain industrial cameras.
  • Fixed: Various issues with audio compressors when capturing video.
  • FiConvertToRGB24 does conversion to BGR instead of RGB.
  • System Crash when selecting Raw-8 format in Fire-i Application.

3.70 (February 2008)

  • Added: RAW-8 mode support in Fire-i WDM driver and Firei.dll.
  • Added: RAW mode support and Format-7 color codings in Firei.dll.
  • Added: DMA channel multiplexing at the driver level, completely transparent to user mode (Fire-i ubCore only).
  • Added: support for AVT Pike ‘jumbo packets’ mode, PointGrey Grasshoper ‘dual packet’ mode. Read more information here.
  • Added: support for new Sony 1394b cameras.
  • Added support for Visual Studio 2008, Microsoft Platfordm SDK 6.0 and latest revision of DirectX SDK.
  • Fixed: Fire-i application fails on “Install Fire-i Drivers” menu item.
  • Fixed: Fire-i Application – Max Region button does not restore max F7 packet size.

3.63 (October 2007)

  • Added: IIDC driver automatically breaks image isochronous requests according to system DMA limit.
  • Fixed: IIDC driver sets initial max packet size for Format-7 correctly.
  • Added: Fire-i application saves the RAW conversion selection
  • Added: Fire-i application can display the camera’s configuration ROM as a tree.

3.62 (August 2007)

  • Added: Fire-i application now saves/loads correctly to/from camera memory presets and/or the registry, as well as to/from XML files.
  • Fixed: Capturing video with compression does not hang fire-i application while “copying capture file”.
  • Fixed: Auto installation of drivers now works correctly.
  • Added: New FPS Stamp setting, that displays the current FPS reading on the video window of a camera.
    It has similar options to the TimeStamp feature.
  • Fixed minor other bugs.

3.61 (March 2007)

  • Added TIFF-16 mono frame capture file format.
  • Added full support for Windows XP/2003 64 bit (via separate installation build).
  • Added dual 32-bit/64-bit filter support on x64 platforms.
  • Added support for extended shutter/exposure times (greater than 33 ms) for Fire-i digital camera and
    Fire-i board camera.
  • Redesigned the evaluation mode: Now all formats are available in demo mode and a watermark appears on the
    live image stream or captured frame/video, which is removed when the drivers are licensed.
  • Fixed error “fail to enumerate capture driver” occurring with various cameras.

3.60 (January 2007)

  • Added support Windows Vista.
  • Added support for controlling more than 32 cameras in Fire-i application and CFiCamera class.
  • Added support for AVT Pike, 1394b cameras.
  • CFiCamera and FiCommon static libraries converted to DLLs.
  • MFiCamera converted to Visual Studio 2005 syntax.
  • Projects provided (ready) for VC++ 6.0, Visual Studio 2003, Visual Studio 2005.

3.50 – 3.51 (June 2006)

  • Added support for all new 1394b (Firewire-800) cameras.
  • Added support for new Unibrain firewire industrial cameras.
  • The new ubCore IIDC camera kernel driver (ubdcam.sys) is WDM & DirectShow compliant. The Fire-i application has been ported under ubCore and the full source code is provided.
  • New licensing scheme: A unique software license is associated per camera or firewire adapter.
  • Added Configuration Property pages for the fiyuv.dll “Video For Windows” codec. The configuration dialog allows to enable and setup raw mode conversion as well as other conversion options for usage with 3rd party applications.
  • Added support for Microsoft Visual Studio 2005.

3.0 – 3.03  (July 2004 – February 2006)

  • Fire-i™ ubCore DLL is now included in Fire-i™ API. Fire-i™ ubCore DLL exports a set of camera control and display functions and is based on Unibrain ubCore 1394 driver stack. Along with it the latest version of the ubCore drivers, which is needed by Fire-i™ ubCore DLL, is included in Fire-i™ API.
  • The full source code of the Fire-i™ application is now included.
  • Full Y Mono 16 bit display and capture support.
  • Big parts of the Fire-i™ API source code are now moved into static libraries that can be linked with a project instead of including the whole source code into it.
  • Precompiled versions of all the Fire-i™ API libraries are now provided. This simplifies the task of getting started and working with Fire-i™ API and the DirectShow SDK.
  • Still Frame Capture is now possible using other formats than RGB 24. The user is now able to use any codec provided by the system in order to capture still frames. The default codecs included in most systems include jpg, gif, tiff and many other options.
  • XML files can be used in order to describe a DirectShow filter graph with distinct filter connections. Methods are provided by the Fire-i™ API libraries that build a DirectShow filter graph given an XML file.
  • Methods that allow block reads and writes in the camera address space are now provided.
  • New structures and enumerations are included that allow full control and configuration of the trigger register. Methods are provided that allow the user to setup the current trigger polarity, the current trigger mode and all the other capabilities provided by a trigger register.
  • New headers are provided that contain structures specific to the manipulation of every camera register defined by the IIDC specification.
  • New samples :
    Fire-i™ Application is a full blown explorer like camera control and preview application. The Fire-i™ application demonstrates just about every functionality offered by the Fire-i™ API and can be used as a basis for any type of customer application.

2.50 (April 2004)

  • Locking mechanism. Now a range of HASP dongle keys provides functionality in different levels according to user needs. This allows the developer to downsize the license price of according to final application specs.
  • TCP Streaming support. TCP support through windows media video architecture has been added.
  • Y Mono 16 bit support. Functionality to both acquire and display Y Mono 16 bit formats has been added to the Fire-i™ API.
  • Raw mode display support. 4 different raw mode conversion methods have been added to the Fire-i™ API YUV to RGB conversion filters. The user can acquire a raw Bayer image from the camera in Y Mono format and use Fire-i™ API in order to convert and display the data in color in real time.
  • Support for multiple Format_7 modes has been added. Previously only the first one was recognized.
  • .net support has been added with availability of a managed camera control and image acquisition class. Furthermore the class is open source so that the user can modify it to fit her needs.
  • Direct support added for many camera models. Compared to Generic Support, this handles vendor specific corrections and convenient model icon display.
  • The driver property pages for the exposure controls now display absolute control values instead of meaningless numbers read from the camera. e.g. Shutter is displayed in ms or us depending on the current value.
  • Renewed help reference.
  • New Class :
    FiCamera serves as a wrapper to the CFiCamera class and provides functionality of the Fire-i™ API library through .net compliant languages. Writing Fire-i™ API applications with VB.net and C# is as easy now as it was with C++.

2.0 (February 2003)

  • Format 7  (Partial Scan) support. Support for user defined scalable formats is added to the driver and is exposed to the user mode developer through new interfaces.
  • WIA support. The Fire-i™ Drivers support the new Windows Image Acquisition API provided by Microsoft in Windows XP and Windows Me.
  • TWAIN support. Through WIA support in the Fire-i™ Drivers TWAIN support is also added since the WIA API implements a thin layer of compatibility for TWAIN drivers.
  • The driver property pages for the exposure controls now display absolute control values instead of meaningless numbers read from the camera. e.g. Shutter is displayed in ms or us depending on the current value.
  • Support of Windows Me, 2000, XP, not of 98SE.
  • New interfaces :
    • FiVideoFormatConfig provides methods to query the camera formats and set-up the camera in a specific format. This interface provides methods to set-up a camera in Format 7 and also provides a property page that allows camera format set-up from 3rd party applications.
    • FiExpoControl interface. New methods were added into this interface in order to be able to compute the absolute value of some camera exposure control like shutter and gain.
  • New Class :
    Cficamera serves as an abstraction layer to DirectShow and the Fire-i API™ provided extension interfaces. Programming Fire-i API™ with this class makes things a lot simpler and it is highly recommended. The CFiCamera class makes extensive usage of the ficommon.cpp source file.
  • New samples :
    • Multigrabber allows grabbing of frame samples from multiple cameras. This sample makes extensive usage of the ficommon.cpp source file.
    • CamControl is a simple console mode application that allows the control with simple commands of the camera features like gain, brightness, focus etc. This sample makes extensive usage of the ficommon.cpp source file.
    • ConsoleGrabber is a simple console mode application that uses the CfiCamera Class in order to start the first camera found on the bus and save camera frames on user demand.
    • ficommon.cpp. This is a source file that is located in the samples directory and contains over 60 utility functions. This source file is included in the Fire-i API™ samples and can be included in any customer application. Located in ficommon.cpp the user will find a variety of utility functions that handle many of the complexities of DirectShow and COM interface programming.

1.21 (July 2002)

  • Three new OIDs were added: OID_CAMERA_NODE_ID, OID_PARENT_PHYSICAL_PORT and OID_CAMERA_SERIAL_NUMBER.
  • Added a new function FiBusReset that issues a long or short bus reset
  • Added a new function FiYuv2Rgb that converts a YUV frame to RGB
  • Added a new parameter to FiCreateDisplayWindow so that the caller can choose if hardware overlays are going to be used or not.
  • Changed the Fire-i sample application. The Fire-i sample is now comprised of one executable that handles both the control of the camera and the display of the frames.
  • Reading camera capabilities improved. FiOpenCameraHandle burdens less the camera with asynchronous transactions.
  • Support of SONY XCD-X700, XCD-SX900, DFW-X700 & DFW-SX900 digital cameras.

1.1 & 1.2

These versions were released in order to fix all known bugs, no major changes in features neither in the Fire-i API™ architecture

1.0 (November 2001)

First official release of Fire-i SDK and drivers.

FireAPI™ / Fire-i API™ SDK licensing information

Any application developed with FireAPI™ or Fire-i API™ or Fire-i X™ SDK requires a license of the runtime drivers and redistributable software. Unibrain offers a variety of licensing options and customers can chose the one that is most applicable for their system.
The main concept behind the licensing, is that the drivers ‘activate’ (license) each firewire adapter or firewire camera that is attached on the system and is running the Unibrain software. In detail:

(a) Software licensing: Software licenses are in the form of product keys which activate the drivers per camera or per firewire adapter (customer choice). The GUID (Globally Unique Identifier) of the device must be provided to Unibrain and then we will return to the customer the activation code.
The device GUID can be obtained from Fire-i or FireAPI authorize utilities, as the picture below shows:


Software activation for third party (non Unibrain) IIDC firewire camera

A separate product key is required for each 1394 adapter (or 1394 camera) that has the ubCore or Fire-i drivers installed.

(b) Hardware licensing: Hardware licenses are in the form of special versions of Unibrain’s PCI or PCI express firewire adapters, which embed a license. Applications running on top of those adapters will be fully functional and no product keys are required. Any device (including IIDC firewire cameras) that is connected on a Unibrain licensed adapter will also operate in licensed model.
A hardware license is also embedded on every Unibrain IIDC firewire camera. Below you can see an example from FireAPI™ authorize utility running in a Unibrain licensed adapter:


Unibrain hardware license adapter licenses any device that will connect on it

Software or hardware licenses can be purchased online or by contacting Unibrain and its distributors or resellers. Volume license discounts apply and special OEM programs are also available. For more information please contact us at: sales@unibrain.com.

You can download an evaluation (demo) version of the software from here:

FireiSetupX64_112912.exe (64bit Windows XP/Vista/7/8)

FireiSetupX86_112912.exe (32bit Windows XP/Vista/7/8)

Note: The demo version is fully functional and includes the drivers for all supported IIDC firewire digital cameras. For 3rd party cameras, it will display only a floating watermark with the Unibrain logo while streaming or capturing frames. The watermark is removed when the drivers become licensed.
If you are using a Unibrain camera, no license is required.