FX SERIES
Embedded SDK
Programmer’s Guide
MN000540A01 Rev. A
Table of Contents
About This Guide
Introduction ............................................................................................................................................4
Chapter Descriptions............................................................................................................................. 4
Notational Conventions .........................................................................................................................5
Related Documents and Software ........................................................................................................5
Service Information ...............................................................................................................................6
Installing CodeSourcery Lite
Introduction ..................................................................................................................................... 7
Starting the Embedded SDK .......................................................................................................... 7
Setting Up a Remote Connection for Remote Debugging .......................................................... 8
Installing Zebra FX Series Embedded SDK
Introduction ................................................................................................................................... 12
Creating an Embedded Java Project ........................................................................................... 12
Adding Source File to Embedded Java Project ......................................................................... 14
Importing RFID3 API Java Library to Embedded Java Project ................................................. 16
Building Java Executable Class File(s) ...................................................................................... 18
Setting Up the Java Remote Build Path ...................................................................................... 20
Setting Up Java Remote Debug Configuration .......................................................................... 24
Debuggin the Embedded Java Application ................................................................................ 26
Creating Java JAR-Archive Executable ...................................................................................... 30
Creating Start and Stop Scripts for the Java Installation Package .......................................... 34
Embedded C Application
Introduction ................................................................................................................................... 35
Creating an Embedded C Project ................................................................................................ 35
Adding Source File to Embedded C Project ............................................................................... 37
Reviewing and Changing Default Build Settings of Embedded C Project .............................. 38
Building C Executable File ........................................................................................................... 41
Setting Up C Remote Debug Configuration ............................................................................... 43
Debugging Embedded C Application .......................................................................................... 47
Creating Start and Stop Scripts for C Installation Package ...................................................... 50
2
Table of Contents
Embedded Application Installation Package
Introduction ................................................................................................................................... 51
Creating an FX RFID Reader Embedded Application Installation Package ............................. 51
Creating an FX RFID Reader Embedded Application Installation Package on Linux Host .... 53
3
ABOUT THIS GUIDE
Introduction
The FX Series Embedded SDK Programmer’s Guide describes how to use the FX Series Embedded SDK to
develop, debug, and package embedded applications.
Chapter Descriptions
Topics covered in this guide are as follows:
• Installing CodeSourcery Lite describes how to start the SDK and how to set up a remote
connection for debugging.
• Installing Zebra FX Series Embedded SDK describes how to create, build, and debug an embedded
Java application, and how to create Start and Stop script files for the deployment packages used to
install the application onto the FX RFID Readers.
• Embedded C Application describes how to create, build, and debug an embedded C application,
and how to create the Start and Stop script files for the deployment packages used to install the
application on the FX RFID Readers..
• Embedded Application Installation Package describes how to create an FXSeries embedded
application installation package, and includes instructions on installing a package on a Linux
OS-based host system.
4
Notational Conventions
The following conventions are used in this document:
• FX Series refers to the FX7500 and FX9600 RFID readers.
• Italics are used to highlight the following:
• Chapters and sections in this and related documents
• Bold text is used to highlight the following:
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
• Icons on a screen
• Key names on a keypad
• Button names on a screen
• Bullets (•) indicate:
• Action items
• Lists of alternatives
• Lists of required steps that are not necessarily sequential.
• Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.
About This Guide
Related Documents and Software
The following documents provide more information about the reader.
• FX Series RFID Reader Integrator Guide, p/n MN000026Axx
• FX7500 RFID Reader Quick Start Guide, p/n MN000070A01
• FX7500 RFID Reader Regulatory Information, p/n MN000027Axx
• FX9600 RFID Reader Quick Start Guide, p/n MN-003087-xx
• FX Series Reader Software Interface Control Guide, p/n 72E-131718-xx
• RFID Demo Applications User Guide, p/n 72E-160038-xx
• FX Series Embedded SDK Installation Guide, p/n MN000537Axx
• FX SeriesEmbedded SDK Sample Applications User Guide, p/n MN000539Axx
• Application Guide for Zebra Enterprise Mobility Devices, p/n 72E-68902-xx
• RFID 3 API
• EPCglobal Low Level Reader Protocol (LLRP) Standard
For the latest version of these guides and software, visit: www.zebra.com/support.
5
Service Information
If you have a problem with your equipment, contact Zebra Global Customer Support for your region.
Contact information is available at: www.zebra.com/support
When contacting support, please have the following information available:
• Serial number of the unit
• Model number or product name
• Software type and version number.
Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.
If your problem cannot be solved by Zebra Customer Support, you may need to return your equipment for
servicing and will be given specific directions. Zebra is not responsible for any damages incurred during
shipment if the approved shipping container is not used. Shipping the units improperly can possibly void
the warranty.
If you purchased your Zebra business product from a Zebra business partner, contact that business
partner for support.
About This Guide
.
6
Installing CodeSourcery
Lite
Introduction
This chapter describes how to start the SDK and how to set up a remote connection for debugging.
Starting the Embedded SDK
To start the SDK:
1. Click on the Zebra FXRFID Reader Embedded SDK shortcut.
2. In the Workspace field, enter the folder for project settings and project file storage.
Figure 1 Workspace Window
3. Close the Welcome window if it appears.
NOTE:The following instructions show Microsoft Windows 7 screens. The FX Series Embedded SDK also
supports the Microsoft Windows XP operating system. This procedure was not tested on Microsoft
Windows 8. The installation was reported as working on Microsoft Windows 8, but is currently not
officially supported.
7
Installing CodeSourcery Lite
Setting Up a Remote Connection for Remote Debugging
The following instructions describe how to set up a remote connection to a device in order to run a debug
session of the embedded application (C or Java), or access a terminal session on the device to execute
Linux commands, shell scripts, and/or applications.
1. Select the Remote System Explorer perspective in one of two ways:
• Select Window > Open Perspective > Other > Remote System Explorer.
Figure 2 Selecting Remote System Explorer
• Select the Remote System Explorer button if available.
Figure 3 Remote System Explorer Button
2. Right-click Local in the Remote Systems view and select New > Connection.
8
Installing CodeSourcery Lite
Figure 4 Selecting Local
3. Select Linux in the New Connection / Select Remote System Type window and select Next.
Figure 5 Selecting Linux
4. In the New Connection / Remote Linux Connection window enter the Host name (IP address or network
name of the device) and the Connection name (identifier, such as FX7500 or FX9600) and select Next.
Figure 6 Entering Host and Connection Names
NOTE:De-select Verify host name if the device is not accessible during setup.
9
Installing CodeSourcery Lite
5. In the New Connection / Files window select ssh.files in the Configuration section and select Next.
Selecting ssh.files
6. In the New Connection / Processes window select processes.shell.linux in the Configuration section
and select Next.
Figure 7 Selecting processes.shell.linux
7. In the New Connection / Shells window select ssh.shells in the Configuration section and select Next.
Figure 8 Selecting ssh.shells
8. In the New Connection / Ssh Terminals window ensure ssh.terminals is selected, and select Finish.
Figure 9 Ssh Terminals Window
10
Installing CodeSourcery Lite
The new entry appears in the Remote System view.
Figure 10 Remote System View
To connect to the device, right-click on the remote connection and select Connect.
Figure 11 Selecting Connect
If Enter Password window appears:
• In the User ID field Enter rfidadm.
• Leave the Password (optional) field blank.
• Select Save user ID and Save Password.
• Select OK.
Figure 12 Enter Password Window
NOTE:Select Yes or OK for any warning messages regarding authentication and missing folders for SSH
handling.
11
Installing Zebra FX Series
Embedded SDK
Introduction
This chapter describes how to create, build, and debug an embedded Java application, and how to create
Start and Stop script files for the deployment packages used to install the application onto the FX Series
RFID Readers.
Creating an Embedded Java Project
1. If default perspective is not Java, open the Java Perspective in one of two ways:
• Select the Java perspective symbol in the top right corner.
Figure 13 Selecting Java Perspective
• Select Window > Open Perspective > Other > Java Perspective.
2. Select File > New > Java Project.
Figure 14 Selecting Java Project
3. In the New Java Project / Create a Java Project window, enter the Project name and select Next.
12
Installing Zebra FX Series Embedded SDK
Figure 15 Entering Project Name
4. In the New Java Project / Java Settings window, select Finish. The new project appears in the Package
Explorer section.
Figure 16 New Project Entry
13
Installing Zebra FX Series Embedded SDK
Adding Source File to Embedded Java Project
1. In the Package Explorer view, expand the project entry, right-click on src, and select New > Class.
Figure 17 Selecting Class
2. In the New Java Class / Java Class window, enter the Package and Name and select Finish.
Figure 18 Java Class Window
14
Installing Zebra FX Series Embedded SDK
The source file appears in the window
Figure 19 Java Source File
3. Add the required application-specific RFID3 API commands.
15
Installing Zebra FX Series Embedded SDK
Importing RFID3 API Java Library to Embedded Java Project
1. In the Package Explorer view, right-click on the project entry and select Properties.
Figure 20 Selecting Properties
2. In the Properties for … window, select Java Build Path.
Figure 21 Properties for... Window
3. Select the Libraries tab and select Add External JARs … .
16
Installing Zebra FX Series Embedded SDK
4. In Jar Selection window, browse in the folder RFID_JAVA_API of the SDK installation, and select
Symbol.RFID.API3.jar.
Figure 22 Jar Selection Window
5. Select Open.
6. Select OK in the Java Build Path window to complete the import.
Figure 23 Java Build Path Window
The Symbol.RFID.API3.jar class library appears in the Referenced Libraries section of the project entry in
Package Explorer view.
17
Loading...