Microchip Technology ATBTLC1000 Xplained Pro Guía de instalación

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

Otros manuales para ATBTLC1000 Xplained Pro

Tabla de contenidos

Otros manuales de Placa madre de Microchip Technology

Microchip Technology

Microchip Technology MIC4802 Manual de usuario

Microchip Technology

Microchip Technology MCP1252 Manual de usuario

Microchip Technology

Microchip Technology MCP1664 Manual de usuario

Microchip Technology

Microchip Technology MCP212X Manual de usuario

Microchip Technology

Microchip Technology ATSAMA5D27-WLSOM1-EK1 Manual de usuario

Microchip Technology

Microchip Technology MIC38300 Manual de usuario

Microchip Technology

Microchip Technology AVR-IoT Wx Manual de instalación

Microchip Technology

Microchip Technology MCP1642B Manual de usuario

Microchip Technology

Microchip Technology dsPICDEM MCSM Manual de usuario

Microchip Technology

Microchip Technology PAC1921 Manual de usuario

Microchip Technology

Microchip Technology ATtiny1627 Curiosity Nano Manual de instalación

Microchip Technology

Microchip Technology PL360G55CF-EK Manual de usuario

Microchip Technology

Microchip Technology MIC28514 Manual de usuario

Microchip Technology

Microchip Technology Voltage Supervisor SOT23 Manual de usuario

Microchip Technology

Microchip Technology SAM B11ZR Xplained Pro Manual de usuario

Microchip Technology

Microchip Technology dsPIC33CH Manual de usuario

Microchip Technology

Microchip Technology Microsemi CoaXPress VIDEO-DC-CXP Manual técnico

Microchip Technology

Microchip Technology TC64X Manual de usuario

Microchip Technology

Microchip Technology SAMA5D2-PTC-EK Manual de usuario

Microchip Technology

Microchip Technology AVR-IoT WG Manual de usuario

Microchip Technology

Microchip Technology EVB-USB7056 Manual de usuario

Microchip Technology

Microchip Technology Microsemi PolarFire Manual de usuario

Microchip Technology

Microchip Technology SOT23-5 Manual de usuario

Microchip Technology

Microchip Technology ATtiny1607 Curiosity Nano Manual de instalación

Manuales populares de Placa madre de otras marcas

DFI

DFI SD170 Manual de usuario

ASROCK

ASROCK ROMED8-2T Manual de usuario

Asus

Asus P2L97A Manual de usuario

Winmate

Winmate IC70 Manual de usuario

Asus

Asus MES-B Manual de usuario

Grantech

Grantech SYS8F377VGGA-3OMN Manual de usuario

Telit Wireless Solutions

Telit Wireless Solutions SL869-3DR Manual de usuario

Gigabyte

Gigabyte GA-9IVDT Manual de usuario

Texas Instruments

Texas Instruments ADS8372EVM Manual de usuario

Commell

Commell MS-C73 Manual de usuario

IBT Technologies

IBT Technologies MB860 Manual de usuario

Nvidia

Nvidia TEGRA DG-04927-001_V01 Manual de usuario

Biostar

Biostar M7VIT Bravo Instrucciones de funcionamiento e instalación

Intel

Intel D33217CK Manual de usuario

Asus

Asus F1A55-M LX PLUS R2.0 Manual de usuario

EPC

EPC EPC9147C Manual de usuario

Asus

Asus EX-B760M-V5 D4 Manual de usuario

EPOX

EPOX MU-8KHA0010 Manual de usuario