BlueMod+Sx iBeacon Application Note · BlueMod+Sx iBeacon Application Note . 80507NT11748A Rev. 0 Page . 7. of . 31 . 2019-04-03. 1. INTRODUCTION . 1.1. Scope . This document describes

[04.

2016

]

Mod. 0809 2016-08 Rev.7

BlueMod+Sx iBeacon Application Note

80507NT11748A Rev. 0 – 2019-04-03


80507NT11748A Rev. 0 Page 2 of 31 2019-04-03

SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE

NOTICE

While reasonable efforts have been made to assure the accuracy of this document, Telit assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be reliable. However, no responsibility is assumed for inaccuracies or omissions. Telit reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Telit does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others. It is possible that this publication may contain references to, or information about Telit products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Telit intends to announce such Telit products, programming, or services in your country.

COPYRIGHTS

This instruction manual and the Telit products described in this instruction manual may be, include or describe copyrighted Telit material, such as computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and its licensors certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any copyrighted material of Telit and its licensors contained herein or in the Telit products described in this instruction manual may not be copied, reproduced, distributed, merged or modified in any manner without the express written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit, as arises by operation of law in the sale of a product.

COMPUTER SOFTWARE COPYRIGHTS

The Telit and 3rd Party supplied Software (SW) products described in this instruction manual may include copyrighted Telit and other 3rd Party supplied computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted computer programs, including the exclusive right to copy or reproduce in any form the copyrighted computer program. Accordingly, any copyrighted Telit or other 3rd Party supplied SW computer programs contained in the Telit products described in this instruction manual may not be copied (reverse engineered) or reproduced in any manner without the express written permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit or other 3rd Party supplied SW, except for the normal non-exclusive, royalty free license to use that arises by operation of law in the sale of a product.


80507NT11748A Rev. 0 Page 3 of 31 2019-04-03

USAGE AND DISCLOSURE RESTRICTIONS

I. License Agreements

The software described in this document is the property of Telit and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement.

II. Copyrighted Materials

Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, without prior written permission of Telit

III. High Risk Materials

Components, units, or third-party products used in the product described herein are NOT fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment in the following hazardous environments requiring fail-safe controls: the operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities.

IV. Trademarks

TELIT and the Stylized T Logo are registered in Trademark Office. All other product or service names are the property of their respective owners.

V. Third Party Rights

The software may include Third Party Right software. In this case you agree to comply with all terms and conditions imposed on you in respect of such separate software. In addition to Third Party Terms, the disclaimer of warranty and limitation of liability provisions in this License shall apply to the Third Party Right software. TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED FROM ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM WHICH THE SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND THE USE OF ANY OR ALL THE OTHER CODE IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY OR FITNESS FOR A PARTICULAR PURPOSE. NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODE OR THE EXERCISE OF ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS APPLICABLE TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


80507NT11748A Rev. 0 Page 4 of 31 2019-04-03

APPLICABILITY TABLE

PRODUCTS

BLUEMOD+S BLUEMOD+S42 BLUEMOD+S42M BLUEMOD+S50


80507NT11748A Rev. 0 Page 5 of 31 2019-04-03

CONTENTS

NOTICE….. ....................................................................................................... 2

COPYRIGHTS .................................................................................................. 2

COMPUTER SOFTWARE COPYRIGHTS ....................................................... 2

USAGE AND DISCLOSURE RESTRICTIONS ................................................ 3

APPLICABILITY TABLE .................................................................................. 4

CONTENTS ...................................................................................................... 5

1. INTRODUCTION ............................................................................ 7

2. GENERAL .................................................................................... 10

3. SOFTWARE CONFIGURATION .................................................. 11 Basic Configuration Commands ................................................... 11 Advanced Configuration Commands ............................................ 12

4. VERIFYING BEACON FUNCTIONALITY .................................... 13 Using Application on an Android Devices..................................... 13

4.1.1. Prerequisites ................................................................................ 13 4.1.2. Procedure ..................................................................................... 13

Using Application on an iOS Devices ........................................... 19 4.2.1. Prerequisites ................................................................................ 19 4.2.2. Procedure ..................................................................................... 19

5. USING APPLE ID ........................................................................ 28 Get the iBeacon Specification ...................................................... 28

6. LINKS AND TRADEMARKS ....................................................... 29

7. DOCUMENT HISTORY ................................................................ 30


80507NT11748A Rev. 0 Page 6 of 31 2019-04-03

FIGURE LIST

Figure 1: List of AT Commands ............................................................................................... 13 Figure 2: Locate Beacon App-Home Screen ........................................................................... 14 Figure 3: List of Available Beacons .......................................................................................... 15 Figure 4: iBeacon Identified ..................................................................................................... 16 Figure 5: Distance to Beacon (Android) ................................................................................... 17 Figure 6: Beacon Calibration (Android) .................................................................................... 18 Figure 7: List of AT Commands ............................................................................................... 19 Figure 8: Scan List ................................................................................................................... 20 Figure 9: Add New UUID ......................................................................................................... 21 Figure 10: Add New iBeacon ................................................................................................... 22 Figure 11: Add Beacon Info ..................................................................................................... 23 Figure 12: iBeacon Detected in Scan List ................................................................................ 24 Figure 13: iBeacon Parameter Details ..................................................................................... 25 Figure 14: Distance to Beacon (iOS) ....................................................................................... 26 Figure 15: Beacon Calibration (iOS) ........................................................................................ 27


80507NT11748A Rev. 0 Page 7 of 31 2019-04-03

1. INTRODUCTION 1.1. Scope This document describes how to configure and use the Telit BlueMod+Sx modules as an iBeacon compatible device.

The description text “BlueMod+Sx” in this document refers to all modules listed in

the Applicability Table unless otherwise noted.

1.2. Audience This document is intended for Telit customers, especially system integrators, about to implement Bluetooth modules in their application.

1.3. Contact Information, Support For general contact, technical support services, technical questions and report documentation errors contact Telit Technical Support at:

• [email protected]

Alternatively, use:

http://www.telit.com/support

For detailed information about where you can buy the Telit modules or for recommendations on

accessories and components visit:

http://www.telit.com

Our aim is to make this guide as helpful as possible. Keep us informed of your comments and

suggestions for improvements.

Telit appreciates feedback from the users of our information.

mailto:[email protected]

http://www.telit.com/support

http://www.telit.com/


80507NT11748A Rev. 0 Page 8 of 31 2019-04-03

1.4. Text Conventions

Danger – This information MUST be followed or catastrophic equipment failure or

bodily injury may occur.

Caution or Warning – Alerts the user to important points about integrating the

module, if these points are not followed, the module and end user equipment may

fail or malfunction.

Tip or Information – Provides advice and suggestions that may be useful when

integrating the module.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD.


80507NT11748A Rev. 0 Page 9 of 31 2019-04-03

1.5. Related Documents

• BlueMod+S AT Command Reference, 80507AT10751A • BlueMod+S42/Central AT Command Reference, 80512ST10771A • BlueMod+S42M AT Command Reference, 80527ST10839A • BlueMod+S50/Central AT Command Reference, 80578ST10890A • BlueMod+S User Guide, 1VV0301277 • BlueMod+S42/Central Software User Guide, 1VV0301318 • BlueMod+S42M Software User Guide, 1VV0301391 • BlueMod+S50/Central Software User Guide, 1VV0301506


80507NT11748A Rev. 0 Page 10 of 31 2019-04-03

2. GENERAL A Bluetooth Beacon is essentially a device that broadcasts a unique ID to let potential beacon enabled smartphones know it is there. This is a one-way communication originating in the beacon, so the beacon itself does not know anything about the remote device. iBeacon is a special technology licensed by Apple. It requires the acceptance of the iBeacon license agreement to get the specification and making products based on that specification. The functionality for seeing these beacons is implemented in iOS 7 or later operating system level, but to act on a visible beacon you will require an app that knows the beacon ID and includes all additional functionality. Android devices requires a custom app (and service) to just see the Beacon. The BlueMod+Sx modules can be used for developing beacons that are compatible with iBeacon technology and also for developing custom beacons. The beacon functionality can be verified with any freely available Beacon applications. This document provides a step-by-step instructions on how to use the Radius Network “Locate Beacon” App for configuring the beacon device on an Android/iOS platforms.

As the beacon and the Telit Terminal I/O technology make use of the

manufacturer specific Advertising Data-type, they cannot be used simultaneously.

A BlueMod+Sx module configured as a beacon following this application note will

not provide Terminal I/O functionality.


80507NT11748A Rev. 0 Page 11 of 31 2019-04-03

3. SOFTWARE CONFIGURATION This chapter provides a list of AT Commands which are used for configuring the BlueMod+Sx module in beacon mode.

Basic Configuration Commands 1. Reset the module to factory default.

AT&F1

2. Switch the internal Terminal I/O implementation OFF. AT+LETIO=0

3. Setup the advertisement interval (for example 760ms). The advertisement interval has direct influence on the power consumption of your beacon. AT+LEADINTMIN=760

AT+LEADINTMAX=760

4. Next, configure the advertisement data. AT+LEADDATA=0201061aff4c0002150112233445566778899AABBCCDDEEFF000010002c5

Fixed data fields:

• Bluetooth Low Energy flags:“020106” • Length of the manufacturer data:“1A” • Manufacturer data AD-type:“FF” • Company identifier from Bluetooth SIG:“4C00”(Apple ID, see chapter 5.Using Apple ID) The UUID consists of 32 hexadecimal digits split as follows: Variable data fields which could be modified to meet your use case:

• The 128-bit UUID: “01122334-4556-6778-899A-ABBCCDDEEFF0” First section : 8 bits (01122334) Second section: 4 bits (4556) Third section: 4 bits (6778) Fourth section: 4 bits (899A) Fifth section: 12 bits (ABBCCDDEEFF0)

Note: The character shown above can be numbers range(0-9), and letters (A to F)

• Major value:“0001” • Minor value:“0002” • Measured power used for distance detection:“c5” (RSSI in 1-meter distance)

5. Set the advertising mode to scannable. AT+LEADPAR=advtype=2

6. Enable customized advertising. AT+LEADE=1

7. Save the configuration. AT&W

8. Reset the module to make the saved configuration active. AT+RESET


80507NT11748A Rev. 0 Page 12 of 31 2019-04-03

Make sure that you receive an OK response string from the BlueMod+Sx module

after issuing each command and each string added to the advertising command

is as per the iBeacon Specifications.

The BlueMod+Sx module is now active as a Beacon which is compatible with the Locate Beacon App.

Advanced Configuration Commands For the serial interface, use UICP mode to save maximum power. AT+UICP=1

Please refer to BlueMod+S User Guide for more information on UICP.


80507NT11748A Rev. 0 Page 13 of 31 2019-04-03

4. VERIFYING BEACON FUNCTIONALITY This section describes the procedure to test and verify the BLE beacon features and its specification for both Android and iOS platforms using Radius Network “Locate Beacon” Application.

Using Application on an Android Devices

4.1.1. Prerequisites

• Download and install the “Locate Beacon” App for Android platform from Google Play Store.

• When installing the App, make sure that you allow the app to use location services to detect Beacons and enable Bluetooth on your mobile device.

4.1.2. Procedure 1. Put the BLE device into iBeacon mode by issuing the below set of AT Commands.

Figure 1: List of AT Commands

https://play.google.com/store/apps/details?id=com.radiusnetworks.locate&hl=en


80507NT11748A Rev. 0 Page 14 of 31 2019-04-03

2. Launch the Locate Beacon App on your mobile device. The Home Screen will be displayed as shown below.

Figure 2: Locate Beacon App-Home Screen


80507NT11748A Rev. 0 Page 15 of 31 2019-04-03

3. Tap Locate Beacon to view a list of beacons available near you.

Figure 3: List of Available Beacons


80507NT11748A Rev. 0 Page 16 of 31 2019-04-03

4. Once ibeacon appears in the list. Tap on it to associate with the device. The following details of the device will be displayed:

• Device UUID • Major/Minor values (set as per iBeacon specifications) • Proximity type and distance (immediate, near or far) • RSSI value • Tx Power

Figure 4: iBeacon Identified


80507NT11748A Rev. 0 Page 17 of 31 2019-04-03

a. Tap Distance to Beacon to view the distance.

Figure 5: Distance to Beacon (Android)


80507NT11748A Rev. 0 Page 18 of 31 2019-04-03

b. Tap Calibrate Beacon to perform the beacon calibration.

Figure 6: Beacon Calibration (Android)


80507NT11748A Rev. 0 Page 19 of 31 2019-04-03

Using Application on an iOS Devices

4.2.1. Prerequisites

• Download and install the Locate Beacon App for iOS devices from App Store. • When installing the App, make sure that you allow the app to use location services to

detect Beacons and enable Bluetooth on your mobile device.

4.2.2. Procedure 1. Put the BLE device into iBeacon mode by issuing the below set of AT Commands.

Figure 7: List of AT Commands

https://play.google.com/store/apps/details?id=com.radiusnetworks.locate&hl=en


80507NT11748A Rev. 0 Page 20 of 31 2019-04-03

2. Launch the Locate Beacon App on your iOS device. The Scan screen will be displayed as shown below. Swipe down from the top of the empty beacon list to detect the iBeacon.

Figure 8: Scan List


80507NT11748A Rev. 0 Page 21 of 31 2019-04-03

3. If iBeacon does not appear in the list, tap on Settings icon and select Add new UUID to add an iBeacon to the Locate Beacon App using specific UUID, major and minor values provided at the time of advertising command.

Figure 9: Add New UUID


80507NT11748A Rev. 0 Page 22 of 31 2019-04-03

4. Tap icon to add a new iBeacon.

Figure 10: Add New iBeacon


80507NT11748A Rev. 0 Page 23 of 31 2019-04-03

5. Enter Beacon Info such as Beacon Name, UUID, Major, Minor and Power values provided while issuing AT+LEADDATA command as shown in Step 1 and click Save.

Figure 11: Add Beacon Info


80507NT11748A Rev. 0 Page 24 of 31 2019-04-03

6. Once successfully saved, the device appears on the Scan List with the beacon name as provided in Step 5.

Figure 12: iBeacon Detected in Scan List


80507NT11748A Rev. 0 Page 25 of 31 2019-04-03

7. Tap on the iBeacon device as listed to associate with it. The following details of the device will be displayed:

• Device Name • Device UUID • Major/Minor values (set as per iBeacon specifications) • RSSI value • Accuracy value • Proximity type (immediate, near or far)

Figure 13: iBeacon Parameter Details


80507NT11748A Rev. 0 Page 26 of 31 2019-04-03

a. Tap Distance to view the distance.

Figure 14: Distance to Beacon (iOS)


80507NT11748A Rev. 0 Page 27 of 31 2019-04-03

b. Tap Calibrate to perform beacon calibration.

Figure 15: Beacon Calibration (iOS)


80507NT11748A Rev. 0 Page 28 of 31 2019-04-03

5. USING APPLE ID In iOS 8, Apple has changed its policy regarding the iBeacons. It now supports only beacons having manufacturing ID set to Apple ID (0x004C) in advertising packet. Beacons having manufacturing ID set to other vendor IDs will not be recognized by the Core Location API in iOS 8. Therefore, iOS app nRF Beacon will not work with these beacon devices if their manufacturing ID is not set to Apple ID in advertising packet.

Get the iBeacon Specification You may download the resources for developing or manufacturing iBeacon products that integrate iBeacon technology using the Proximity Beacon Specification R1 from https://developer.apple.com/ibeacon/. The acceptance of the iBeacon license agreement is required. Please visit the Apple developer site for iBeacon for more information.

https://developer.apple.com/ibeacon/


80507NT11748A Rev. 0 Page 29 of 31 2019-04-03

6. LINKS AND TRADEMARKS For more information to iBeacon technology see: https://developer.apple.com/ibeacon/ https://developer.apple.com/ibeacon/Getting-Started-with-iBeacon.pdf iBeacon is a trademark of Apple Inc.

https://developer.apple.com/ibeacon/

https://developer.apple.com/ibeacon/Getting-Started-with-iBeacon.pdf


80507NT11748A Rev. 0 Page 30 of 31 2019-04-03

7. DOCUMENT HISTORY

Revision Date Changes

0 2019-04-03 First issue This document replaces the AN_S1401 Using BlueMod+S as Beacon Doc # 80507NT11471A.

[04.

2016

]

Mod. 0809 2016-08 Rev.7