Atmel BluSDK ATBTLC1000 User Manual

Atmel BluSDK ATBTLC1000 User Manual

Proximity reporter
Hide thumbs Also See for BluSDK ATBTLC1000:

Advertisement

Quick Links

Introduction
This getting started guide describes the setup of ATBTLC1000 with Atmel
bringing-up an example profile supplied as part of BluSDK. This document explains the bring-up of
Proximity Reporter example application that is embedded as part of the software release package.
The Proximity profile defined by the Bluetooth SIG enables proximity monitoring between two devices.
The Proximity Monitor (a GATT client) configures the behavior of a peer Proximity Reporter device
(GATT server) based on link conditions. The Proximity Monitor configures desired behavior of the peer
device through setting Alerts Levels on Link Loss and Path Loss. In addition, it also maintains the
connection with the Proximity Reporter and monitors the link quality of the connection based on RSSI
reporting from the peer device. The Proximity Reporter implements the Link Loss Service, Immediate
Alert Service and Transmit Power Service. The Proximity Reporter receives the alert level configuration
from the Monitor and adapts behavior and provides notification accordingly.
This document explains the details about:
1. Getting started with the setup of Atmel
2. Demonstration of Proximity Reporter functionality using Atmel SmartBLU mobile application for
Android and iOS included in the BluSDK release package.
The Proximity Reporter application example supports the following features:
Advertisement
Pairing/bonding
Services: Link Loss Service, Immediate Alert Service and TX Power Service
The Proximity Reporter application example supports the following characteristics:
Alert Level
Transmit Power Level
Proximity Reporter – Getting Started Guide
supported platform
with ATBTLC1000 Xplained Pro.
Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016
ATBTLC1000 BluSDK
USER GUIDE
supported platform
and

Advertisement

Table of Contents
loading

Summary of Contents for Atmel BluSDK ATBTLC1000

  • Page 1 1. Getting started with the setup of Atmel supported platform with ATBTLC1000 Xplained Pro. 2. Demonstration of Proximity Reporter functionality using Atmel SmartBLU mobile application for Android and iOS included in the BluSDK release package. The Proximity Reporter application example supports the following features: ...
  • Page 2: Table Of Contents

    Alert on Path Loss (Immediate Alert)....................11 Console Display ......................12 Running the Demo ..................... 12 BluSDK Software Architecture ................. 21 ATMEL EVALUATION BOARD/KIT IMPORTANT NOTICE AND DISCLAIMER ..22 10 Revision History ......................23 Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 3: Demo Setup

    Demo Setup Figure 1-1. Demo Setup of Proximity Reporter Application on ATBTLC1000 Android/iPhone Atmel Smart Connect ATBTLC1000+ Mobile Application Supported Atmel MCU (Proximity Monitor role) (Proximity Reporter Application) BLE L Supported Hardware Platforms and IDEs BluSDK – Supported Hardware and IDEs Table 2-1.
  • Page 4: Hardware Setup

    ATBTLC1000 Xplained Pro Extension Connected to a SAM L21 Xplained Pro SAM D21 Xplained Pro Proximity Reporter Setup Figure 3-2. ATBTLC1000 Xplained Pro Extension Connected to a SAM D21 Xplained Pro Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 5: Sam G55 Xplained Pro Proximity Reporter Setup

    ATBTLC1000 Xplained Pro Extension Connected to a SAM G55 Xplained Pro SAM 4S Xplained Pro Proximity Reporter setup Figure 3-4. ATBTLC1000 Xplained Pro Extension Connected to a SAM 4S Xplained Pro Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 6: Software Setup

    Installation Steps Atmel Studio installation [Atmel Studio 7.0 (build 594) Installer – with .NET] http://www.atmel.com/tools/atmelstudio.aspx. (Note: SAM L21 Rev B/SAM D21/SAM G55/SAM 4S part pack is built-in as part of Atmel Studio 7.0) Atmel USB Driver Installer 7.0.712 http://www.atmel.com/tools/atmelstudio.aspx. Install the standalone ASF package from http://www.atmel.com/tools/AVRSOFTWAREFRAMEWORK.aspx.
  • Page 7: Build Procedure

    Build Procedure The following procedure is explained for SAM L21 application example. The same procedure is valid for the case of other Atmel supported platform as well. 1. Select New Example Project Figure 4-1. Creating a New Project Proximity Reporter – Getting Started Guide USER GUIDE...
  • Page 8 2. Enter “Proximity Reporter” in search window and expand Atmel Corp Projects. The location and the name of the project can be selected in the respective fields. Click OK. Figure 4-2. Selecting Proximity Reporter Application from Example Projects 3. Accept the license Agreement. The studio will generate the Proximity Profile Reporter project for SAM L21.
  • Page 9 Building the Proximity Reporter Application 5. Download the application via the DEBUG USB to the SAM L21 board using Device Programing option available in Tools as shown below. Figure 4-4. Selecting Device Programming Option Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 10 6. Program the device to download the Proximity Reporter application as shown below. Figure 4-5. Flashing the Application on Atmel MCU Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 11: On-Board Led Configuration

    ‘High Alert’ then LED blinking rate is configured for 3-second interval and if it is ‘Mild Alert’ then it is configured for 5-second interval and for ‘No Alert’ the LED is turned off. Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 12: Console Display

    Console Display For the purpose of debugging, logging is made available through a serial console. The logging interface utilizes the same COM port that connects to Atmel supported platform. A serial port monitor application (for example TeraTerm) shall be opened and attached to the appropriate COM port enumerated by the device on the PC.
  • Page 13 On the mobile phone, start the Atmel Smart Connect mobile application provided with the release package. Figure 7-2. Scanning for Proximity Reporter Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 14 The Atmel Proximity reporter device will be discovered and displayed in the scan screen as shown. Figure 7-3. Proximity Reporter Devices Listed in Scan Results Click on the Proximity Reporter device displayed in the scan results and this will initiate the pairing procedure Figure 7-4.
  • Page 15 Click on ‘Pair’. A pop-up requesting the pass-key will appear. Enter the pass-key “123456” and click on OK as shown below. A pop-up will appear indicative successful connection. Figure 7-5. Pass-Key Entry Figure 7-6. Connecting with PXP-Reporter Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 16 On the Proximity Reporter side, the console log will display the successful completion of the pairing procedure. Figure 7-7. Pass-Key Entry Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 17 On the Atmel Smart Connect App, the supported services will be displayed for the Atmel Proximity Reporter Device. Figure 7-8. Display of Services Supported by Proximity Reporter Click on the desired service (Link Loss or Immediate Alert) for configuration of the alert level characteristics.
  • Page 18 Proximity Reporter will display the corresponding alerts and on-board LED behavior will be as specified in Chapter 6.2. Figure 7-10. Proximity Reporter Path-Loss Plot Across Safe, Mid., and Danger Zone Figure 7-11. Proximity Reporter Path-Loss Console-Log Notifying Alerts Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 19 Subsequently the user moving out of range can be trigger to close the lock. Figure 7-12. Link Loss Pop-up on Proximity Monitor Figure 7-13. Proximity Reporter Console Log for Link Loss Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 20 Power Service icon in the services screen. The Proximity Monitor reads the TX Power value from the Proximity reporter and displays it as shown below. Proximity Monitor – Reading TX Power Service Figure 7-14. Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 21: Blusdk Software Architecture

    BluSDK Software Architecture The following diagram illustrates the various layers in the BLE subsystem for the BTLC1000 configuration. The External host can be Atmel supported platform. Figure 8-1. BluSDK Software Architecture Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 22: Atmel Evaluation Board/Kit Important Notice And Disclaimer

    User indemnifies Atmel from any claim arising from user's handling or use of this evaluation board/kit. Except for the limited purpose of internal development and evaluation as specified above, no license, express or implied, by estoppel or otherwise, to any Atmel intellectual property right is granted hereunder.
  • Page 23: Revision History

    Figure 3.4 is updated with SAM4S Xplained Pro Image. Section 4.1 Installation Steps are updated. Figure 3-1 is updated. 42517B 11/2015 The screenshots in Chapter 4 are updated. 42517A 09/2015 Initial document release. Proximity Reporter – Getting Started Guide USER GUIDE Atmel-42517C-ATBTLC1000-BluSDK-Proximity-Reporter-Getting-Started-Guide_USERGUIDE_022016...
  • Page 24 DISCLAIMER: The information in this document is provided in connection with Atmel products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Atmel products. EXCEPT AS SET FORTH IN THE ATMEL TERMS AN D CONDITIONS OF SALES LOCATED ON THE ATMEL WEBSITE, ATMEL ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON -INFRINGEMENT.

Table of Contents