EMDK Java RFID API Software Release Notes

For Version 1.0

Release Notes

Released 22 August 2011

Contents
Introduction.................................................1
Software Download.....................................1
New Features summary..............................2
Major Issues Addressed..............................3
Known Issues..............................................3
Important Notes..........................................3

Introduction
This Release Notes is meant for Motorola customers. The Release Notes lists new features, any specific usage
instructions, and any known issue.
The features and the issues mentioned in this document are applicable for the following products (Unless
mentioned
explicitly in the feature).
FX7400
MC3190-Z

Software Download
MSI file installs the Java RFID API3 class library version 1.0, Programmers guide, API documentation and sample App.
IMAGE TYPE

VERSION

1.0.0.5

Setup Image

FILE NAME

DATE

EMDK-Java-RFID-010000.msi

22-Aug-11

Version Details
Motorola RFID API3
Host JNI DLL

1.0.0.5

\windows\system32\RFIDAPI3_JNI_HOST.dll

22-Aug-11

Motorola RFID API3

PC DLL

5.2.0.7

\windows\system32\RFIDAPI32PC.dll

22-Aug-11

Motorola RFID API3

device JNI DLL

1.0.0.5

\windows\RFIDAPI3_JNI_DEVICE.dll

22-Aug-11

Motorola RFID API3

Device DLL

5.2.0.7

\windows\RFIDAPI32.dll

22-Aug-11

Java API
documentation

NA

<InstallDir>\Motorola EMDK for

Java\RFID\doc\javadoc

22-Aug-11

Programmers Guide

NA

<InstallDir>\Motorola EMDK for

Java\RFID\doc\ProgrammersGuide

22-Aug-11

Page 1 of 6

EMDK Java RFID API Software Release Notes

For Version 1.0
Host based Sample
App

NA

<InstallDir>\Motorola EMDK for

Java\RFID\Samples\netbeans\emdk\J_RFIDH
ostSample1

22-Aug-11

Mobile based Sample

App

NA

<InstallDir>\Motorola EMDK for

Java\RFID\Samples\eclipse\emdk\J_RFIDSam
ple3

22-Aug-11

New Features summary

The following are the features supported in RFID EMDK Java API as part of current release. Please refer the
Programmers guide for more information about the usage of APIs. The complete API reference documentation and
Programmers guide is available on installation.
1. Connection Management (Open/Close connection to the reader)
2. Configuration
a. Antenna
b. RF Mode
c.

Singulation

3. Inventory
a. Simple
b. Trigger Based (Start & Stop)
4. Access (Both Synchronous and Asynchronous)
a. Read
b. Write
c.

Lock

d. Kill
e. Block Erase
f.

Block Perma-Lock

g. Access Sequence
5. Filter
a. Pre-Filter
b. Access Filter
c.

Post Filter

6. RM (Reader Management) APIs

7. NXP Tag support
8. Tag Locationing

Page 2 of 6

EMDK Java RFID API Software Release Notes

For Version 1.0
Major Issues Addressed
None

Known Issues
1) Accept connection is not yet implemented
2) Re-commissioning of tag functions are not tested since no tag supports now
3) Negative parameter validation is not done in the API. Wherever applicable, the user is expected to provide
non-negative values as parameter.
4) During un-installation of Motorola EMDK for Java RFID v1.0, the RFIDAPI32PC.dll in the \windows\system32
folder will not be deleted. This is to work with other EMDK for C or .NET product.
5) Correction to Readme, section Usage Notes->Supported API Versions:

Supported API Versions - RFID EMDK for Java is validated with the following DLL
and firmware versions.
1. RFID API3 DLL version 5.2.0.7
2. Reader Software Version: FX7400 - 2.1.0 and MC3190Z - 1.2.08

Important Notes

This release is for FX Series, XR Series Fixed Reader and MC Series Handheld Readers which are enabled
with LLRP.

For MC Series RFID Reader, the API is tested with NSIcom CrE-ME v4.12 JVM only
The sample app is available for PC runs on Windows XP OS (32bit) and for Windows Mobile 6.1

Prerequisites

Handheld Reader (MC3190Z) & Fixed Readers (FX7400) enabled with LLRP

Host

Java: JDK 1.3 or above (J2SE)

OS: Windows XP

Dependency: RFIDAPI32PC.dll (RFID API3 C native Library)

Device
o

JVM : NSICom CrE-ME v4.12

Installation Notes

Host (Desk top PC runs on XP OS)

o

Run EMDK-Java-RFID-010000.msi

Page 3 of 6

EMDK Java RFID API Software Release Notes

For Version 1.0

Device (MC series Reader)

o

Ensure that NSIcom CrE-ME v4.12 JVM is installed on the device

Copy EMDKJavaRFID.CAB file located in the \Program Files\Motorola EMDK for Java\RFID\cab
onto the devices \temp. This can be accomplished by using the ActiveSync as described below.

Connect the device through ActiveSync

Copy the EMDKJavaRFID.CAB into \temp

Run the EMDKJavaRFID.CAB from device \temp folder

To verify and run the sample App, Run the shortcut file J_RFIDSample3_C located in \Program
Files\Samples.Java\CrE-ME

Usage Notes

Host in this documentation refers the application runs on the desk top PC (XP) which consumes
Symbol.RFID.API3.jar file and internally uses RFIDAPI32PC.dll (native C API3 library) via
RFIDAPI3_JNI_HOST dll

Device in this documentation refers the application runs on the device (MC3190Z) which consumes
Symbol.RFID.API3.jar and internally uses RFIDAPI32.dll (native C API3 library) via RFIDAPI3_JNI_DEVICE dll

Please refer the Programmers guide for details on the API calling sequence.

Sample Application
J_RFIDHostSample1
The host based sample application runs on the Desk top PC to connect Motorola RFID Reader (MC series/FX/XR)
based on the IP/Host Name. This app demonstrates the complete functionality using Java RFID API3 class library
(Symbol.RFID.API3.jar)
Access the Reader Connect dialog from Reader->Connection Menu

To connect FX/XR Reader, provide the respective IP address and port number (default: 5084).

To connect MC Series Reader, provide the IP address as 169.254.2.1 and port number (default: 5084).

Page 4 of 6

EMDK Java RFID API Software Release Notes

For Version 1.0

This app helps to demonstrate the following functions of RFID Reader:

Gets the Reader capabilities

Reader configuration

Operation (Inventory & Access Operation Read, write, lock, kill, block erase and block write)

Filters (Pre-Filter, Post Filter and Access Filter)

Triggers (Start and Stop Condition)

Reader management functions

J_RFIDSample3
The device sample App which runs on the MC3190Z (Windows Mobile OS 6.1). This app demonstrates the
complete functionality using Java RFID API3 class library (Symbol.RFID.API3.jar). This sample app jar file is
available in the device on installation. To run this App, just run the shortcut file \Program Files\Samples.Java\CrEME\ J_RFIDSample3_C
When you launch this Application, the connection to the reader will be established automatically at local port
127.0.0.1,.
The screen shot of the application is given below:

Page 5 of 6

EMDK Java RFID API Software Release Notes

For Version 1.0

Page 6 of 6