Scribd
Upload
136 views8 pages

Miaxis Fingerprint Getting Startded Guide

The document provides instructions for getting started with the Miaxis Fingerprint SDK. It includes [1] SDK contents which contain libraries and demo code, [2] development guide for configuring a new Android project and adding SDK files, [3] sample code for using the driver and fingerprint matching APIs, and [4] tips for capturing high quality fingerprints. The support contact information is also listed at the end.

Uploaded by

scribd
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
136 views8 pages

Miaxis Fingerprint Getting Startded Guide

The document provides instructions for getting started with the Miaxis Fingerprint SDK. It includes [1] SDK contents which contain libraries and demo code, [2] development guide for configuring a new Android project and adding SDK files, [3] sample code for using the driver and fingerprint matching APIs, and [4] tips for capturing high quality fingerprints. The support contact information is also listed at the end.

Uploaded by

scribd
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 8

MIAXIS - 2023-05-08

Miaxis Fingerprint Getting Startded Guide


Miaxis Fingerprint Getting Startded Guide
1.Introduction
2.SDK Contents
3.Development Guide
3.1 Configure your project
3.1.1 Create a new Android project
3.1.2 Enable Java 8
3.1.3 Add aar file
3.1.4 Congratulations
3.2 Sample Code
3.2.1 SM-9X Driver API
3.2.2 Justouch Api
3.3 How to get high-quality fingerprints
3.4 Development reference
3.4.1 Host (USB/SPI communication)
3.4.1 Host (Serial communication)
3.4.1 Module
4. Support Contact Information:

1.Introduction
Welcome to use SM-9X SDK. This document will introduce how to use SM-9X SDK for development in
Android.

2.SDK Contents
The SDK contains libraries and demo needed for the development of SM-92M-S,Contains the following
directories:

/apk or /bin

The apk or bin folder contains the compiled binary files, which can be installed directly on the
Android device.

/demo

The demo folder is the source code corresponding to the apk file, which can be opened using Android
Studio .

NOTE:

The library (.so & .jar & .aar) file is included in the demo and is not provided separately.

3.Development Guide No. 1 / 8


MIAXIS - 2023-05-08

3.Development Guide
3.1 Configure your project
This lesson shows you how to create a new Android project using Android Studio and introduces some of
the files in the project.

To create a new Android project, follow these steps:

3.1.1 Create a new Android project

Create a new Empty Activity application project,You can refer to Android Developer to create an Android
project.

3.1.2 Enable Java 8

The SDK needs to work with JDK 1.8, open build.gradle, add a configuration inside, as shown in the figure:

3.1.3 Add aar file

First, switch to the project view. Click on Android and select Project .As shown below:

No. 2 / 8
MIAXIS - 2023-05-08

Then, copy the aar from the demo project to the lib directory of your project, as shown below:

NOTE:

JustouchApi.aar is used for fingerprint algorithm.

SM92M-SDriverApi.aar is used to access SM-92M-S Device.

No. 3 / 8
MIAXIS - 2023-05-08

3.1.4 Congratulations

Congratulations, you have completed all the preparations, then you can refer to the Sample Code to learn
how to use our API.

3.2 Sample Code


3.2.1 SM-9X Driver API

Get a instance of SM-9X driver API :

SM92MSVcApi mDriverApi = FingerApiFactory.getInstance(getApplicationContext(),


FingerApiFactory.USB);
// do something with mDriverApi

Open/Close SM-92M-S device :

int fd = mDriverApi.openDevice();
if (fd >= 0) {
// Open successfully !
// 0 means it has been opened before
} else {
// process error code
}

Capture fingerprint image from SM-92X device:

CaptureConfig captureConfig = new CaptureConfig.Builder()


.setLfdLevel(0)
.setLatentLevel(0)
.setTimeout(8000)
.setAreaScore(45)
.setPreviewCallBack(previewCallBack)
// AES/ECB/PKCS5Padding
//.setAESConfig(new
AESConfig.Builder().setKey("1234567890123456").build())
//.setAESStatus(CaptureConfig.AES_HOST)
.build();
MxResult<MxImage> image = mDriverApi.getImage(captureConfig);
if (imageResult.isSuccess()) {
// Capture successfully !
MxImage mxImage = imageResult.data;
// Convert raw image to Android bitmap
byte[] imageDate = new byte[mxImage.width * mxImage.height + 1078];
BmpLoader.Raw2Bmp(imageDate, mxImage.data, mxImage.width, mxImage.height);
Bitmap bitmap = BitmapFactory.decodeByteArray(imageDate, 0, imageDate.length);
//show bitmap
ImageView imageView ;//The imageView to show fingerprint image

No. 4 / 8
MIAXIS - 2023-05-08

imageView.setImageBitmap(bitmap);
} else {
//process error code
}

See the SM-9X API Manual.pdf for more driver apis.

3.2.2 Justouch Api

Create a instance of Jutouch Api :

JustouchFingerAPI mJustouchApi = new JustouchFingerAPI();

Create FMR :

MxImage image ; // capture from SM-92M-S


byte[] fmrBuffer = new byte[1024];//Must be 1024 bytes
int result = mJustouchApi.createTemplateISO(image.data, image.width, image.height,
fmrBuffer);
if (result >= 0) {
// successfully
}
// If you use ISO2011, please call the following function :
// mJustouchApi.createTemplateISO2011(...)
// If you use ANSI, please call the following function :
// mJustouchApi.createTemplateANSI(...)

Match two FMR :

byte[] fmrBufferA //Must be 1024 bytes


byte[] fmrBufferB //Must be 1024 bytes
int similarScore = mJustouchApi.compareTemplatesANSI(fmrBufferA, fmrBufferB);
if (score >= 45) { // Suggest 45 pass
// Match passed
} else if (score >= 0) {
// Match not passed
} else {
// Process error code
}

NOTE:

When Justouch works with SM-9X, there is no need to call initialization

See the Justouch Fingerprint Verification SDK.pdf for more Justouch apis.

No. 5 / 8
MIAXIS - 2023-05-08

3.3 How to get high-quality fingerprints

The finger type is not


Fingerprint
conducive to obtaining How to get high-quality fingerprints
collected
high quality fingerprint

Need to remove the excessive moisture from your


Wet finger
fingers and keep the sensor clean.

Use hand cream, wet wipes, blowing on his stiff


Dry finger
fingers to moisturize.

Fingers have obvious


Use other fine fingers.
scars

Finger peeling Use other fine fingers.

Should apply moderate but steady pressure, and


Like the image
Not enough pressure stay 1 second, about the same, pressure as pressing
of dry fingers
a button.

Like the image


Should be relaxed and reduce the stress, apply
of wet fingers
Too much pressure moderate but steady pressure, and stay 1 second,
or torsion
about the same, pressure as pressing a button.
distortion

No. 6 / 8
MIAXIS - 2023-05-08

3.4 Development reference


Fingerprint template data is stored in your database.

3.4.1 Host (USB/SPI communication)

3.4.1 Host (Serial communication)

3.4.1 Module

The fingerprint template data is stored in the fingerprint module.

No. 7 / 8
MIAXIS - 2023-05-08

4. Support Contact Information:


MIAXIS BIOMETRICS CO., LTD

Official website:

www.miaxis.net , www.miaxis.com

Tel. :
+86 571 8195 1610

Fax:
+86 571 8195 1600

E-mail :

[email protected]

No. 8 / 8

You might also like