FAQs - FingerTec BioBridge SDK

Thursday, August 20, 2015 FingerTec 42 Comments


FingerTec terminals come bundled with either the TCMSV2 or Ingress software for a Time Attendance system. Both software packages come as a complete system for all your time attendance and door access needs. However, for system developers who would like to customize the software to incorporate features based on your own ideas or third party applications, you can access the BioBridge SDK software that comes together with your purchase of FingerTec terminals. The BioBridge SDK is a tool that allows you to customize your own software that can be integrated with your terminals for a personalized solution.


The SDK in the developer program are packed with all the documentations to provide references should you become unclear of which coding to use. Manuals are provided to guide you to have easy linking and integration between your software and the FingerTec hardware. Take a look at the frequently asked questions concerning FingerTec BioBridge SDK for more insight in developing your own software.


1.          When I want to run the BioBridge program, I encounter the following error “Class not registered (Exception from HRESULT: 0x80040154 (REGDB_E_CLASSNOTREG))”.
A: This error is due to the missing .dll that is required to run the BioBridge SDK Demo. Please install TCMSV2, Ingress or BioBridge SDK software before you start using the BioBridge SDK Demo.
2.          How can I determine whether the terminal I have includes the black & white or colored screen?
A: You can check your screen type by using the function IsTFTMachine. When the value returned is 0, it means that the terminal you have includes a colored screen. If the value returned is aside from 0, it means that your terminal has the black & white screen.

3.           I’m using a FingerTec colored screen model and having issues in reading the time
              attendance details via the sample code provided.
              A: Please select the appropriate colored screen model function in the BioBridge SDK Demo 
              to read the clocking data/user info. If you want to write your own program, kindly use the
              prefix SSR_ for colored screen terminals.

4.          Can I use the BioBridge SDK with Java?
A: Our BioBridge SDK is packed Active X dll. As Java programming cannot work directly with ActiveX, you will need to use a third party wrapper in order to use Java with our SDKs.

5.          Does the BioBridge SDK supports the programming languages PHP and Oracle Forms?
A: Unfortunately our BioBridge SDK does not support PHP and Oracle formats. Below is the list of sample codes available in our FingerTec Developer Program page.
> C#
> Delphi
> VB

6.          How can I check which terminal the real-time event is from if I have more than 1 device connected?
A: You can use BioBridgeEventSDK.ocx as the reference to determine which terminal the event is from instead of using BioBridgeSDK.ocx.

7.          How can I connect multiple terminals at the same time?
A: Kindly refer to the developer program sample “WPF (Dynamic Declaration & Multiple Terminal)” which is available at

8.          I need a BioBridge SDK for Web applications.
A: Our BioBridge SDK is developed only for Windows platform. If you need to use it for web applications, you can use our FingerTec Webster, obtainable at the link below.

9.          I want to use BioBridge SDK in my programming language, what must I do?
A: To use BioBridge SDK in your programming language, you will need to add the ActiveX component to your development environment

For Windows 64bit Operating System

For Windows 32bit Operating System

10.        I want to upload User Photos and Advertisement Photos to the terminal via BioBridge SDK. How can I go about it?
A: Before you proceed, please ensure that the photos that you want to upload is in JPEG format and the size must be 320px X 210px, less than 30kb. You can use the command
UploadPicture() to upload advertisement and UploadUserPhoto() to upload user photo.

11.       I have both master and slave readers connected. How can I differentiate whether the transaction is from the master reader or the slave reader?
A: In GetGeneralLog(), you must use the value below to differentiate the master’s and slave’s transactions.
InOutMode = 0 (Master Unit)

InOutMode = 1 (Slave Unit)

12.        I have downloaded the transaction log into my USB Flash Disk and noticed that the file is encrypted. How can I decrypt the data?
A: You can use the command DecryptLog(Encrypt: String, Decrypt:String). If the value returned is 0, this means that the log has been successfully decrypted. Other value returned means that it failed to decrypt the file. The content that will be decrypted are:

·         Enroll No
                  ·         Date & Time
                  ·         Device ID
                  ·         InOutMode
                  ·         VerifyMode
                  ·         WorkCode

13.       How can I backup and restore the data in the terminal?
A: To backup data in the BioBridge SDK we need to use the command GetInfo, with SetInfo to restore the data. Basically only user information, fingerprint template and time zone are included in the backup and restore data process.  Do take note that due to security reasons, only transaction logs CANNOT be restored back to the reader.

·      User Info
                          Backup – GetUserInfo()          
                          Restore – SetUserInfo()


·       User Fingerprint Template
                          Backup – GetUserTemplate()
                          Restore – SetUserTemplate()


·      User TimeZone
                          Backup – GetUserTimezone()                      
                          Restore – SetTimezoneInfo()


·       Transaction Logs
                           Backup – ReadGeneralLog()


  1. Can we enroll finger print templates from external devices?

    1. Hi Sir,

      May I know, what you mean by External Devices? Is it Fingertec's Device? Please provide us more details about your problem.

      Appreciate your feedback.

  2. Can we enroll finger print templates from external devices?

  3. How to get the total number of Finger Index?

    1. Hi Vatsal,

      Referring to your query, you can view the total finger index from our SDK BioBridge Demo can be obtained from the link below.
      Other than that, you can register at http://www.fingertec.com/developerprogram/register.php to obtain the Software Development Kit manual and installer.
      Best Regards

  4. how i can download attendance data from fingertech machine using my own develop program. I already using BioBridge, what is the syntax ?

    1. Hi MoelPue,

      Good day. Kindly inform us, which programming language that you are using, to connect your software with BioBridge SDK, so that we may advise you accordingly. You can email us at support@fingertec.com for further assistance. Thank you.

  5. I'm using vb6 to develop program (ac100c). how i can download attendance data ( check-in and check-out) with biobridgesdk ?

  6. Hi,
    Is it possible to unlock doors using an application developed using a website such as ASP.net ?
    Using Biobridge SDK I managed to developed one for windows application but not on a website application. Is there any SDK available for the website development?
    Thank you

    1. Dear Sir.
      Thanks for your interest in FingerTec Products. We are sorry to inform you that, there are no seperate SDk, available for website development for unlocking features. The available web SDK is only used for pulling data from the terminal.

      Best Regards.
      Please do not hesitate t

  7. Hi,
    The c# sample program of BioBridge SDK (V2.1.028) is able to read transaction log and user files ("1_attlog.dat" & "user.dat"; downloaded from TA500), but unhandled exception occurred when reading the "template.fp10.1" file.

    ************** Exception Text **************
    System.AccessViolationException: Attempted to read or write protected memory. This is often an indication that other memory is corrupt.
    at System.RuntimeType.ForwardCallToInvokeMember(String memberName, BindingFlags flags, Object target, Int32[] aWrapperTypes, MessageData& msgData)
    at BioBridgeSDKLib._DBioBridgeSDK.GetTemplateFileData(Int32& EnrollNo, Int32& EnrollId, String& EnrollData)
    at AxBioBridgeSDKLib.AxBioBridgeSDK.GetTemplateFileData(Int32& enrollNo, Int32& enrollId, String& enrollData)
    at WindowsFormsApplication1.Form1.btnGetTemplateUSB_Click(Object sender, EventArgs e) in E:\WorkDir\FingerTec\FingerTec BioBridge SDK\Sample Source Code - C#\Project2\Form1.cs:line 1421
    at System.Windows.Forms.Control.OnClick(EventArgs e)
    at System.Windows.Forms.Button.OnClick(EventArgs e)
    at System.Windows.Forms.Button.OnMouseUp(MouseEventArgs mevent)
    at System.Windows.Forms.Control.WmMouseUp(Message& m, MouseButtons button, Int32 clicks)
    at System.Windows.Forms.Control.WndProc(Message& m)
    at System.Windows.Forms.ButtonBase.WndProc(Message& m)
    at System.Windows.Forms.Button.WndProc(Message& m)
    at System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m)
    at System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m)
    at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)

    The sample app. also gives similar exception when writing the user data using PutUserFileData() & WriteUserFile() commands.

    How to handle/ avoid these exceptions ?

    Thank You.

    1. Hi Mr Lau,

      Good day to you. Referring to your issue, kindly send us your USB files (1_attlog.dat, template.fp10.1 and user.dat) to our email (support@fingertec.com) so that we can check your issue further.

      Thank you.

  8. Hi,

    Can I create a windows service that will listen to the fingerprint terminals (events)? Thanks

  9. Dear Customer,

    Good day. We have checked with our developer, and we have been informed that yes, you can create a Windows Service to get the events from the terminals on realtime basis.

    1. Do you have any tutorial for this? Thank you.

  10. Dear Value Customer,

    Unfortunately, we do not have any tutorial for this. For any reference regarding the FingerTec SDK BioBridge or sample code, you can get it from our development program website at http://www.fingertec.com/developerprogram/index.php. Thanks.

  11. I have donwloaded and install biobridge SDK, but not able to connect to any IPs , local or global.
    Always getting "Unable to Connect to IP Address!!"

    1. Dear Sir,

      Regarding your issue, kindly refer at this article http://www.fingertectips.com/2016/02/understand-how-to-troubleshoot_25.html for more details on how to troubleshoot the TCP/IP connection issue.

  12. My IP address is Up and 2nd point
    "Make sure the IP Address, Subnet mask and the Gateway setting in the FingerTec device tallies with the Local Network.", how can I set these in your sample "Sample Source Code - C#" application, or How Can I run this sample application.

    1. Hi Sir,

      Good day,

      The IP Address, Subnetmask and Gateway are set inside the Device depends on the Local Network settings, so that the SDK can connect to the Device. Make sure the PC that you are using able ping the Device IP Address to check the connection between Device and PC.

      To open the C# demo application, kindly go to FingerTec_BioBridge_SDK\FingerTec BioBridge SDK\Sample Source Code - C#\Project2\bin\Release, then double click Project2.exe

      You may download the latest Fingertec BioBridge SDK on Fingertec Developer website,

  13. I can ping the IP from My local machine, also downloaded and installed the latest version, but still getting the error "Unable to Connect to IP Address!!".
    Same with your demo application, it is showing "Unable to Connect to IP Address!!".
    I am able to ping the IP successfully and it is running.

    1. Hi Sir,

      Good day,

      Regarding your issue, please check the device connectivity by the device info tool. Please make sure that you can establish connection by using the tool and for more details about the device info tool , kindly refer at this link: http://www.fingertectips.com/2014/01/how-to-use-fingertec-device-info-tool.html

  14. Hello,
    How can I properly read general log from device using my c# application?

    I'am using FingerTec TA100C. So far I installed TCMSV3 from disc that comes with device, successfully add users on device, connect and transfer data from device to PC with TCMSV3 application true LAN, monitor logs...
    TCMSV3 works fine but I cannot successfully read general log with C# application.

    Actually for one enroll i recive 4 rows:
    No: 0 Date:0/0/0 Time: 0:0:0 Verify: 0l/O: 0 Work Code: 0
    No: 3408036 Date:1/1/2000 Time: 0:0:0 Verify: 0l/O: 0 Work Code: 0
    No: 0 Date:1/1/2000 Time: 0:0:0 Verify: 0l/O: 0 Work Code: 2167605
    No: 0 Date:1/1/2000 Time: 0:0:0 Verify: 0l/O: 0 Work Code: 0

    As u can see date and time are not correct. On device display time is OK (06.04.2017 ...)
    Numbers 3408036 and 2167605 are not userID, pw or name...
    And every time they are different.

    For this I used application: Sample Source Code - C# / Project2 / BioBridgeSDK_V2.1.028 DEMO
    and FingerTec_BioBridge_SDK_v2.1.045.exe

    Is there something that I missing? Some setup that need to configure on device? ...

    1. i have same issue. can nay one help ?

    2. Hi Sir,

      Good day,

      Please email to us at support@fingertec.com and explain your issue so that we can understand your issue clearly.

      You may download the latest Fingertec BioBridge SDK on Fingertec Developer website,

  15. Hi,
    I use the BioBridge SDK on ASP.net (VS 2010), but it resulted to slow debugging, more often it does not stop loading on the browser like there's an infinite loop of process running in the background.

    And on stopping debugging, it takes around 5 mins before completely stopping as well as the web server. Sometimes, the web server used does not stop properly.

    Would there be a way to solve this? I would appreciate the help.

    Thank you

  16. Hi there,
    I'm getting BioBridgeSDK.ocx failed to register error whenI try to install FingerTec TCMS V3. Any solution to this?

    1. Hello Sir,

      Good day to you.

      Regarding on your problem to install TCMSv3 Software, Kindly send the screenshot to support@fingertec.com

      At the same time, May I know the TCMSv3 installer version? Please right click at setup.exe file and select properties , refer screenshot : http://prntscr.com/g69oi1

  17. Hello,
    I would like to know what's the error when I called this function axBioBridgeSDK1.Connect_TCPIP.
    {"Attempted to read or write protected memory. This is often an indication that other memory is corrupt."}

  18. hi did the sdk work withe fingerprint ikiosk100-E

    1. Hi Eng Mohamed Amer,

      Good day to you.

      With regards to your query, you may use SDK with Fingerprint ikiosk 100-E and check out the sample code inside for available functions to be used with ikiosk 100-E.

      Please revert back should you have other query as I can assist you better.

  19. i will use it at time attendance for employees

  20. I have created a windows service to listen for real time attendance data and insert into a database but after couple of minutes on-finger event stop working so I have to restart the service again and again. what could be the problem please advise in advance

    1. Hello Sir,

      Regarding your query, for the window services that you always need to restart, it is not because of our SDK. Our SDK just a bridge to help the software to communicate between the device. At the same time, we use the time interval to retrieve the data from the device and there is no function that can auto download the data everytime there is a new transaction happen on the device.

      Best regards,
      Tengku Sulaiman

  21. Hello, i would like to know about enabledevice and disabledevice function. When we can use this function. Im already trigger this function then i still can use device.. Can verify..can login to admin mode.

    1. i already tested device TA100 disable device using sample SDK.. its work.. at device appear "working". if i tested device TA100C (color) its don't work..

  22. Hello Wanmad

    Referring to your query, please select the appropriate colored screen model function in the BioBridge SDK Demo to read the clocking data/user info. If you want to write your own program, kindly use the prefix SSR_ for colored screen terminals. Regards.

  23. Do you mean i must use SSR_disabledevice() and SSR_enabledevice()?

  24. Hi Wanmad,

    Referring to your query, you can try to use our SDK demo and run the Enable/Disable function from the Color Screen Demo Function (refer picture http://prntscr.com/k9obth) to test whether this function are work on our BioBridge SDK or not. In the same time, please share with us the BioBridge SDK version that you have use and make sure you have use the latest version (BioBridge SDK 3.0.002). Regards.

  25. I refered to your print screen. Enable disable u highlighted at main menu not color menu... Im using latest sdk. Can u test at device? Im sure its not working on color device but working on black n white device

    1. Hello Wanmad,

      Regarding your query, you want to disable the device so that no one can access or use the device after you disable it? For further discussion, please send the email to support@fingertec.com so that we can assist you accordingly.

      Best regards,
      Tengku Sulaiman

  26. How to create a user with the SDK ?, I am occupying delphi.
    I cannot find the function for this


Have any questions or inquiries about FingerTec? Drop your input here.