FAQs - FingerTec BioBridge SDK

Thursday, August 20, 2015 FingerTec 22 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()

22 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

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