Microchip Technology ATBTLC1000 Xplained Pro Guide d'installation

ATBTLC1000

Bluetooth® Low Energy Custom Service Implementation

Introduction

This document demonstrates how to use the ATBTLC1000 Bluetooth® Low Energy SoC by building a

custom specific profile using the Microchip BluSDK. This document includes the following topics:

• Technical overview of the ATBTLC1000 board from hardware architecture to software design

• Description of the required process for developing the Bluetooth Low Energy peripheral application

with the ATBTLC1000

• Handling of Bluetooth Low Energy custom services and characteristics

Note: The custom service implementation procedure uses the ATBTLC1000ZR-XSTK kit. This

procedure is also applicable for other supported platforms, as mentioned in BluSDK Release Notes.

Figure 1. Bluetooth Low Energy System Solution with ATBTLC1000

Table of Contents

Introduction......................................................................................................................1

1. Getting Started.......................................................................................................... 4

1.1. Software Prerequisites ................................................................................................................ 4

1.2. Software Setup.............................................................................................................................4

1.3. ATBTLC1000 Embedded Firmware............................................................................................. 5

1.4. ATBTLC1000 Host Software API................................................................................................. 5

1.5. Hardware Prerequisites................................................................................................................7

1.6. Hardware Setup........................................................................................................................... 9

2. Creating the Project and Initializing ........................................................................ 12

2.1. Creating Project from ASF......................................................................................................... 12

2.2. Configuring ASF for ATBTLC1000-ZR....................................................................................... 15

2.3. Compiling and Testing the Project..............................................................................................16

3. Establishing Connection with Central Device.......................................................... 18

3.1. Configuring and Starting the Advertisement Process.................................................................19

3.2. Managing GAP events............................................................................................................... 25

4. Setting/Handling of Pre-Defined Service ................................................................ 30

4.1. Adding Device Info Service Component from ASF Wizard to Project........................................ 31

4.2. Configuring and Loading Device Information Service................................................................ 33

5. Setting up and Handling Custom Service................................................................37

5.1. Configuring and Loading the Custom Environment Service.......................................................38

5.2. Updating the Temperature Characteristic...................................................................................43

6. Appendix A: Software Solution - Pre-Defined Svc ..................................................47

7. Appendix B: Software Solution - Custom Service................................................... 49

8. Document Revision History..................................................................................... 53

The Microchip Web Site................................................................................................ 54

Customer Change Notification Service..........................................................................54

Customer Support......................................................................................................... 54

Microchip Devices Code Protection Feature................................................................. 54

Legal Notice...................................................................................................................55

Trademarks................................................................................................................... 55

Quality Management System Certified by DNV.............................................................56

ATBTLC1000

Worldwide Sales and Service........................................................................................57

ATBTLC1000

1. Getting Started

This chapter describes the basic software and hardware requirements and setup.

1.1 Software Prerequisites

1.1.1 Installation Steps of Atmel Studio 7

1. Download and install the Atmel Studio software.

2. Install the Advanced Software Framework (ASF) package.

Note: The software for ATBTLC1000-ZR is supported with ASF 3.35.1 and above.

Note: For more information on the previous releases, refer to the Atmel Studio Release Notes available

on the Microchip web page.

1.2 Software Setup

1.2.1 Installation of Microchip SmartConnect application on a Mobile device

1. Open the Apple Store® (iPhone/iOS) or Google Play™ Store (Android) on the mobile device.

2. Search for “Microchip SmartConnect”.

3. Click Install to install application on the device. The Microchip SmartConnect application is now

installed on the mobile device.

Figure 1-1. Microchip SmartConnect Dashboard

ATBTLC1000

Getting Started

1.3 ATBTLC1000 Embedded Firmware

The management of Bluetooth Low Energy communication is based on the network stack stored in

ATBTLC1000 ROM. This stack requires parameters such as GAP parameters and attributes to be

functional, which are pushed from Host controller into ATBTLC1000 internal SRAM, using Generic

Transport Layer (GTL).

The ROM coded firmware embeds the layers of Bluetooth Low Energy stack v4.1 that runs on top of the

internal hardcoded peripheral drivers and RTOS scheduler.

•Generic Access Profile (GAP)

GAP controls the Bluetooth Low Energy connection, advertising, makes the device visible to the

outside world, and determines how two devices interact with each other. GAP defines two main

roles for the Bluetooth Low Energy device, "Central" and "Peripheral".

•Generic Attribute Profile (GATT) and Attribute Protocol (ATT)

GATT defines how the Bluetooth Low Energy device transfers the data. The GATT process is

based on services and characteristics stored in Attribute Protocol (ATT). ATT is a simple lookup

table stored in device SRAM.

•Security Manager (SM)

The Security Manager defines the procedure for pairing, authentication and encryption between

BLE devices. This layer is mainly used if security is requested on that particular connection.

•Logical Link Control and Adaptation Protocol (L2CAP)

L2CAP supports high-level protocol multiplexing, packet segmentation/reassembly, and conveying

the quality of service information. L2CAP permits applications to transmit and receive the data

packets with channel flow control and retransmission.

•Direct test mode (DTM)

DTM allows testing of the radio's Physical Layer (PHY) by transmitting and receiving the test packet

sequences. This is often used in compliance and production line testing, without the need of going

through the complete Bluetooth Low Energy Protocol Stack.

1.4 ATBTLC1000 Host Software API

The ATBTLC1000 is provided with a dedicated Host software API layer. The purpose of this API layer is

to provide an easy and reliable solution to add Bluetooth Low Energy capabilities to any user application.

The API provides a set of high level Bluetooth function with abstraction of the transport protocol used

between the host MCU and the ATBTLC1000.

ATBTLC1000

Getting Started

Figure 1-2. Host Software API

Figure 1-3. BluSDK File Architecture

The API operation relies on a request-response mechanism. The specific requests are sent to

ATBTLC1000 through dedicated API function call. The event messages are then returned by the

ATBTLC1000 on request processing or on specific Bluetooth Low Energy events. These event messages

are to be handled by the host device, according to the user application requirements. The following figure

illustrates a typical Bluetooth Low Energy peripheral application flowchart.

ATBTLC1000

Getting Started

Figure 1-4. Bluetooth Low Energy Peripheral Application Flowchart

WARNING

The user application must be non-blocking to ensure that the Bluetooth Low Energy events are

handled in time.

1.5 Hardware Prerequisites

This document uses the ATBTLC1000ZR-XSTK kit. The ATBTLC1000ZR-XSTK kit is comprised of the

SAM L21 Xplained Pro (XPRO) and ATBTLC1000ZR XPRO extension board. The following sections

provide an overview of these kits and their features.

1.5.1 SMART™ SAM L21 Xplained Pro

The SMART™ SAM L21 Xplained Pro evaluation kit is used to evaluate the ATSAML21J18B

microcontroller. This kit includes an on-board embedded debugger to program and debug

ATSAML21J18B. The kit also contains an on-board current measurement circuitry, which enables the

user to measure current profile over time, without any external tools. The connection with any Xplained

Pro modules or external component is possible through available external connectors, which makes the

board perfect for prototyping the low-power applications.

ATBTLC1000

Getting Started

Figure 1-5. SAM L21 Xplained Pro Module

1.5.2 ATBTLC1000ZR Xplained Pro Extension board

The ATBTLC1000ZR Xplained Pro extension evaluation kit is based on Bluetooth Low Energy 4.1

compliant SoC ATBTLC1000-ZR110CA module. This extension is plugged to any of the supported host

MCU Xplained Pro evaluation boards, to quickly add Bluetooth Low Energy connectivity to the platform.

This kit provides easy access to the features of the ATBTLC1000-ZR110CA Bluetooth Low Energy

module and illustrates how to integrate the device in a custom design, which is supported by the Atmel

Studio integrated development platform.

ATBTLC1000

Getting Started

Figure 1-6. ATBTLC1000ZR Xpro Board

The ATBTLC1000ZR Xplained Pro extension board contains:

• ATBLTC1000-ZR110CA Module – Bluetooth Low Energy module with 2.4 GHz, Bluetooth Low

Energy 4.1 compliant ATBTLC1000-XR1100A SiP

• AT30TSE758A Digital Temperature Sensor – Integrated temperature sensor with nonvolatile

registers and serial EEPROM. Compatible with two-wire (I2C) and SMBus serial interfaces

• Current Measurement Header – Allows measurement of the current consumption of the board. It

must be closed to enable power to the ATBTLC1000-ZR110CA module

1.6 Hardware Setup

1. Ensure that ATBTLC1000ZR-XPRO power consumption header is closed and that jumpers are

placed on pins 2 to 3 of headers J105, J106, J107 and J108, as shown in the following figure.

ATBTLC1000

Getting Started

Figure 1-7. ATBTLC1000ZR-XPRO Extension

2. Connect the ATBTLC1000ZR-XPRO extension to EXT1 of SAM L21 XPRO, as illustrated in the

following figure.

Figure 1-8. ATBTLC1000ZR-XPRO Extension connected with SAM L21 XPRO

3. Connect the board to PC using the “Debug USB Connector”.

Figure 1-9. SAM L21 XPRO Connection to PC

ATBTLC1000

Getting Started

Autres manuels pour ATBTLC1000 Xplained Pro

Table des matières

Autres manuels Microchip Technology Carte mère

Microchip Technology

Microchip Technology ATtiny3217 Curiosity Nano Manuel d'installation

Microchip Technology

Microchip Technology ATtiny416 Xplained Nano Manuel utilisateur

Microchip Technology

Microchip Technology PIC16F17146 CNANO Manuel d'installation

Microchip Technology

Microchip Technology PIC16F15376 Curiosity Nano Manuel d'installation

Microchip Technology

Microchip Technology UCS1003-2 Manuel utilisateur

Microchip Technology

Microchip Technology MCP1663 Manuel utilisateur

Microchip Technology

Microchip Technology ADM00592 Manuel utilisateur

Microchip Technology

Microchip Technology MCP1632 Manuel utilisateur

Microchip Technology

Microchip Technology MCP1642B Manuel utilisateur

Microchip Technology

Microchip Technology ATBTLC1000 Xplained Pro Manuel utilisateur

Microchip Technology

Microchip Technology SOT89-3 Manuel utilisateur

Microchip Technology

Microchip Technology MCP73871 Manuel utilisateur

Microchip Technology

Microchip Technology TC64X Manuel utilisateur

Microchip Technology

Microchip Technology HV9805 Manuel utilisateur

Microchip Technology

Microchip Technology PIC32MK Manuel utilisateur

Microchip Technology

Microchip Technology MCP16301 Manuel utilisateur

Microchip Technology

Microchip Technology PICkit 3 Manuel utilisateur

Microchip Technology

Microchip Technology PIC32 Family Manuel utilisateur

Microchip Technology

Microchip Technology PAC1710 Manuel utilisateur

Microchip Technology

Microchip Technology DM160232 Manuel utilisateur

Microchip Technology

Microchip Technology PICtail MRF24J40ME Manuel utilisateur

Microchip Technology

Microchip Technology PIC18F57Q84 Curiosity Nano Manuel d'installation

Microchip Technology

Microchip Technology 28-Pin LIN DM164120-3 Manuel utilisateur

Microchip Technology

Microchip Technology MCP1632 Manuel utilisateur

Manuels Carte mère populaires d'autres marques

DFI

DFI SD170 Manuel utilisateur

ASROCK

ASROCK ROMED8-2T Manuel utilisateur

Asus

Asus P2L97A Manuel utilisateur

Winmate

Winmate IC70 Manuel utilisateur

Asus

Asus MES-B Manuel utilisateur

Grantech

Grantech SYS8F377VGGA-3OMN Manuel utilisateur

Telit Wireless Solutions

Telit Wireless Solutions SL869-3DR Manuel utilisateur

Gigabyte

Gigabyte GA-9IVDT Manuel utilisateur

Texas Instruments

Texas Instruments ADS8372EVM Manuel utilisateur

Commell

Commell MS-C73 Manuel utilisateur

IBT Technologies

IBT Technologies MB860 Manuel utilisateur

Nvidia

Nvidia TEGRA DG-04927-001_V01 Manuel utilisateur

Biostar

Biostar M7VIT Bravo Instructions d'utilisation et d'installation

Intel

Intel D33217CK Manuel utilisateur

Asus

Asus F1A55-M LX PLUS R2.0 Manuel utilisateur

EPC

EPC EPC9147C Manuel utilisateur

Asus

Asus EX-B760M-V5 D4 Manuel utilisateur

EPOX

EPOX MU-8KHA0010 Manuel utilisateur