BioMini is the USB fingerprint reader used for biometric enrollment. 

BioMini agent / USB Agent needs to be installed in the client PC in order to recognize the device in BioStar 2. 

You can download the program from Setting > USB Agent of BioStar 2 web client

Terminology 

Up to BioStar 2.3, the program was called Biomini Agent because only biomini was used with the program. 

However in BioStar 2.4 the program's name changed to USB Agent because it now supports DE-620 as well. 

Configuration

Note: Although you have a option to check 'run on Windows startup', the USB Agent will not run automatically (up to BioStar 2.5) because of a bug. 

You will have to run USB Agent manually in the Windows start menu when you restart your PC.

[This feature does not work up to BioStar 2.5] 

1. Install the latest driver

First check that the latest fingerprint driver is installed (version 2.2)

Direct download link: Sup_Fingerprint_Driver 

Note: unplug the BioMini when you are installing the driver.

The driver can also be found at our homepage https://www.easysecure.nl/en/support/biostar/software/

2. Check Device manager

Open device manager and check that Suprema Fingerprint Scanner is detected properly. 

3. Check USB Agent Certification

USB Agent is running. You can search it in the Windows start menu. 

Once the program is running right click on the USB Agent icon on the system tray and click Setup.

Click Enroll Certificates and click Yes when a Security Warning popup appears to enroll the certificate. 

Restart the service by clicking Stop and then Start 

4. Check the BioStar 2 Device menu

If  all settings are configured properly, the device should appear as a USB device on the Device menu. 

Troubleshooting

1. Check if the USB Agent port is being used by another service 

(In BioStar 2.5 you cannot change the default port use of the USB Device Agent of 8081 and 8082 because of a UI bug. Please upgrade your BioStar)

Check that port 8081 and 8082 is not being used by another service.  

If another service is using port 8081 and 8082 then service will crash or 'Started' will be not shown when you click Start.
Remove the other service that is using the same ports. 

2. Change Access privileges
If you're getting the error below every time when scanning the fingerprint with Biomini, it is likely that USB Agent is being run with insufficient privileges.

In that case stop the process first in Task Manager.

In BioStar 2.3 or below the service will appear as Biomini-Agent.exe *32

In BioStar 2.4 and above the service will appear as usb-agent.exe *32

Search the Biomini Agent / USB Agent in Windows Start menu and select the Properties menu after a right click. 

Check Run this program and an administrator on the compatibility tab and click OK

Run Biomini Agent / USB Agent again. 

3. Check the API

If you are using a proxy server, you will have to add the localhost as an exception.

You can check if the localhost is working correctly by trying to access the URL below:

localhost:[webserver port]/api/device

The image above shows that the connection is possible and working.

If you get a error message like below even if BioStar 2 service is running, it means that localhost connection is blocked. 

4. Check the USB Agent logs

You can find the USB agent logs in the folder below: 

C:\Program Files (x86)\USB Device Agent\usb-agent\logs

Open the log files to see what errors are appearing. 

Provide the log file to the technical support team when requested.