Application Note
FOX3 and FOX3-3G Device Integration withAgoraBee Reader

Part Number APP-0022
Revision A October 2019

Intellectual Property© 2019 Lantronix, Inc. All rights reserved. No part of the contents of this publication may
be transmitted or reproduced in any form or by any means without the written permissionof Lantronix.
Lantronix is a registered trademark of Lantronix, Inc. in the United States and othercountries.
Patented: www.lantronix.com/legal/patents/; additional patents pending.
All trademarks and trade names are the property of their respective holders.

ContactsLantronix, Inc.
7535 Irvine Center Drive, Suite 100
Irvine, CA 92618, USA
Toll Free: 800-526-8766
Phone:
949-453-3990
Fax:
949-453-3995
Technical Support
Online: www.lantronix.com/support
Sales Offices
For a current list of our domestic and international sales offices, go to the Lantronix website at www.lantronix.com/about/contact

Disclaimer
All information contained herein is provided “AS IS.” Lantronix undertakes no obligation to
update the information in this publication. Lantronix does not make, and specificallydisclaims, all warranties of any kind (express, implied or otherwise) regarding title, noninfringement, fitness, quality, accuracy, completeness, usefulness, suitability orperformance of the information provided herein. Lantronix shall have no liability
whatsoever to any user for any damages, losses and causes of action (whether in contract
or in tort or otherwise) in connection with the user’s access or usage of any of theinformation or content contained herein. The information and specifications contained inthis document are subject to change without notice.

FOX3 and FOX3-3G Device Integration with AgoraBee Reader2Revision History
DateRev.

CommentsJuly 20151.0.0

Initial version.

July 2015

1.0.1

Added some configuration examples when using the EVENTS
Mode - See chapter 1.6

July 2015

1.0.2

Updated chapters 1.2 and 1.6.

July 2015

1.0.3

A note added to figure 2 - See Figure 2
A new point added in typical application (Construction equipmentactivity) - See chapter 1.3

October 2019

A

Initial Lantronix document. Added Lantronix document partnumber, logo, contact information, and links.

For the latest revision of this product document, please check our online documentation atwww.lantronix.com/support/documentation.

FOX3 and FOX3-3G Device Integration with AgoraBee Reader

3Table of Contents

1 ABOUT THIS DOCUMENT
1.1 Contact Information
1.2 Introduction
1.3 Typical applications
1.4 Installing AgoraBee reader to FOX3/-3G
1.5 Testing RFID reader and active tags operation
1.6 FOX3/-3G device configuration
1.7 Additional documentation

FOX3 and FOX3-3G Device Integration with AgoraBee Reader

555666784

1 ABOUT THIS DOCUMENT
The aim of this application note is to describe, evaluate and integrate the AgoraBee reader to the FOX3/3G device in order to improve transportation, distribution, asset tracking and management as well as
logistics businesses.

1.1

Contact Information

Location NameContacts

Lantronix support

Web :https://www.lantronix.com/support

AgoraBee support

Web :E-mail :http://www.agorabee.com/Site2015/#products
support@agorabee.com

1.2

Introduction

Radio Frequency Identification (RFID), is a method of communicating using radio waves. Radio waves
can communicate between active RFID tags, attached to objects for tracking purpose and automatic
identification, and an RFID reader without requiring line-of-sight visibility. Active RFID tags can be read
remotely over a range of distance up to 100 meters or more allowing to keep track of valuable assets,monitor their movement and locate them quickly. This allows a highly defined reading area when tags
go in and out of the interrogation zone and thereby a great flexibility in applications such as asset
protection and supervision.
The mobile controlled RFID system consists of a FOX3/-3G, web server, active reader and tags.
Tags

Assets, goods and other objects to be tracked are fitted with active RFID tags. Active tags have transmittersand use batteries to send back their information to the reader. Such tags can contain sensors to monitor
conditions such as temperature, humidity and other product-related information.

Reader

The AgoraBee reader is connected via serial interface to the FOX3/-3G device. The encoded radio signals sentfrom the tags are received by the reader which filters them and generates relevant events in addition tomaintaining an updated inventory. The events are pushed as they occur through the serial interface to theFOX3/-3G; while in order to get the inventory, the FOX3/-3G needs to poll with a specific command on theserial port.

FOX3/-3G

The FOX3/-3G needs to be configured to react to data received on that serial port and to forward this data tothe central tracking server via TCP or to a mobile phone via SMS.

Web Server

The client server/phone receives automatically information from the FOX3/-3G device to know when one tag
or more arrive in or leave from the reader operating area.

Figure 1:

Typical application example using FOX3/-3G with active RFID reader and tags

FOX3 and FOX3-3G Device Integration with AgoraBee Reader

51.3◼
◼
◼
◼
◼
◼
◼

1.4

Typical applications
Inventory Management
Skip and Roll-off Container Tracking
Construction equipment activity
Pallet and Construction Tool Tracking
Remote Monitoring
Asset Management
Car Tracking in Rental

Installing AgoraBee reader to FOX3/-3G

To install the AgoraBee reader to the FOX3/-3G use either CA31 which connects to 8pin main port orCA69 to 6pin accessory port on the FOX3/-3G. Both cables have a 4pin connector consisting of an RS232 interface (RX, XT) and power (+IN, GND) pins. At the end of both cables there are also the powersupply lines that need to be connected to an external power source ranging from +12 VDC to +32 VDC(e.g. 12VDC).

Figure 2:

1.5

Use one of the cables to interface the AgoraBee reader to FOX3/-3G

Testing RFID reader and active tags operation

After connecting the AgoraBee reader to one of the serial ports of the FOX3/-3G, use the following
steps to perform the test:✓ Read the corresponding manual of the RFID reader you are using✓ Check the operating voltage of the RFID Reader✓ Connect the RFID reader to the FOX3/-3G device as mentioned in the figure 2 above.
✓ Distribute all active tags within the reader operating area
✓ Install and start the Lantronix Workbench software✓ Start testing the system. To test this system locally, use the device configuration in chapter below andreplace
TCP.Client.Send,8,"&(IMEI),&(SerialData0)"
inAL3
with
MSG.Send.Serial1,8,"&(IMEI),&(SerialData0)". In this way, the received data from thereader on the Serial Port 0 is forwarded to the Serial Port 1, instead of to your remote server via TCP

FOX3 and FOX3-3G Device Integration with AgoraBee Reader61.6FOX3/-3G device configuration

The AgoraBee reader supports different operation modes. This chapter will show only some configuration examples
how to forward the data from the AgoraBee reader to your server when using either EVENTS mode or FALCOM
mode. The main difference between these two modes is: in the EVENTS mode, the reader sends the data
immediately when the tag is seen or tag state is changed and in the FALCOM mode, the reader sends the data only
on request. For more details about the PFAL commands used below, refer to the chapter 1.7.

FOX3/-3G Serial Port Configuration (already tested by Lantronix)
To integrate the AgoraBee reader to the FOX3/-3G, the following configuration should be stored into the FOX3/-3G.
$PFAL,Cnf.Set,DEVICE.SERIAL0.BAUDRATE=9600$PFAL,MSG.Mode.Serial0=60,C// AgoraBee reader operates at 9600 bps// Allows to send requests to the AgoraBee reader

The AgoraBee reader is assumed to be connected to the Serial Port 0 (8-pin main port of FOX3/-3G). If you want to connect
the reader to the Serial Port 1 (6-pin accessory port of FOX3/-3G), just change the number 0 (marked in red) to 1 in bothconfiguration lines above. Hint: This configuration can be sent to the FOX3/-3G either remotely via TCP or locally throughserial port.

FOX3/-3G Alarm Configuration with Reader in EVENTS mode (already tested by Lantronix)
In the EVENTS mode the AgoraBee reader sends the events to the serial port as they occur. To activate the EVENTS mode,use the following command:$PFAL,MSG.SEND.RawSerial0,0,"&(bin=0x02)084545014D&(bin=0x03)"

The message structure is described in the table below (contact AgoraBee for more details). Parsing of this data should be
implemented on the server side.
Data Mode(3 bytes)

Message Type(3 bytes)

Message Length(3 bytes)

Event Class(3 bytes)

Device UID(12 bytes)

001002032

015

101200000190

Device Data
RFR
Device Event Checksum End message(6 bytes)(3 bytes)(3 bytes)(3 bytes)(2 bytes)
001192

010

060

220

<CR><LF>

EXAMPLE 1: Start a 2 minute timer on SYS.Device.eStart event (AL1). Reset the AgoraBee reader inventory onSys.Timer.e event (AL2). This causes the reader to generate new events (in zone and other type of events) which areforwarded (together with the FOX3/-3G' IMEI and RMC protocol) to the server on SYS.eSerialData event during the carignition (IO.s8=high) is on (AL3). To test these alarms, store them first into the FOX3/-3G and finally start the timer byperforming a device reset with $PFAL,Sys.Device.Reset.
$PFAL,CNF.Set,AL1=SYS.Device.eStart:Sys.Timer0.Start=cyclic,120000$PFAL,CNF.Set,AL2=Sys.Timer.e0&IO.s8=high:MSG.SEND.RawSerial0,0,"&(bin=0x02)06524900&(bin=0x03)"$PFAL,CNF.Set,AL3=SYS.eSerialData0="001002":TCP.Client.Send,8,"&(IMEI),&(SerialData0)"

AL2 = Reset the AgoraBee reader inventory is made as long as the car ignition (IO.s8=high) is on. The IGN pin (pin 3) on
the FOX3/-3G should be connected to the car ignition, so that it shows 12V when the vehicle is on and 0V when is off. Incase the IGN pin (pin 3) is not used, then remove (IO.s8=high) from the AL2.
The FOX3/-3G device will transmit the following data to your server, for example:
Default format: DEVICE.PFAL.SEND.FORMAT="$",CKSUM,"","$<end>"

Customized format: DEVICE.PFAL.SEND.FORMAT="",NOCKSUM,"",""$353816054967940,00100203201510120000017600113300606
0041*23<CR><LF>$GPRMC,080707.000,A,5040.4081,N,01058.8545,E,0.01,0.
00,140715,,*00<CR><LF>$<end><CR><LF>

353816054967940,001002032015101200000176001133006
060041<CR><LF>$GPRMC,080707.000,A,5040.4081,N,01058.8545,E,0.01,0.00,140715,,<CR><LF>

EXAMPLE 2: Reset the AgoraBee reader inventory on TCP.Client.eReceived event (AL1). This causes the reader togenerate new events (in zone and other type of events) which are forwarded (together with the FOX3/-3G' IMEI and RMCprotocol) to the server on SYS.eSerialData event (AL2). To test these alarms, store them first into the FOX3/-3G and thensend "INV_TCP" from your server to the FOX3/-3G device.
$PFAL,CNF.Set,AL2=TCP.Client.eReceived="INV_TCP":MSG.SEND.RawSerial0,0,"&(bin=0x02)06524900&(bin=0x03)"$PFAL,CNF.Set,AL3=SYS.eSerialData0="001002":TCP.Client.Send,8,"&(IMEI),&(SerialData0)"

FOX3 and FOX3-3G Device Integration with AgoraBee Reader

7

FOX3/-3G Alarm Configuration with Reader in FALCOM mode (already tested)
In the FALCOM mode the AgoraBee reader is in polling mode. To get the inventory send the following command"<STX>0C494E56414C4C<ETX>".
To activate the FALCOM mode, use the following command:$PFAL,MSG.SEND.RawSerial0,0,"&(bin=0x02)08454D0146&(bin=0x03)"

The reader response starts with the header "INV_ALL," followed by the ID of the reader (e.g. 230090002231) and thenthe ID of the tags with their associated data as shown in the example below. Parsing of this data should be implemented on
the server side.
INV_ALL,230090002231,003001004235000000001032,010050016167000000005032,101200000176001155001040,120000001025000000005184,151000001005000000000052,001,EOI232<CR><LF>

EXAMPLE 1: Start a 2 minute timer on SYS.Device.eStart event (AL1). Request for data from the reader on Sys.Timer.eevent (AL2) and forward this data (together with the FOX3/-3G' IMEI and RMC protocol) to the server on SYS.eSerialData
event during the car ignition (IO.s8=high) is on (AL3). To test these alarms, store them first into the FOX3/-3G and finallyperform a device reset with $PFAL,Sys.Device.Reset.
$PFAL,CNF.Set,AL1=SYS.Device.eStart:Sys.Timer0.Start=cyclic,120000$PFAL,CNF.Set,AL2=Sys.Timer.e0&IO.s8=high:MSG.SEND.RawSerial0,0,"&(bin=0x02)0C494E56414C4C&(bin=0x03)"$PFAL,CNF.Set,AL3=SYS.eSerialData0="INV_ALL,":TCP.Client.Send,8,"&(IMEI),&(SerialData0)"

AL2 = The request for data from the reader is made as long as the car ignition ( IO.s8=high) is on. The IGN pin (pin 3) on
the FOX3/-3G should be connected to the car ignition, so that it shows 12V when the vehicle is on and 0V when is off.
The FOX3/-3G device will transmit the following data to your server, for example:
Default format: DEVICE.PFAL.SEND.FORMAT="$",CKSUM,"","$<end>"

Customized format: DEVICE.PFAL.SEND.FORMAT="",NOCKSUM,"",""$353816054967940,INV_ALL,230090002231,0030010042350
00000000032,010050016167000000005032,10120000017600
1155000040,120000001025000000006184,151000001005000
000001052,001,EOI232*1D<CR><LF>$GPRMC,122315.000,A,5040.4091,N,01058.8558,E,0.03,0.00,020715,,*06<CR><LF>$<end><CR><LF>

353816054967940,INV_ALL,230090002231,0030010042
35000000001032,010050016167000000006032,1012000
00176001155001040,120000001025000000006184,1510
00001005000000001052,001,EOI229<CR><LF>
GPRMC,122315.000,A,5040.4091,N,01058.8558,E,0.0
3,0.00,020715,,<CR><LF>

EXAMPLE 2: Request for data from the reader on TCP.Client.eReceived event (AL1) and forward this data (together withthe FOX3/-3G' IMEI and RMC protocol) to the server on SYS.eSerialData event (AL2). To test these alarms, store themfirst into the FOX3/-3G and then send "INV_TCP" from your server to the FOX3/-3G device.
$PFAL,CNF.Set,AL2=TCP.Client.eReceived="INV_TCP":MSG.SEND.RawSerial0,0,"&(bin=0x02)0C494E56414C4C&(bin=0x03)"$PFAL,CNF.Set,AL3=SYS.eSerialData0="INV_ALL,":TCP.Client.Send,8,"&(IMEI),&(SerialData0)"

1.7

Additional documentation
If this application note does not cover all the information you need to setup, refer to the additional
documents listed below, which can be found on the Product Index or Application Notes pages.

Filename
AVL_PFAL_Configuration_Command_Set.pdf
FOX3_HardwareManual.pdf
AppNotes_AVL_Installation_Guide.pdf

Description
Lists and describes all PFAL commands supported by the Lantronix AVL
devices.
Contains instructions for safety, operation and maintenance of theFOX3/-3G device.
Provides all the necessary information about installing products
properly and safely.

If you are going to use the Lantronix passive RFID reader, refer to the application note listed below.
FilenameDescription

AVL_AppNote_RFID_Howto.pdf

Describes the integration of the Lantronix passive RFID reader with an
Lantronix AVL device (FOX3/-3G, STEPPIII-UX, BOLERO-LT2).

FOX3 and FOX3-3G Device Integration with AgoraBee Reader

8