Biomini is the USB fingerprint reader used for biometric enrollment.
Supported devices in BioStar 2 are shown in the link below:
[Both BioStar] Biomini and Biomini Plus support
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_v2.2.0.exe
http://gofile.me/471Oh/5xHcJBB5N
Note: unplug the Biomini when you are installing the driver.
The driver can also be found at the EasySecure website under software -> BioStar
t.
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
You currently (BioStar 2.5) cannot change the default port use of the USB Device Agent of 8081 and 8082 because of a UI bug.
Check that port 8081 and 8082 is not being used by another service.
Refer to the guide below:
[General] Checking Port Usage in Windows
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.
Or you can change the Biomini Agent port in BioStar 2.6 as desired and above as shown below:
[BioStar 2] Changing Biomini / USB Agent Port
If you must change the USB Agent port in BioStar 2.5 or below refer to the guide below:
[Known Issue] Biomini Agent / USB Agent Port Cannot be Changed
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.