FAQs - FingerTec BioBridge SDK

Thursday, August 20, 2015 TimeTec 54 Comments

Introduction

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.

Benefits

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.

FAQ

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
> VB.NET

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
http://www.fingertec.com/developerprogram/biobridge_samplecode.php.


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.
http://www.fingertec.com/developerprogram/webster_download.php


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
C:\Windows\SysWOW64\BioBridgeSDK.ocx

For Windows 32bit Operating System
C:\Windows\System32\BioBridgeSDK.ocx


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()

54 comments:

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

    ReplyDelete
    Replies
    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.

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

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

    ReplyDelete
    Replies
    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.
      http://www.fingertec.com/developerprogram/biobridge_download.php
      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

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

    ReplyDelete
    Replies
    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.

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

    ReplyDelete
  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

    ReplyDelete
    Replies
    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

      Delete
  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.

    ReplyDelete
    Replies
    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.

      Delete
  8. Hi,

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

    ReplyDelete
  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.

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

      Delete
  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.

    ReplyDelete
  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!!"

    ReplyDelete
    Replies
    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.

      Delete
  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.

    ReplyDelete
    Replies
    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,
      http://www.fingertec.com/sdk_download/FingerTec_BioBridge_SDK.zip

      Delete
  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.

    ReplyDelete
    Replies
    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

      Delete
    2. This comment has been removed by the author.

      Delete
    3. In my case it was comm key, device was configured with comm key. So i have to set the same comm key in sdk to connect the device.

      Delete
  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? ...

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

      Delete
    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,
      http://www.fingertec.com/sdk_download/FingerTec_BioBridge_SDK.zip

      Delete
  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

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

    ReplyDelete
    Replies
    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

      Delete
  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."}

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

    ReplyDelete
    Replies
    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.

      Delete
  19. i will use it at time attendance for employees

    ReplyDelete
  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

    ReplyDelete
    Replies
    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

      Delete
  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.

    ReplyDelete
    Replies
    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..

      Delete
  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.

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

    ReplyDelete
  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.

    ReplyDelete
  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

    ReplyDelete
    Replies
    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

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

    ReplyDelete
  27. I'm trying to get log data from TA100C using axBioBridgeSDK1.ReadGeneralLog(ref log) == 0 but it go out the loop and cant retrieve the data. I have try this out in your sample c# code and it gives me the the same result.

    ReplyDelete
    Replies
    1. axBioBridgeSDK1.ReadGeneralLog(ref log) == 0 returns -1 which is fail do I have to do any configurations in the device. I have connected AC100 and it returns me the data.

      Delete
    2. Dear Sir / Ma'am,

      Good day to you,

      Please be informed that ReadGeneralLog() is only applicable for black & white models. For TA100C, you need to use SSR_GetGeneralLog(). You may refer to the link below regarding BioBridge Function List.

      https://www.fingertec.com/developerprogram/biobridge/FunctionList_acta.html

      Please send email to support@fingertec.com should you require further clarification on above issue as our team can assist you further.

      Thanks & Best Regards,
      Nursyafawani Kasram binti Mohd Hisham

      Delete
    3. the usage of SSR_GetGeneralLog() is to read the log which i'm using right now but if(axBioBridgeSDK1.ReadGeneralLog(ref log) == 0) returns -1 which equals to fail. please help me

      Delete
  28. Me Also, i use TA200 Plus POE , the axBioBridgeSDK1.SSR_GetGeneralLog() or axBioBridgeSDK1.GetGeneralLog() function to get all logs are not working for me. Please Help me.

    ReplyDelete
  29. Can we copy all user info from one fingertech device to another new fingertech device? please advice

    ReplyDelete
    Replies
    1. Dear Sir / Madam,

      Good day to you,

      May we know which device model and software version that you're using? If you're using TCMSv3 or Ingress, you may download all the users from the first device and upload to the other device

      Delete
    2. Dear Sir,

      I am using TA100C, I want to download all user info from 1 device (that already done), then save to my database(already done), then from database upload all user to another TA100C device, I had function from BioBridge is setuserinfo but that required enroll no.

      Thanks in advanced

      Delete
    3. Hello Sir,

      If you are using the BioBridge SDK demo yes you are required to enter the enroll no of the user as this is for demo purposes. If you want to upload all the user you may create and use our BeginBatchUpdate() & BatchUpdate() function method on your system to upload all the user. Kindly refer to the following link for all the function method available in BioBridge SDK.

      https://www.fingertec.com/developerprogram/biobridge/pdf/SDK-BioBridge.pdf (page 39)

      Delete
  30. Dear Support,

    Is there any sample using Webster SDK with asp.net .. Thanks

    ReplyDelete

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