Lantronix FOX3-3G-BLE Application Note Download Page 8

How to Use BLE with the FOX3-3G-BLE Device 

 

1.4.3

 

Powering up the FOX3

-

3G

-

BLE

 

with the help of either CA70 or CA69

 

After  the  device  has  been  successfully  configured,  apply  power  to  the  device  using  either  cable 
CA70 or CA31. To apply power to the device, plug in the 8pin connector of one of these cables to 
the 8pin connector of the FOX3

-

3G

-

BLE device. Finally, connect the power pins (wires at the end of 

the  used  cable 

-

  IN+,  GND 

-

  refer  to  the  package  insert  of  the  device)  of  the  used  cable  to  an 

external power source ranging from +12 to +32 VDC (e.g. 12 VDC in your vehicle). 

 

1.4.4

 

Testing the BLE modes of the FOX3

-

3G

-

BLE device

 

This section describes how to test the configuration examples given in tables in the sections below. 
After loading the configuration examples  in the sections below into the FOX3

-

3G

-

BLE device and 

applying  power,  the  device  is  ready  for  testing  its  BLE  modes.  For  more  details  about  PFAL 
commands related to the BLE, refer to section below 

1.4.4.1.

 

1.4.4.1

 

PFAL commands implemented for BLE in the AVL firmware 3.0.x and 3.1.x 

The  table  below  gives  you  the  list  of  PFAL  commands/events/dynamic  entries  which  are 
implemented in AVL firmware 3.x.x, related to use with the BLE functionality.

 

Configuration Parameter Settings 

Description 

CNF.Set,DEVICE.BLE.STARTUP=<on|off> 

Sets up the configuration of the BLE module in FOX3-3G-BLE devices.  

Please do not set it “off”.

 

CNF.Set,Ble.AdvName=<Advertized_friendl
y_name> 

Defines the BLE device name. Default =  FOX3-3G-AVL  

e.g. $PFAL,CNF.Set,Ble.AdvName=FOX3-BLE 

BLE.WHITELIST=<None|Public|Name|MAC

Sets the whitelist mode after scanning iBeacons. 

  None

:  Disables checking the attributes of iBeacon sensors to be inserted into 

  the whitelist 

 

Public: 

Lists only iBeacon sensors advertising their name(s), after scan.  

Name:

  Lists  all 

iBeacon  sensors  that  advertise  and  don’t  advertise  their 

names,  after  scan.  iBeacon  Sensors  that  do  not  advertise  their  names  are 

shown as “unnamed”. 

 

MAC:

  Lists only iBeacon sensors advertising their MAC, after scan.

 

BLE.SCANDURATION=<ScanDuration> 

This configuration command defines  how long the  FOX3-3G-BLE is searching for 
discoverable iBeacon devices. <ScanDuration> ranges from 5 to 60 seconds. 

Events Syntax 

Description  

SYS.BLE.eConnected 

Occurs when the connection to a host is established (e.g. tablet or smart-phone) 

SYS.BLE.eDisconnected      

Occurs when the connection to a host is lost (e.g. App on the tablet) 

SYS.BLE.eRegister="<BLE-
BeaconID/Name>" 

Occurs when a BLE beacon is inside the range of the FOX3-3G-BLE. 

SYS.BLE.eRegister=whitelist 

Occurs when the incoming ID or name matches one of the entries available in the 
Whitelist. Entries in the Whitelist can be set with 

$PFAL,Sys.Whitelist.Set

 

SYS.BLE.eRelease="<BLE-
BeaconID/Name>" 

Occurs  when  an  already  registered  BLE  beacon  is  out  of  range  of  the  FOX3-3G-
BLE. 

SYS.eBleData="<userTxt>" 

Occurs when the device receives a user text from the connected host (e.g. tablet 
or smart-phone) 

SYS.BLE.sConnected 

True,  as  long  as  the  BLE  connection  state  of  the  FOX3-3G-BLE  (slave)  to  a  BLE 
master (Smartphone/Tablet/PC) has changed from disconnected to connected. 

Summary of Contents for FOX3-3G-BLE

Page 1: ...Application Note How to Use BLE with the FOX3 3G BLE Device Part Number APP 0012 Revision A October 2019 ...

Page 2: ...Sales Offices For a current list of our domestic and international sales offices go to the Lantronix web site 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 specifically disclaims all warranties of any kind express implied or otherwise regar...

Page 3: ...y 2019 1 0 3 Document throughout updated Added sections 1 2 and 1 3 and 1 4 1 to 1 4 4 Added new commands events dynamic variables see table in section 1 5 Extended section 1 7 June 2018 1 0 4 Added new dynamic entries for the released iBeacons see table in section 1 5 Added new configuration parameter BLE SCANDURATION ScanDuration see table in section 1 5 October 2019 A Initial Lantronix document...

Page 4: ...e to your PC 6 1 4 2 Installing the Workbench software and loading the configuration into the device 7 1 4 3 Powering up the FOX3 3G BLE with the help of either CA70 or CA69 8 1 4 4 Testing the BLE modes of the FOX3 3G BLE device 8 1 4 4 1 PFAL commands implemented for BLE in the AVL firmware 3 0 x and 3 1 x 8 1 4 4 2 Setup your FOX 3G BLE device as a slave to send specific data to a master server...

Page 5: ...n sent out from other BLE iBeacons peripherals slaves collects their data and sends this information over TCP to a remote server This mode can be used for example for IoT solutions in transportation and logistics to connect iBeacon sensors attached to objects and identify them on a remote platform server The combination of FOX3 3G BLE and iBeacons allows fleet operators to build solution that can ...

Page 6: ...s 4 Workbench software to load the configuration into the FOX3 device 5 Power source from 12 to 32 VDC e g 12 VDC in your vehicle 1 4 Hardware setup This chapter explains how to connect and get started with FOX3 3G BLE Follow this four step process to get started with BLE 1 Connect FOX3 3G BLE device to your PC with the help of Control box or USB cable 2 Install the Workbench software and load the...

Page 7: ...fter completing the installation double click on Workbench exe to start it Open a new COM Port from the Toolbar 1 on the COM Port view 2 choose the port where FOX3 2G 3G 4G is connected go to Device Manager Ports USB Serial Port COMxx where xx is the COM port to use define the port settings 115200 bps 8 Data bits No Parity bit 1 Stop bit None Flow control and finally click the connect play icon 2 ...

Page 8: ...Defines the BLE device name Default FOX3 3G AVL e g PFAL CNF Set Ble AdvName FOX3 BLE BLE WHITELIST None Public Name MAC Sets the whitelist mode after scanning iBeacons None Disables checking the attributes of iBeacon sensors to be inserted into the whitelist Public Lists only iBeacon sensors advertising their name s after scan Name Lists all iBeacon sensors that advertise and don t advertise thei...

Page 9: ...e BLE RSSI Used to report the RSSI value in dbm from last registered BLE device BLE Released Used to report the name of last released BLE device BLE List Used to report the devices found at last scan BLE List2 Reports list of beacon MACs which were successfully scanned BLE MAC Reports the MAC address of the registered iBeacon BLE UUID Reports the universally unique identifier UUID of the registere...

Page 10: ...equest 1 Turn on the FOX3 3G BLE and configure it with such alarm configuration lines PFAL CNF Set AL1 SYS BLE eConnected Sys Timer0 start cyclic 5000 AL1 starts a cyclic timer with a timeout of 5000 ms once the device is connected to the BLE server tablet PFAL CNF Set AL2 Sys Timer e0 Msg Send Ble 8 Name Devicename IMEI IMEI Date Date Time Time AL2 sends the name IMEI date and time of the device ...

Page 11: ...nal Demo starts up you will see this window see Figure below Figure 3 Main user interface after starting the BLE Terminal Demo 6 Click on the scan symbol to start scanning the BLE devices near the tablet 7 The App should find FOX3 3G AVL Please note that the maximum length for the FOX3 3G BLE advertised name is 10 characters 8 Click on the name FOX3 3G AVL see Figure below ...

Page 12: ...rface on the BLE Spp Demo 10 Click on the connect disconnect symbol to establish the BLE connection 11 Once the BLE connection between the FOX3 3G BLE and the tablet is established the FOX3 3G BLE generates the event SYS BLE eConnected and starts sending its data periodically every 5 seconds see Figure below Figure 6 The tablet receives data from the FOX3 3G BLE ...

Page 13: ...e BLE beacons detections you can automate the BLE scan procedure by using the action command Sys Ble Scan in PFAL alarm lines iBeacons can be used in application such as container identification trailer identification pallet tracking and more iBeacons are attached to your pallets containers trailers and the FOX3 3G BLE devices are wired permanently onto trucks Figure 8 IoT solutions when using FOX...

Page 14: ... server Data transferred to the server BLE REGISTER MAC 7C 2F 80 AA 63 82 UUID 80010215123480AA638CBBC5 MAJOR 1 MINOR 10 51 GPRMC 083157 000 A 5040 4185 N 01058 8433 E 2 42 169 88 250618 00 BLE REGISTER MAC 7A 2F 80 A0 63 00 UUID 4C000102030405060708090A0B0C0D0E0F10 MAJOR 10 MINOR 267 65 GPRMC 083157 000 A 5040 4185 N 01058 8433 E 2 42 169 88 250618 00 PFAL Cnf set AL4 Sys Ble eRelease TCP Client ...

Page 15: ...egrated NFC chipset for programming You must change their format from ID temp into iBeacon The id and temp formats are currently not supported in the FOX3 3G BLE Operating temperature 40 C to 85 C 2 mounting 4mm holes Ø57mm H 18mm W 36g RoHS compliant ...

Reviews: