atbtlc1000 blusdk v6.1 release...

50
ATBTLC1000 BluSDK v6.1 Release Notes Description This document details the release notes of ATBTLC1000 BluSDK v6.1. © 2017 Microchip Technology Inc. Release Note WSGA-1881B-page 1

Upload: vutram

Post on 16-May-2018

256 views

Category:

Documents


6 download

TRANSCRIPT

Page 1: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

ATBTLC1000 BluSDK v61 Release Notes

Description

This document details the release notes of ATBTLC1000 BluSDK v61

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 1

Table of Contents

Description1

1 BluSDK Software Architecture4

2 Supported Hardware Platforms and IDEs 5

3 BluSDK Host Library Supported Architecture and Compilers7

4 BluSDK Release Contents 841 BluSDK Firmware Contents 9

5 BluSDK Firmware Contents12

6 BluSDK Release Features14

7 Release Revision History 1671 BluSDK v611672 BluSDK v501673 BluSDK v401774 BluSDK v301875 BluSDK v231976 BluSDK v221977 BluSDK v212078 BluSDK v202079 BluSDK v1x 21

8 Known issues 22

9 Limitations 2391 BluSDK Software2392 Mobile Applications 23

10 Additional InformationPre-requisites24

11 Power Save Measure Settings 25111 Hardware Setup 25112 Power Measure with Data Visualizer26113 Average Advertisement Current 27

12 Appendix 1 - Atmel BluSDK Change Log28121 BluSDK Module Changes28122 BLE Library API ndash New Features 31123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 5033

13 Appendix 2 - Hardware UART Flow Control Settings34

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 2

131 ATBTLC1000 Initialization 34132 Evaluation Kit Interface Details (With Adapter Board)36133 Evaluation Kit Interface Details (Without Adapter Board)37

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU39141 Host Flow Control 4-Wire Mode 39142 Host Flow Control 6-Wire Mode 39

15 Appendix 4 - Hardware Resources Used by BluSDK41151 Timer 41152 UART41153 GPIO 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70 42161 Installation Steps for VSIX File42162 External Interrupt (Host Wake-up)45

17 Appendix 6 - Re-initializing the BluSDK library46

The Microchip Web Site 47

Customer Change Notification Service47

Customer Support 47

Microchip Devices Code Protection Feature 47

Legal Notice48

Trademarks 48

Quality Management System Certified by DNV49

Worldwide Sales and Service50

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 3

1 BluSDK Software ArchitectureThe following diagram illustrates the various layers in the BluSDK Architecture for implementing variousapplications The External host can be supported on hardware platforms and IDEs (see Table 2-1)

Figure 1-1 BluSDK Software Architecture

ATBTLC1000BluSDK Software Architecture

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 4

2 Supported Hardware Platforms and IDEsThe following table provides the supported hardware platforms and IDEs of ATBTLC1000

Table 2-1 BluSDK ndash Supported Hardware Platforms and IDEs

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

SAM L21 (MCU) ATSAML21J18B ATBTLC1000

ATBTLC1000-XSTK

(ATSAML21-XPRO-B +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench forARM 7405

SAM L21 (MCU) ATSAML21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM L22 (MCU) ATSAML22N18A ATBTLC1000

ATSAML22 XPRO +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM D21 (MCU) ATSAMD21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM G55 (MCU) ATSAMG55J19 ATBTLC1000ATSAMG55-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM 4S (MCU) ATSAM4SD32C ATBTLC1000ATSAM4S-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 5

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

ARM 74038938or above

Note  Support for ATSAML21J18B (SAM L21 Rev B) device is added in IAR for ARM version 7405

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 6

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 2: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Table of Contents

Description1

1 BluSDK Software Architecture4

2 Supported Hardware Platforms and IDEs 5

3 BluSDK Host Library Supported Architecture and Compilers7

4 BluSDK Release Contents 841 BluSDK Firmware Contents 9

5 BluSDK Firmware Contents12

6 BluSDK Release Features14

7 Release Revision History 1671 BluSDK v611672 BluSDK v501673 BluSDK v401774 BluSDK v301875 BluSDK v231976 BluSDK v221977 BluSDK v212078 BluSDK v202079 BluSDK v1x 21

8 Known issues 22

9 Limitations 2391 BluSDK Software2392 Mobile Applications 23

10 Additional InformationPre-requisites24

11 Power Save Measure Settings 25111 Hardware Setup 25112 Power Measure with Data Visualizer26113 Average Advertisement Current 27

12 Appendix 1 - Atmel BluSDK Change Log28121 BluSDK Module Changes28122 BLE Library API ndash New Features 31123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 5033

13 Appendix 2 - Hardware UART Flow Control Settings34

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 2

131 ATBTLC1000 Initialization 34132 Evaluation Kit Interface Details (With Adapter Board)36133 Evaluation Kit Interface Details (Without Adapter Board)37

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU39141 Host Flow Control 4-Wire Mode 39142 Host Flow Control 6-Wire Mode 39

15 Appendix 4 - Hardware Resources Used by BluSDK41151 Timer 41152 UART41153 GPIO 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70 42161 Installation Steps for VSIX File42162 External Interrupt (Host Wake-up)45

17 Appendix 6 - Re-initializing the BluSDK library46

The Microchip Web Site 47

Customer Change Notification Service47

Customer Support 47

Microchip Devices Code Protection Feature 47

Legal Notice48

Trademarks 48

Quality Management System Certified by DNV49

Worldwide Sales and Service50

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 3

1 BluSDK Software ArchitectureThe following diagram illustrates the various layers in the BluSDK Architecture for implementing variousapplications The External host can be supported on hardware platforms and IDEs (see Table 2-1)

Figure 1-1 BluSDK Software Architecture

ATBTLC1000BluSDK Software Architecture

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 4

2 Supported Hardware Platforms and IDEsThe following table provides the supported hardware platforms and IDEs of ATBTLC1000

Table 2-1 BluSDK ndash Supported Hardware Platforms and IDEs

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

SAM L21 (MCU) ATSAML21J18B ATBTLC1000

ATBTLC1000-XSTK

(ATSAML21-XPRO-B +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench forARM 7405

SAM L21 (MCU) ATSAML21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM L22 (MCU) ATSAML22N18A ATBTLC1000

ATSAML22 XPRO +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM D21 (MCU) ATSAMD21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM G55 (MCU) ATSAMG55J19 ATBTLC1000ATSAMG55-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM 4S (MCU) ATSAM4SD32C ATBTLC1000ATSAM4S-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 5

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

ARM 74038938or above

Note  Support for ATSAML21J18B (SAM L21 Rev B) device is added in IAR for ARM version 7405

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 6

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 3: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

131 ATBTLC1000 Initialization 34132 Evaluation Kit Interface Details (With Adapter Board)36133 Evaluation Kit Interface Details (Without Adapter Board)37

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU39141 Host Flow Control 4-Wire Mode 39142 Host Flow Control 6-Wire Mode 39

15 Appendix 4 - Hardware Resources Used by BluSDK41151 Timer 41152 UART41153 GPIO 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70 42161 Installation Steps for VSIX File42162 External Interrupt (Host Wake-up)45

17 Appendix 6 - Re-initializing the BluSDK library46

The Microchip Web Site 47

Customer Change Notification Service47

Customer Support 47

Microchip Devices Code Protection Feature 47

Legal Notice48

Trademarks 48

Quality Management System Certified by DNV49

Worldwide Sales and Service50

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 3

1 BluSDK Software ArchitectureThe following diagram illustrates the various layers in the BluSDK Architecture for implementing variousapplications The External host can be supported on hardware platforms and IDEs (see Table 2-1)

Figure 1-1 BluSDK Software Architecture

ATBTLC1000BluSDK Software Architecture

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 4

2 Supported Hardware Platforms and IDEsThe following table provides the supported hardware platforms and IDEs of ATBTLC1000

Table 2-1 BluSDK ndash Supported Hardware Platforms and IDEs

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

SAM L21 (MCU) ATSAML21J18B ATBTLC1000

ATBTLC1000-XSTK

(ATSAML21-XPRO-B +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench forARM 7405

SAM L21 (MCU) ATSAML21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM L22 (MCU) ATSAML22N18A ATBTLC1000

ATSAML22 XPRO +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM D21 (MCU) ATSAMD21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM G55 (MCU) ATSAMG55J19 ATBTLC1000ATSAMG55-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM 4S (MCU) ATSAM4SD32C ATBTLC1000ATSAM4S-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 5

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

ARM 74038938or above

Note  Support for ATSAML21J18B (SAM L21 Rev B) device is added in IAR for ARM version 7405

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 6

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 4: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

1 BluSDK Software ArchitectureThe following diagram illustrates the various layers in the BluSDK Architecture for implementing variousapplications The External host can be supported on hardware platforms and IDEs (see Table 2-1)

Figure 1-1 BluSDK Software Architecture

ATBTLC1000BluSDK Software Architecture

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 4

2 Supported Hardware Platforms and IDEsThe following table provides the supported hardware platforms and IDEs of ATBTLC1000

Table 2-1 BluSDK ndash Supported Hardware Platforms and IDEs

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

SAM L21 (MCU) ATSAML21J18B ATBTLC1000

ATBTLC1000-XSTK

(ATSAML21-XPRO-B +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench forARM 7405

SAM L21 (MCU) ATSAML21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM L22 (MCU) ATSAML22N18A ATBTLC1000

ATSAML22 XPRO +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM D21 (MCU) ATSAMD21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM G55 (MCU) ATSAMG55J19 ATBTLC1000ATSAMG55-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM 4S (MCU) ATSAM4SD32C ATBTLC1000ATSAM4S-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 5

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

ARM 74038938or above

Note  Support for ATSAML21J18B (SAM L21 Rev B) device is added in IAR for ARM version 7405

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 6

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 5: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

2 Supported Hardware Platforms and IDEsThe following table provides the supported hardware platforms and IDEs of ATBTLC1000

Table 2-1 BluSDK ndash Supported Hardware Platforms and IDEs

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

SAM L21 (MCU) ATSAML21J18B ATBTLC1000

ATBTLC1000-XSTK

(ATSAML21-XPRO-B +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench forARM 7405

SAM L21 (MCU) ATSAML21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM L22 (MCU) ATSAML22N18A ATBTLC1000

ATSAML22 XPRO +(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM D21 (MCU) ATSAMD21J18A ATBTLC1000ATSAML21 XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM G55 (MCU) ATSAMG55J19 ATBTLC1000ATSAMG55-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ARM 74038938or above

SAM 4S (MCU) ATSAM4SD32C ATBTLC1000ATSAM4S-XPRO +

(ATBTLC1000 XPRO orATBTLC1000ZR XPRO)

Atmel Studiov70

IAR EmbeddedWorkbench for

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 5

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

ARM 74038938or above

Note  Support for ATSAML21J18B (SAM L21 Rev B) device is added in IAR for ARM version 7405

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 6

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 6: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Platform MCU Supported BLEModule Supported Evaluation Kits Supported IDEs

ARM 74038938or above

Note  Support for ATSAML21J18B (SAM L21 Rev B) device is added in IAR for ARM version 7405

ATBTLC1000Supported Hardware Platforms and IDEs

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 6

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 7: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

3 BluSDK Host Library Supported Architecture and CompilersThe following table provide the details on BluSDK Host library supported architecture and compilers

Table 3-1 BluSDK - Supported Architecture and Compilers (Library Support)

ArchitectureCompiler GCC IAR Keil

ARM Cortex-M0+

Yes

[PathltReleasePackagegtlibcm0p

gcc]

Yes

[Path ltReleasePackagegtlibcm0p

iar]

Yes

[Path ltReleasePackagegtlibcm0p

keil]

ARM Cortex-M3

Yes

[Path ltReleasePackagegtlibcm3gcc]

Yes

[Path ltReleasePackagegtlibcm3iar]

Yes

[Path ltReleasePackagegtlibcm3keil]

ARM Cortex-M4

Yes

[Path ltReleasePackagegtlibcm4gcc]

Yes

[Path ltReleasePackagegtlibcm4iar]

Yes

[Path ltReleasePackagegtlibcm4keil]

Note  For more information on porting the similar architecture library to other supported MCUs refer to Platform Porting Guide

ATBTLC1000BluSDK Host Library Supported Architecture and Compilers

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 7

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 8: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

4 BluSDK Release ContentsFolder Name Description

Documentation bull Adapter Layer API Documentationbull Software Development Guidebull Platform Porting Guidebull ATBTLC1000 BluSDK Example Profiles Application Users Guide This

includes the following example application

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Multi Connect Example (multi_role_multi_connect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

Firmware Example BLE Apps BLE Profiles and BLE Services are fully integrated in ASF

Added pre-build example hex files for SAM L21 XPro B and ATBTLC1000-ZRdevices

For Atmel Studio

Install the BluSDK61 available at httpwwwmicrochipcomdevelopment-toolsatmel-studio-7advanced-software-framework-28asf29

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 8

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 9: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Folder Name Description

MobileApplication

Contains the following mobile applications

1 Microchip SmartConnect Android application available in Google Play at httpsplaygooglecomstoreappsdetailsid=commicrochipbleanalyseramphl=en or Install Microchip SmartConnectAndroid application from Release package content(Microchip_SmartConnect_409apk)

2 Microchip SmartConnect iOS application available in Apple iTunes Stores at httpsitunesapplecomusappmicrochip-smartconnectid1240153044mt=8

Library IAR and GCC Keil compiler based Adaptor Library for Cortex M0+ CortexM3 andCortex M4 MCUs Also includes the header files for Library

PC Application bull Wireless Composer (BLE Performance Analyzer)bull ATBTLC1000-MR eFuse Block Program (Programming ATBTLC1000 eFuse)

41 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 4-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 9

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 10: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Folder Name Description

17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 10

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 11: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Folder Name Description

16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Release Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 11

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 12: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

5 BluSDK Firmware ContentsBluSDK firmware builds and runs on a MCU host (Table 2-1) BluSDK Libraries are ported to other vendorMCUs for details refer to Table 3-1 The Getting Started guide for each profile example providesinformation on how to find the example project using the ASF Example Project Wizard build Flash andexecute the software

Table 5-1 BluSDK Firmware Contents

Folder Name Description

Apps BLE Example Application Profiles and Services contains the followingExample Applications

1 Proximity Monitor Profile Example (pxp_monitor)2 Proximity Reporter Profile Example (pxp_reporter)3 Apple Notification Centre Service Example (ANCS)4 Battery Service Example (battery_info)5 Observer Example (ble_observer)6 Device Information Service Example (device_info)7 Health Thermometer Profile Example (htpt_temperature_sensor)8 Time Information Profile Example (time_information)9 Scan Parameter Example (scan_parameter)10 Simple Broadcaster Example (simple_broadcaster)11 Simple BLE Connection Example (simple_btlc1000_connection)12 HID Keyboard Example (hid_device_keyboard)13 HID Mouse Example (hid_mouse_keyboard)14 DTM Application Example (ble_dtm)15 Alert Notification Profile Example (alert_notification)16 Blood Pressure Profile Example (blood_pressure)17 Custom Profile Example (custom_serial_chat)18 Find me Profile Example (find_me)19 Heart Rate Profile Example (hr_sensor)20 Phone Alert Status Profile Exmaple (phone_alert_status)21 BLE Startup Template (startup_template)22 Multi Role Peripheral Multi Connect Example

(multi_role_peripheral_multiconnect)23 L2CAP Peripheral Example (l2cap_peripheral)24 L2CAP Central Example (l2cap_central)25 Eddystone Beacon Example (eddystone_beacon)26 Alt-Beacon Example (Altbeacon)

ble_profiles Contains the following BLE Profiles

1 Alert Notification2 Apple Alert Notification Service (ANCS)3 Proximity Monitor

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 12

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 13: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Folder Name Description

4 Proximity Reporter5 Time Information6 HID over GATT profile (HOGP)7 Phone Alert Status8 Blood Pressure9 Heart Rate10 Find me11 Custom Serial Chat

ble_services Contains the following BLE Services

1 Alert Notification Service2 BLE Manager-Common BLE Event Frame Work3 Apple Alert Notification Service (ANCS)4 Battery Service (BAS)5 Current Time Service (CTS)6 Device Information Service (DIS)7 Immediate Alert Service (IAS)8 Link Loss Service (LLS)9 Scan Parameter Service (SPS)10 Tx Power Service (TXPS)11 HID Device (HOGP Service)12 Blood Pressure13 Custom Serial Chat Service14 Heart Rate Service15 Next DST Service16 Phone Alert Service17 Reference Time Service18 Health Thermometer Service

Inc Top level includes for the delivered libraries and Platform APIs

Lib IAR and GCC compiler based Adaptor Library for Cortex M0+ and Cortex M4MCUs

services Application level services and Platform level ndash console serial driverserial_fifo timer and serial bridge

src Platform abstraction implementation for BLE Adapter Library

utils Utility functions used by BluSDK components (for example DBG_LOGDBG_LOG_DEV etc)

ATBTLC1000BluSDK Firmware Contents

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 13

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 14: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

6 BluSDK Release FeaturesBluSDK 61 release supports the following profiles and services

1 Profilesndash Alert Notificationndash Apple Alert Notification Center Service (ANCS)ndash Blood Pressurendash Custom Serial Chatndash Find Me Targetndash Heart Ratendash HOGP (HID Over GATT Profile)ndash Health Thermometerndash Phone Alert Statusndash Scan Parametersndash Time Informationndash Proximity

2 Services Supportndash Alert Notification Servicendash BLE Manager-Common BLE Event frameworkndash Apple Alert Notification Service (ANCS)ndash Battery Service (BAS)ndash Current Time Service (CTS)ndash Device Information Service (DIS)ndash Immediate Alert Service (IAS)ndash Link Loss Service (LLS)ndash Scan Parameter Service (SPS)ndash Tx Power Service (TXPS)ndash HID Device (HOGP Service)ndash Blood Pressurendash Custom Serial Chat Servicendash Heart Rate Servicendash Next DST Servicendash Phone Alert Servicendash Reference Time Servicendash Health Thermometer Service

3 Mobile Applicationsndash Microchip SmartConnect mobile application for Android

bull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Alert Notificationbull Time Information

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 14

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 15: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

bull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Phone Alert Statusbull Simple broadcasterbull Generic GATT Database

ndash Microchip SmartConnect mobile application for iOSbull Health Thermometerbull Proximity Monitorbull Blood Pressurebull Scan Parametersbull Find Mebull Heart Ratebull Batterybull Device Information Servicebull Eddystone Beaconbull iBeaconbull Alt Beaconbull Generic GATT Database

Example applications are provided for the profileservices mentioned above and are available for ATSAML21SAM L21 Rev BSAM L22SAM G55SAM D21SAM 4S MCU platforms

ATBTLC1000BluSDK Release Features

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 15

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 16: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

7 Release Revision History

71 BluSDK v61

711 Major New Features of BluSDK Software1 ATBTLC1000-ZR module support is added2 Eddy stone and Alt beacon applications are added3 L2CAP throughput CentralPeripheral applications are added4 Added support for multiple Baudrate of ATBTLC1000 and Host Interface such as 9600 19200

38400 57600 115200 230400 460800 and 921600 BluSDK validation done with followingBaudrate such as 9600 115200 and 921600

5 Added Host wake-up feature from ATBTLC1000 for Host events when Host MCU is in Sleep mode6 SAM L22 start-up template support added for quick start application development7 PTS compliance is achieved for the Standard Bluetooth SIG profile examples8 Added new API to support for cooperative multi-tasking RTOS

712 Major Improvements and Bug Fixes1 Supports the update of On-the-fly advertisement data2 BLE Manager event callback structure added for GATT GAP L2CAP and Custom events3 Replaced the Library software timers with platform timers4 Reduced the start-up delay from 3000 ms to 1600 ms5 Added fail-safe mechanism for Host communication out of sync For details on implementation

refer to Appendix 6 - Re-initializing the BluSDK library6 Rx FIFO memory and event pool memory are configured from user application7 Added custom events for Host MCU application interrupts in BluSDK examples8 Fixed value length of IndicationNotification is from uint8_t to uint16_t9 Fixed missing calibration events occurring during shorter sleep intervals10 Fixed recovery issue observed when device is disconnected during and ldquoin and outrdquo of range

situation11 Fixed Out of Order Packet (OOP) issue occurring during high throughput12 Added new API to get RF settings version Current version is 1013 Fixed Tx modulation issue observed on some devices14 Fixed connection parameter update issue observed in some iOS and Android devices

72 BluSDK v50

721 Major New Features of BluSDK Software1 Added support for SAM 4S Platform2 Added support for periodic temperature and voltage calibration for every two seconds3 Added Tx-Fm calibration on cold-boot4 Added one time 26 MHz RC calibration to enable injection locking5 Added 3 new APIs for Calibration

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 16

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 17: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

ndash at_ble_calib_config()ndash at_ble_calib_get_temp()ndash at_ble_calib_get_voltage()

6 Changed Hardware Flowcontrol compilation flag selection during runtime7 Platform modularization to make the Library as an independent module8 Added support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 70 where the

DTM Tx Power set and CW Tone are incorporated

722 Major improvements and bug fixes1 UART flow control 2-wire mode is removed due to instability between Host and ATBTLC1000

communication2 Fixed issue for encryption without MITM (No Authentication and No Authorization) and insufficient

key permissions3 Fixed 6-wire mode UART initialization issue on SAM G55 serial_drvc4 Storing the LTK of peer device for encryption5 DTM instability issue is fixed6 Mobile Application Atmel SmartConnect for Android

61 Bug fixes in Scan Parameter profile and Battery service62 Support for tablets that do not have android hardware Telephony feature

73 BluSDK v40

731 Major New Features of BluSDK Software1 Support for wireless composer ndash BLE Performance Analyzer in Atmel Studio 702 Support for configurable UART flow control modes like 6_WIRE (for 2 stage UART communication

for flow control support) 4_WIRE (single UART with flow control) and no flow control

732 Mobile ApplicationEnhanced Atmel SmartConnect (Version 20) tablet application for iOS and Android

733 Adapter Library1 Added support for ULP (Ultra Low Power)2 Support for configurable UART hardware flow control for ATBTLC1000

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 17

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 18: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Figure 7-1 ATBTLC1000 XPRO Extension Board with EXT1

Important 1 This SDK package is only compatible with the revised ATBTLC1000 XPRO

extension boards The revised boards can be identified with a green dot on thefront and a reworked wire on the back as shown in Figure 7-1 The revised boardshave the CHIP_ENABLE pin re-mapped from Pin 10 to Pin 4 to allow the use ofUART flow control on the extension header

2 For example projectsapps using the SAM L21 ensure to plug the ATBTLC1000XPRO extension board to EXT1 only

734 Major Improvements and Bug Fixes1 GAP advertisement is moved from all profilesservicesapplication to ldquoble_managerrdquo2 Generic BLE event handling call back mechanism

74 BluSDK v30

741 Major New Features of BluSDK Software1 Support for new profiles like Blood Pressure Heart Rate Monitor Phone Alert Status Time

Information Custom Serial Chat Find Me and Alert Notification on SAM L21SAM D21SAM G55platforms

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 18

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 19: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

2 Support for new services Alert Notification Blood Pressure Custom Serial Chat Current TimeHeart Rate Next Daylight Saving Time Phone Alert and Reference Time on SAM L21SAM L21Rev BSAM D21SAM G55 platforms

3 Support for wireless composer ndash BLE Performance Analyzer4 BLE Startup template example

742 Mobile ApplicationEnhanced Atmel SmartConnect mobile application for iOS and Android

743 Adapter LibraryEnhanced New version of adapter library upgraded and compatible to ATBTLC1000 Rev B1 running witha BLE 41 stack (Refer to Annexure for more details)

744 Documentation1 Updated BLE API Reference Manual2 Updated BLE API Software Development User Guide3 Updated BLE Platform Porting Guide4 Enhanced Getting Started User Guide documents for each example application

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit (ATBTLC1000-XSTK) for running the example applications delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21Xplained Pro

75 BluSDK v23

751 Major New Features of BluSDK Softwarebull Support for Direct Test mode on SAM L21SAM D21SAM G55 Platforms

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the

starter kit for running the example applications which are delivered as part of theSDK

2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

76 BluSDK v22

761 Major New Features of BluSDK SoftwareSupport for ATBTLC1000 - XSTK (Starter Kit) with addition of SAM L21 MCU platform

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 19

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 20: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Important 1 It is recommended to use ATBTLC1000 XPRO extension board delivered with the starter

kit to run the example applications delivered as part of the SDK2 The user must plug the ATBTLC1000 XPRO extension board in EXT2 of SAM L21

762 Major Improvements and Bug FixesDocumentation update Applicable to all ldquoGetting Startedrdquo documentation ndash adding setup information anddetails for using ATBTLC1000SAM L21 starter kit

77 BluSDK v21

771 Major New Features of BluSDK Softwarebull HID keyboard Example Applicationbull HID mouse Example Application

772 Major Improvements and Bug Fixes1 Adaptor Library adds supports for report reference descriptor (refer structure

at_ble_characteristic_gen_t)ndash Descriptor value set API added (refer API at_ble_descriptor_value_set)ndash Descriptor value get API added (refer API at_ble_descriptor_value_get)ndash New data structure added to hold the descriptor and presentation format

2 Added new adaptor API for common service definition of both primary and secondary service (referAPI at_ble_service_define)

78 BluSDK v20

781 Major New Features of BluSDK Software1 ANCS Profile Example Application2 Time Profile Example Application3 Proximity Monitor Example Application4 Proximity Reporter Example Application5 Observer Mode Example Application6 Broadcaster Mode Example Application7 Battery Service Example Application8 Scan Parameter Service Example Application9 Device Information Service Example Application10 BLE Manager ndash Common event handling support11 BLE ndash Services and Profiles are converted as pluggable components

782 Mobile Application1 New Atmel SmartBLU iOS Application supporting Proximity Monitor2 New Atmel SmartBLU Android Application supporting

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 20

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 21: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

ndash HTPT Profilendash Proximity Monitor

783 Major Improvements and Bug FixesHTPT Disable and Enable Notification for temperature added to HTP application

79 BluSDK v1xTable 7-1 BluSDK v1x Release History

FixUpdate Description

BluSDK v13 Release

1 Health ThermometerProfile example usingATBTLC1000 board andIO1 Sensor board onboth SAM D21 and SAMG55

2 Simple ATBTLC1000Connection examplewhich advertisesiBeacon data on bothSAM D21 and SAM G55

3 Adds support forATBTLC1000 A5devices (ES2)

Major new featuresbull [BLUSDK-17] - Support added for ATBTLC1000 A5 (ES2) and

ATBTLC1000 A3 (ES1) devices in a single Librarybull [BLUSDK-5] - ATBTLC1000 is unable to recover during power-onbull [BLUSDK-27] - IAR Support for HTP BluSDK

Note  This feature is only available as a part of standalone ASFpublic release

bull [BLUSDK-28] - Support Atmel Studio 70bull [BLUSDK-29] - Serial Buffer mechanism between ATBTLC1000

and Hostbull [BLUSDK-30] - Floating point conversion from IEEE754 to

IEEE11073 for precision temperature measurement

Major improvements and bug fixes

bull [BLUSDK-24] - Addresses the disconnection issue after pairingfails in HTP

bull [BLUSDK-31] - Delay utility for initializationbull [BLUSDK-32] - Random temperature type and temperature

measurement location change during button pressbull [BLUSDK-33] - ATBTLC1000 chip id version display in consolebull [BLUSDK-34] - ATBTLC1000 BD address display in console

BluSDK v12 Release

BUG Fix D21 Clock Drift Issuewith respect to temperature

Major improvements and bug fixes

[BLUSDK-4] - D21 Clock Drift issue with respect to temperature

ATBTLC1000Release Revision History

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 21

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 22: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

8 Known issuesThe following table provide the details on BluSDK SoftwareTable 8-1 BluSDK Software

JIRA ID Description

BLUSDK-1093 Observed link disconnection with mobile on one device after 8 hours Issue underinvestigation

BLUSDK-1092 Multi RoleMulti Connect feature observed stability issue for multiple connectionsafter 30 minutes Issue under investigation

BLUSDK-1078 Pairing information is not stored in the NVM During power-cycle the host MCUdisconnect its peer device bonding information since there is no PDSimplementation on host side

BLECORE-1000 At 9600 Baudrate the L2CAP application connection get fails

Note 1 BluSDK61 supports only with UART hardware flow control (4-Wire6-Wire) in SAM L21SAM

L22SAM D21SAM G55SAM 4S platforms2 BluSDK61 supports ATBTLC1000-ZR modules with 4-Wire mode only Hardware flow control is

supported in SAM L21SAM L22SAM D21SAM G55SAM 4S platforms

The following table provide the details on mobile applicationsTable 8-2 Mobile Applications

JIRA ID Description

BLEMAPPS-68 Android 6x and 5x unread status alert for SMS that are not supported

BLEMAPPS-72 Go to ldquoout of rangerdquo and ldquocome backrdquo it fails to reconnect Health ThermometerProfile (HTP)

BLEMAPPS-48 If pairing request is cancelled Microchip SmartConnect App shows ldquopairing inprogressrdquo status for some time After timeout it cancels the pairing

BLEMAPPS-55 Issue in pairing with HTC one m8 phone

BLEMAPPS-66 Ipad Mini is unable to display iBeacon on radar screen

ATBTLC1000Known issues

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 22

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 23: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

9 LimitationsThis section describes about BluSDK software and Microchip SmartConnect mobile applications

91 BluSDK Software1 Adapter Layer and Platform

ndash Adapter library require enhancements to make it RTOS compatible and thread-safendash SPI interface is not yet supported

2 Profilesndash HOGP ndash HID

bull HID keyboard device example application and HID mouse device example applicationare compatible only with Android based mobile devices (Android 44KitKat and higherversions)

bull HID keyboard device example application supports only ldquoJust Worksrdquo pairingndash PTS Compliance

bull ANCS and TIP are Apple iOS specific implementationsbull PTS test cannot be executed for BT SIG profile specification compliance

3 Standalone ASF archivendash In Windows OS the maximum path length is 260 characters It is always recommended to

extract the standalone ASF archive into root directory of the Local driveNote  For example CASF

92 Mobile ApplicationsMicrochip SmartConnect Android application

1 Commonndash Android Framework limitations When wrong pass-key is entered still pairing succeeds

2 Phone Alert Display state is not supported3 Custom Serial Chat

ndash Android-444 (KitKat) can support only upto 20 charactersndash Android-5x and 6x (Lollipop and Marshmallow) can support less than 150 characters If

more than 150 characters are entered then complete data is not sentndash iOS can support upto 150 characters

4 When the device is moved the beacon icon updates are as not fast as the movement paceHowever there is an improvement in beacon icon update compared to older versions of Androidapp

ATBTLC1000Limitations

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 23

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 24: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

10 Additional InformationPre-requisites1 It is recommended to use the ATBTLC1000 XPRO (MRZR) extension boards provided as part of

the ATBTLC1000 X-STK (Starter Kit)2 To test ANCS and Time Profile an iPhonereg supporting iOS version above 70 is required3 General information with reference to BLE support on mobile devices are as follows

31 iOSbull iPhone 4S and above supports the BT 40 and higher It is recommended to use a

device with iOS version 80 or above for best performance and stability32 Android

bull Preliminary support for BT 40 is added in Android Jellybean (42 onwards)bull For best performance and stability it is recommended to use a device with Android

version above 5x and 6x (that is preferably Marshmallow or Lollipop)bull Due to a wide-spectrum of Android devices with many variants (customized Android

devices various hardwareconnectivity chipset configurations) the performance ofBLE Application are not the same on all devices Android phone that includes aBluetooth chipset supporting version 40 or higher is a pre-requisite

bull Due to evolving nature of BLE APIs in Android the performancestability variationsare observed when testing with different Android release flavorrsquos (Jellybean43KitKat44 and Lollipop51)

bull HID over GATT profile was introduced in Android from version 44 (KitKat) A mobiledevice supporting Android 44 and higher is a pre-requisite for running the HIDkeyboard device and HID mouse device example applications

bull Disconnection triggered by the application running in an Android takes a long time(12 to 15 seconds) to complete

bull When the peripheral device is reset then the manual unpair is required in Androidphone to reconnect

ATBTLC1000Additional InformationPre-requisites

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 24

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 25: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

11 Power Save Measure Settings

111 Hardware Setup

1111 Board WiringSet the board wiring as shown in following figure

Note  Jumper is connected to ldquoBypassrdquo to measure only for ATBTLC1000

Figure 11-1 Board Wiring

1112 Connection1 Connect the DEBUG-USB jack with a Micro-USB cable to the PC2 Remember the COM port3 Open Atmel Studio 70

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 25

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 26: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Figure 11-2 ATBTLC1000 CONNECTION

1113 Troubleshooting (Optional)1 Sometimes the upgrade of the EDBG firmware fails as shown in following figure

Figure 11-3 Firmware Upgrade Window

2 In this kind of situations the command line can be last rescue as shown in following figureFigure 11-4 Command Line Window

112 Power Measure with Data VisualizerThe following figure illustrates the Atmel Studio window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 26

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 27: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Figure 11-5 Atmel Studio

1 In Menu bar select Tools gt DataVisualizer that displays DGI control panelNote  Data Visualizer runs effectively in Standalone mode

2 On the control panel click ConnectDisconnect (1) and select ldquoPowerrdquo (2) check boxndash Click Connect to pair with ldquoSAM L21 Xplained Pro Brdquondash Click Disconnect to unpair with ldquoSAM L21 Xplained Pro Brdquo

3 On the control panel click StartStop (3) that displays the ldquoPower Analysisrdquo (4) windowndash Click Start to calibrate the powerndash Click Stop to stop the power calibration

113 Average Advertisement Currentbull Initially the example advertises for every 1s interval rather than 625 ms with approximately 250 microA

currentbull Advertisement interval is changed by using BECON_ADV_INTERVALbull Verify the average advertisement current in the ldquoPower Analysisrdquo windowbull Auto calibration must be disabled (continuous calibration consumes more power) and

advertisement type must be set to AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED

Figure 11-6 Power Analysis Window

ATBTLC1000Power Save Measure Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 27

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 28: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

12 Appendix 1 - Atmel BluSDK Change LogThe BluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 RevB1 and BLE 41 compliant devices This section provide details of the new features introduced in the APIand a change comparison with the previous version of BluSDK API

121 BluSDK Module ChangesThe following table provides the details on New features in the APIs

Table 12-1 New Features in the API - New Signature versus Modified Signature

Category SlNo Description Old signature New signature

BLE Manager 1 Handler for ProfileServiceapplication toregister the BLEevents callbacks

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_typeconstble_event_callback_tble_event_handler)

boolble_mgr_events_callback_handler(ble_mgr_event_cb_tevent_cb_typeble_mgr_event_tevent_type constvoidble_event_handler)

2 Handler for out ofsynchronousindication handlerWhen device startsmissing few events orUART BLE eventdata

-

at_ble_status_tble_device_out_of_sync_handler(void params)

3 Handler for BLEdevice deadindication handlerWhen the applicationreceives this eventthat means BLEdevice is notresponding Theapplication starts theBLE device frombeginning by callingthe at_ble_init

-

at_ble_status_tble_device_dead_handler(voidparams)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 28

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 29: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Category SlNo Description Old signature New signature

Platform 1 Configure the primaryUART interface withspecified Baudrate -

voidplatform_configure_primary_uart(uint32_t baudrate)

2 Configure thesecondary UARTwith hardware flowcontrol is enabled(Tx Rx RTS andCTS)

voidplatform_configure_hw_fc_uart(void)

voidplatform_configure_hw_fc_uart(uint32_t baudrate)

3 Application makesthe Host MCU tosleep or to RTOSenvironment whichyields the task forscheduler to performother task

-

voidplatform_enter_sleep(void)

Sam0serial_drvc

1 Dynamic Baudrateconfiguration for Host

voidconfigure_usart_after_patch(void)

voidconfigure_usart_after_patch(uint32_t )

2 Serial driverinitialization forATBTLC1000communication

uint8_tconfigure_serial_drv(void)

uint8_tconfigure_serial_drv(uint32_t)

3 Set Host UART RTSpin to high -

voidplatform_set_btlc1000_rts_high(void)

4 Set Host UART RTSpin to Low -

voidplatform_set_btlc1000_rts_low(void)

5 Set platform Host tosleep -

voidplatform_set_hostsleep(void)

6 Restore the platformfrom sleep for normalcommunication

-voidplatform_restore_from_sleep(void)

7 Configure the Sleepmanager for Hostsleep functionality -

voidplatform_configure_sleep_manager(void)

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 29

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 30: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Category SlNo Description Old signature New signature

Timer_hwh 1 Platform create timerAPI name changed

voidplatform_configure_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

voidplatform_create_hw_timer(platform_hw_timer_callback_tbus_tc_cb_ptr)

2 Platform start timerAPI changed toreflect the timer unitin seconds

voidhw_timer_start(uint32_ttimer_val)

voidhw_timer_start(uint32_ttimer_val_s)

3 Platform API addedto start the timer withtime units in ms -

voidhw_timer_start_ms(uint32_ttimer_val_ms)

The following table provides the details on ldquoData Structuresrdquo

Table 12-2 Data Structures

Category Description Status Structure Name

BLE-Manager BLE GAP Event callbacktypes

New ble_gap_event_cb_t

BLE GATT Client callbacktypes

New ble_gatt_client_event_cb_t

BLE GATT Servercallback types

New ble_gatt_server_event_cb_t

BLE L2CAP callbacktypes

New ble_l2cap_event_cb_t

BLE HTPT event callbacktypes

New ble_htpt_event_cb_t

BLE DTM event callbacktypes

New ble_dtm_event_cb_t

BLE Custom eventcallback types

New ble_custom_event_cb_t

This event types are usedto

bull Subscribe theGroup of BLEEvent callbacks or

bull Unsubscribe theGroup of BLEEvent callbacks

New ble_mgr_event_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 30

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 31: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Category Description Status Structure Name

Subscribe the events orUnsubscribe the events

New ble_mgr_event_cb_t

AdvertisementScanningthe Link layer states andPaired encryption statesused by BLE manager

New ble_device_ll_state_t

Client characteristics theConfiguration descriptorstatus

New ble_gatt_cccd_status_t

Memory for BLE eventpool and Host UARTreceived bytes are storedin FIFO memory

New Uint32_t event_pool_memoryrx_fifo_memory

Resolve the Address flagused to identify theaddress of the peerdevice which is alreadyknown to host MCU

New resolve_addr_flag

122 BLE Library API ndash New FeaturesBluSDK v61 release includes an enhanced version of BLE API compatible with ATBTLC1000 Rev B1and BLE 41 compliant devices This section provide details of the new features introduced in the API anda change comparison with the previous version of the APITable 12-3 New Features in the API

Category New features Description APIEvent

UARTthroughput

Dynamic Baudrate Select the UARTBaudrate from userapplication duringinitialization (960019200 38400 57600115200 230400460800 and 921600)

at_ble_init

Dynamic event pool depth User applicationallocates the requiredmemory pools forevents and eventparameters dependingon applicationrequirements

at_ble_init

Event pool Ability for Host MCU to detect thefailures in ATBTLC1000 andrecover from it

New events added toinform the host of crashfailures and allows host

-

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 31

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 32: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Category New features Description APIEvent

to recover from thisstate

Support forRTOSHostMCU Sleep

API library to the support widerange of RTOS with less changesor

New API defined to yieldthe tasks to schedulerfor supporting RTOSfeatures and supportingHost MCU Sleepor

at_ble_event_wait

Feature to support Host MCUSleep

Defining requirements toreuse the Host IRQsignal fromATBTLC1000 for UARTinterfaces to supportHost MCU Sleep

at_ble_event_wait

Eddystonebeacon

Add the following APIs to supportEddystone beacon

bull at_ble_adv_data_update_on_the_fly

bull at_ble_get_adv_cntbull at_ble_rst_adv_cntbull at_ble_en_recv_adv_cm

p_eventbull AT_BLE_ADV_CMP_EVENT

- -

Set ULPdelay

Set the ULP delay based on theCrystal Start-up time

Add support for differentULP delay parameters

at_ble_set_ulp_delay

RTOSsupportenhancement

Enhance RTOS support by addingsignals to provide context switchingwith complete take over to the OS

Following APIs functionsneeds to be

implemented andregistered before callingat_ble_init For

more information referto Platform Porting

Guide

void(at_ble_create_signal)(void)void(at_ble_delete_signal)(void )void(at_ble_trigger_signal)(void )void(at_ble_reset_signal)(void )void(at_ble_wait_for_signal)(uint32_tvoid )

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 32

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 33: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50Table 12-4 Modified API

Category Feature Old signature New signature

SystemInitialization

AdvertisementChannel mapsetting API

at_ble_set_adv_channel_Map

at_ble_adv_channel_map_set

Table 12-5 Modified Structures

Category New features Status Structure Name

SystemInitialization

Platform callbackregister

New at_ble_platform_api_list_t

GAP Structures Bus information New at_ble_bus_info_tInit Configuration Modified at_ble_init_config_t

ATBTLC1000Appendix 1 - Atmel BluSDK Change Log

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 33

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 34: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

13 Appendix 2 - Hardware UART Flow Control SettingsGo to the following path and set the configurations on Project Settings Refer to the write procedure ofldquoHardware Flow Control for 4-Wire Mode eFuserdquo in ATBTLC1000 BluSDK Example Profiles ApplicationUsers Guide

Project Settings gt Properties gt Toolchain gt ARMGNU C Compiler gt SymbolsTable 13-1 Hardware UART Flow Control Settings

Flow Control Mode Description Supported ATBTLC1000Module and Host MCU

UART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =false

Only one UART is used forboth patch download andUART data transmissionby using flow control Totest this mode eFuse mustbe set Use the GUI towrite eFuse5 and Offset0xc to 0x10000000

Host MCU SAM L21 SAML22 SAM G55 SAM 4Sand SAM D21

ATBTLC1000ATBTLC1000 XPRO-MRmodule (with eFuse) andATBTLC1000 XPRO-ZRmodule come with flowcontrol in eFuse by default

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =true

Two UARTs are used onefor patch download andanother one for UART datatransmission with flowcontrol

Host MCU SAM L21 SAML22 SAM G55 and SAMD21

ATBTLC1000 OnlyATBTLC1000 XPRO-MRmodule (without eFuse)

UART_FLOWCONTROL_4WIRE_MODE =false

UART_FLOWCONTROL_6WIRE_MODE =false

Invalid option Not supportedUART_FLOWCONTROL_4WIRE_MODE =true

UART_FLOWCONTROL_6WIRE_MODE =true

131 ATBTLC1000 InitializationIn case of BluSDK or supplied BluSDK the BLE Manager is not used and the following settings arerequired for at_ble_init API This parameters are passed as arguments to at_ble_init Thesearguments contains at_ble_init_config_t and platform_config structures This structures areto be properly initialized and passed to at_ble_init API In case of incorrect configuration the wrongpatch file downloads into ATBTLC1000 which disrupts an UART functionality

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 34

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 35: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Register Platform APIs for ATBTLC1000 communication

at_ble_init_config_t pf_cfg = Register Platform callback APIs platform_api_listat_ble_create_timer = platform_create_timerplatform_api_listat_ble_delete_timer = platform_delete_timerplatform_api_listat_ble_start_timer = platform_start_timerplatform_api_listat_ble_stop_timer = platform_stop_timerplatform_api_listat_ble_sleep = platform_sleepplatform_api_listat_ble_gpio_set = platform_gpio_setplatform_api_listat_ble_send_sync = platform_send_syncplatform_api_listat_ble_recv_async = platform_recv_asyncplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uartplatform_api_listat_ble_event_wait = platform_enter_sleep

Attribute Database Memory

pf_cfgmemPoolmemSize = BLE_ATT_DB_MEMORY_SIZE pf_cfgmemPoolmemStartAdd = (uint8_t )ampatt_db_data

Memory for Events and UART Rx FIFO

pf_cfgevent_mem_poolmemStartAdd = (uint8_t )event_pool_memory pf_cfgevent_mem_poolmemSize = sizeof(event_pool_memory) pf_cfgevent_params_mem_poolmemStartAdd = (uint8_t )event_params_memory pf_cfgevent_params_mem_poolmemSize = sizeof(event_params_memory) pf_cfgrx_fifo_mem_poolmemStartAdd = (uint8_t )rx_fifo_memorypf_cfgrx_fifo_mem_poolmemSize = sizeof(rx_fifo_memory)

Module Configuration

For ATBTLC1000-ZR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_ZR

For ATBTLC1000-MR module

pf_cfgbtlc1000_module_version = AT_BTLC1000_MR

Bus Type Configuration

pf_cfgbus_infobus_type = AT_BLE_UART

Host Wake-up ATBTLC1000 Pin No configuration

pf_cfgbus_infohost_external_wakeup_gpio = BTLC1000_EXT_PIN9

Hardware Flow Control Enabling through Patch

pf_cfgbus_infobus_flow_control_enabled = true pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_hw_fc_uart Configure secondary USART with Hardware Flow control enabled

Hardware Flow Control Enabled via eFuse

pf_cfgbus_infobus_flow_control_enabled = false pf_cfgplatform_api_listat_ble_reconfigure_usart = platform_configure_primary_uartRe-configure the USART with specified baudrate

Host ATBTLC1000 Communication Baudrate

pf_cfgbus_infobus_baudrate = HOST_UART_BAUDRATE_CONFIG_VALUE 9600 19200 38400 57600 115200 230400 and 460800

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 35

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 36: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Set Device Configuration

Device configurations are like Device role GATT handles MTU value enable service changed indicationdevice address and address renewal duration etc

Refer to ble_mgrc ble_set_dev_config and ble_device_init APIs for (at_ble_init)initialization

For more information refer to supplied AT_BLE_API_USER_MANUALchm file

132 Evaluation Kit Interface Details (With Adapter Board)The ATBTLC1000-XPRO-ADPT is an adapter board used with ATBTLC1000-XPRO expansion board Itis required for an UART hardware flow control functionality to operate correctly when the ATBTLC1000-XPRO expansion board is connected to certain Xplained MCU base boards

The ATBTLC1000-XPRO-ADPT adapter board supports the SMART SAM L21 Xplained Pro SAM D21Xplained Pro SAM 4S Xplained Pro and SAM G55 Xplained Pro boards

For more information on ATBTLC1000-XPRO-ADPT adapter board and Jumper configuration refer to ATBTLC1000 Xplained Pro User Guide

Table 13-2 Adapter Board Requirement

Host XplainedPro Board

Host FlowControl Mode

ATBTLC1000eFuse Required

ATBTLC1000Adapter Board

Required

Adapter BoardJumper Configuration

SAM D21 XProSAM L21 XProSAM L22 XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W2 andW3 side(1)

SAM D21 XProSAM L21 XProSAM L22 XPro

6-Wire mode No No Not applicable

SAM G55 XProSAM 4S XPro

4-Wire mode Yes Yes Jumpers must beplaced only on W1 andW3 sides(1)

SAM G55 XPro 6-Wire mode No Yes Jumpers must beplaced only on W1 andW4 sides(1)

SAM 4S XPro 6-Wire mode isnot supported

No No Not applicable

Note 1 Ensure that the jumpers are not placed in other locations of the adapter board

Adapter board is not required for evaluation with ATBTLC1000-ZR XPRO board Ensure that the jumpersare placed as indicated in the following table

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 36

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 37: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Table 13-3 ATBTLC1000-ZR XPRO Jumper Configuration

Host Xplained Pro Board Host Flow ControlMode XPRO Jumper Configuration

SAM D21 XPro SAM L21XPro SAM L22 XPro

4-Wire mode Jumpers must be placed on pins 2-3 of headersJ105 J106 J107 and J108(1)

SAM G55 XPro SAM 4S XPro 4-Wire mode Jumpers must be placed on pins 1-2 of headersJ101 J102 J103 and J104(2)

Note 1 Ensure that jumpers are not placed on headers J101 J102 J103 and J1042 Ensure that jumpers are not placed on headers J105 J106 J107 and J108

133 Evaluation Kit Interface Details (Without Adapter Board)Wires are connected to support UART hardware flow control for SAM G55 (4-Wire 6-Wire) and SAMD21L21L224S (4-Wire)Figure 13-1 Hardware Interface Details (without Adapter Board)

The following table specify the details on SAM G55 4-Wire mode UART flow control connection (Pinmapping)

Table 13-4 Hardware Flow Control 4-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up

(EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU UART Rx (EXT1-PIN13) (EXT1-PIN15) PIN13 ndash ATBTLC1000 Tx

MCU UART Tx (EXT1-PIN14) (EXT1-PIN17) PIN14 ndash ATBTLC1000 Rx

MCU UART RTS (EXT1-PIN5) (EXT1-PIN16) PIN11 ndash ATBTLC1000 CTS

MCU UART CTS (EXT1-PIN6) (EXT1-PIN18) PIN12 ndash ATBTLC1000 RTS

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 37

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 38: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Pin Description SAM G55SAM 4SXPro (EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Table 13-5 Hardware Flow Control 6-Wire Mode Interface Details ndash ATBTLC1000 MR Module

Pin Description SAM G55 XPro(EXT1)

SAM D21L21L22XPro (EXT1) ATBTLC1000 XPro

ATBTLC1000 Wake-up (EXT1-PIN4) (EXT1-PIN6) PIN6 ndash ATBTLC1000 Wake-up

ATBTLC1000 ChipEnable

(EXT1-PIN10) (EXT1-PIN4) PIN4 ndash ATBTLC1000 ChipEnable(1)

MCU Primary UART Rx (EXT1-PIN17) (EXT1-PIN13) PIN13 ndash ATBTLC1000 Tx

MCU Primary UART Tx (EXT1-PIN16) (EXT1-PIN14) PIN14 ndash ATBTLC1000 Rx

MCU Secondary UARTRx

(EXT1-PIN13) (EXT1-PIN15) PIN15 ndash ATBTLC1000 Tx

MCU Secondary UARTTx

(EXT1-PIN14) (EXT1-PIN17) PIN17 ndash ATBTLC1000 Rx

MCU Secondary UARTRTS

(EXT1-PIN5) (EXT1-PIN16) PIN16 ndash ATBTLC1000 CTS

MCU Secondary UARTCTS

(EXT1-PIN6) (EXT1-PIN18) PIN18 ndash ATBTLC1000 RTS

Host Wake-up (EXT1-PIN9) (EXT1-PIN9) PIN9 ndash GPIO_MS1

GND (EXT1-PIN19) (EXT1-PIN19) PIN19 ndash GND

VCC (EXT1-PIN20) (EXT1-PIN20) PIN20 ndash VCC

Note 1 Chip enable is available on Pin 4 of revised ATBTLC1000 XPRO boards For identifying the revised

board refer to Figure 7-12 Only Primary USART is used for enabling the Hardware flow control on Secondary USART All the

communications happen through the secondary USART after enabling the Hardware flow control

For equivalent pin names of the respective platforms refer to the following documentsbull SAM L22 Xplained Pro User Guidebull SAM L21 Xplained Pro User Guidebull SAM D21 Xplained Pro User Guidebull SAM G55 Xplained Pro User Guidebull SAM 4S Xplained Pro User Guide

ATBTLC1000Appendix 2 - Hardware UART Flow Control Settings

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 38

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 39: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

141 Host Flow Control 4-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 4-Wire mode

Table 14-1 Host Flow Control 4-Wire Mode

Host MCU PinFunctionality ATBTLC1000 QFN ATBTLC1000-

MR110CA ModuleATBTLC1000-XR1100A

ATBTLC1000-ZR110CA Module

GPIO PIN 19 (CHIP_EN) PIN 17 (CHIP_EN) PIN 14 (CHIP_EN) PIN 30 (CHIP_EN)

GPIO PIN 24(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 20(AO_GPIO_0)

PIN 1 (AO_GPIO_0)

GPIO with IRQ PIN 17(GPIO_MS1)(1)

PIN 15(GPIO_MS1)(1)

PIN 12(GPIO_MS1)(1)

PIN 28(GPIO_MS1)(1)

UART-RX PIN 7 (LP_GPIO_3- UART TxD)

PIN 5 (LP_GPIO_3- UART TxD)

PIN 38(LP_GPIO_3 -UART TxD)

PIN 15 (LP_GPIO_3- UART TxD)

UART-RTS PIN 8 (LP_GPIO_8- UART CTS)

PIN 7 (LP_GPIO_8- UART CTS)

PIN 5 (LP_GPIO_8- UART CTS)

PIN 20 (LP_GPIO_8- UART CTS)

UART-TX PIN 6 (LP_GPIO_2- UART RxD)

PIN 4 (LP_GPIO_2- UART RxD)

PIN 37(LP_GPIO_2 -UART RxD)

PIN 14 (LP_GPIO_2- UART RxD)

UART-CTS PIN 9 (LP_GPIO_9- UART RTS)

PIN 8 (LP_GPIO_9- UART RTS)

PIN 6 (LP_GPIO_9- UART RTS)

PIN 21 (LP_GPIO_9- UART RTS)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

142 Host Flow Control 6-Wire ModeFollowing table provide the details of the pins that are required to be interfaced from the Host MCU to theATBTLC1000 when operating in Host Flow Control 6-Wire mode

Table 14-2 Host Flow Control 6-Wire Mode

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

GPIO - Chip enable PIN 19 (CHIP_EN) PIN 17 (CHIP_EN)

GPIO - Wake PIN 24 (AO_GPIO_0) PIN 20 (AO_GPIO_0)

GPIO with IRQ PIN 17 (GPIO_MS1)(1) PIN 15 (GPIO_MS1)(1)

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 39

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 40: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Host MCU Pin Functionality BTLC1000 QFN BTLC1000-MR110CA Module

UART_FL-RX PIN 12 (LP_GPIO_12 - UART TX) PIN 12(LP_GPIO_12 - UART TX)

UART_FL-RTS PIN 11 (LP_GPIO_11 - UART CTS) PIN 11 (LP_GPIO_11 - UART CTS)

UART_FL-TX PIN 13 (LP_GPIO_13 - UART RX) PIN 14 (LP_GPIO_13 - UART RX)

UART_FL-CTS PIN 10 (LP_GPIO_10 - UART RTS) PIN 10 (LP_GPIO_10 - UART RTS)

UART - RX PIN 7 (LP_GPIO_3 - UART TxD) PIN 5 (LP_GPIO_3 - UART TxD)

UART - TX PIN 6 (LP_GPIO_2 - UART RxD PIN 4 (LP_GPIO_2 - UART RxD)

Note 1 GPIO_MS_1 is the GPIO used in default example application as host wake-up pin This pin is

intended to be used by the ATBTLC1000 to wake the host MCU from sleep on event This pinselection is configurable from the host MCU application

ATBTLC1000Appendix 3 - Hardware Pin Mapping to Interface with Host MCU

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 40

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 41: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

15 Appendix 4 - Hardware Resources Used by BluSDK

151 Timer

Board BLE Library Timer 0 BLE Library Timer 1 Application Timer

SAM D21 XPro TC4 TC6 TC3

SAM G55 XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM 4S XPro TC0

(ID_TC1)

TC0

(ID_TC2)

TC0

(ID_TC0)

SAM L21 XPro TC0 TC2 TC4

SAM L22 XPro TC0 TC2 TC3

Note  Timer can be changed by the user

152 UART

Board 6-Wire Mode 4-Wire Mode

SAM D21 XPro SERCOM4 SERCOM0 SERCOM0

SAM 4S XPro Not Applicable USART1

SAM G55 XPro USART0 USART5 USART0

SAM L21 XPro SERCOM4 SERCOM0 SERCOM0

SAM L22 XPro SERCOM2 SERCOM3 SERCOM3

Note  The SERCOMs listed are based on UART available on evaluation board The customer canchange these SERCOMs as per their board configuration

153 GPIOFor controlling the ATBTLC1000 Wake-up pin and ATBTLC1000 Chip Enable pin refer to the pins used in Evaluation Kit Interface Details (Without Adapter Board)

ATBTLC1000Appendix 4 - Hardware Resources Used by BluSDK

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 41

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 42: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70This section describes the step by step procedure for installation of new Atmel Software Framework(ASF) into Atmel Studio 70

161 Installation Steps for VSIX File1 Click Tools gt Extensions and Updates

Figure 16-1 Start Page - Atmel Studio

2 Select ldquoAtmel Software Frameworkrdquo and click Uninstall on the Extension and Updates windowFigure 16-2 Extensions and Updates Window

3 Click Yes to uninstall the Atmel Software Framework

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 42

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 43: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Figure 16-3 Uninstall Atmel Software Framework

4 Click Tools gt Command PromptFigure 16-4 Command Prompt Installation

5 Install Command Prompt and type format vsixinstallerexe[vsix_path][filenamevsix and then click Yes in next dialog boxNote  For example vsixinstallerexe CATBTLC1000as-asf-vsix-70352-win32win32x86vsix

6 Click Install to continue the VSIX installation

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 43

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 44: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

Figure 16-5 VSIX Installer

7 Click Close and restart the Atmel Studio 70Figure 16-6 Installation Complete

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 44

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 45: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

162 External Interrupt (Host Wake-up)Any new event in the ATBTLC1000 board wakes up the MCU This wake-up happens from configuredexternal interrupt to receive the event For pin information refer to Evaluation Kit Interface Details(Without Adapter Board)

ATBTLC1000Appendix 5 - ASF Installation Instructions for Atmel Stud

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 45

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 46: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

17 Appendix 6 - Re-initializing the BluSDK librarySupport for re-initializing the Library is added in BluSDK v61 This support is added under symbolBTLC_REINIT_SUPPORT So by default the symbol is not enabled the user needs to enable by addingthis symbol into the project (IAR GCC Makefile Atmel Studio)

Figure 17-1 Re-initialization of BluSDK Library

ATBTLC1000Appendix 6 - Re-initializing the BluSDK library

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 46

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 47: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

The Microchip Web Site

Microchip provides online support via our web site at httpwwwmicrochipcom This web site is used asa means to make files and information easily available to customers Accessible by using your favoriteInternet browser the web site contains the following information

bull Product Support ndash Data sheets and errata application notes and sample programs designresources userrsquos guides and hardware support documents latest software releases and archivedsoftware

bull General Technical Support ndash Frequently Asked Questions (FAQ) technical support requestsonline discussion groups Microchip consultant program member listing

bull Business of Microchip ndash Product selector and ordering guides latest Microchip press releaseslisting of seminars and events listings of Microchip sales offices distributors and factoryrepresentatives

Customer Change Notification Service

Microchiprsquos customer notification service helps keep customers current on Microchip productsSubscribers will receive e-mail notification whenever there are changes updates revisions or erratarelated to a specified product family or development tool of interest

To register access the Microchip web site at httpwwwmicrochipcom Under ldquoSupportrdquo click onldquoCustomer Change Notificationrdquo and follow the registration instructions

Customer Support

Users of Microchip products can receive assistance through several channels

bull Distributor or Representativebull Local Sales Officebull Field Application Engineer (FAE)bull Technical Support

Customers should contact their distributor representative or Field Application Engineer (FAE) for supportLocal sales offices are also available to help customers A listing of sales offices and locations is includedin the back of this document

Technical support is available through the web site at httpwwwmicrochipcomsupport

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices

bull Microchip products meet the specification contained in their particular Microchip Data Sheetbull Microchip believes that its family of products is one of the most secure families of its kind on the

market today when used in the intended manner and under normal conditionsbull There are dishonest and possibly illegal methods used to breach the code protection feature All of

these methods to our knowledge require using the Microchip products in a manner outside theoperating specifications contained in Microchiprsquos Data Sheets Most likely the person doing so isengaged in theft of intellectual property

bull Microchip is willing to work with the customer who is concerned about the integrity of their code

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 47

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 48: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

bull Neither Microchip nor any other semiconductor manufacturer can guarantee the security of theircode Code protection does not mean that we are guaranteeing the product as ldquounbreakablerdquo

Code protection is constantly evolving We at Microchip are committed to continuously improving thecode protection features of our products Attempts to break Microchiprsquos code protection feature may be aviolation of the Digital Millennium Copyright Act If such acts allow unauthorized access to your softwareor other copyrighted work you may have a right to sue for relief under that Act

Legal Notice

Information contained in this publication regarding device applications and the like is provided only foryour convenience and may be superseded by updates It is your responsibility to ensure that yourapplication meets with your specifications MICROCHIP MAKES NO REPRESENTATIONS ORWARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED WRITTEN OR ORAL STATUTORYOR OTHERWISE RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ITSCONDITION QUALITY PERFORMANCE MERCHANTABILITY OR FITNESS FOR PURPOSEMicrochip disclaims all liability arising from this information and its use Use of Microchip devices in lifesupport andor safety applications is entirely at the buyerrsquos risk and the buyer agrees to defendindemnify and hold harmless Microchip from any and all damages claims suits or expenses resultingfrom such use No licenses are conveyed implicitly or otherwise under any Microchip intellectualproperty rights unless otherwise stated

Trademarks

The Microchip name and logo the Microchip logo AnyRate AVR AVR logo AVR Freaks BeaconThingsBitCloud CryptoMemory CryptoRF dsPIC FlashFlex flexPWR Heldo JukeBlox KeeLoq KeeLoq logoKleer LANCheck LINK MD maXStylus maXTouch MediaLB megaAVR MOST MOST logo MPLABOptoLyzer PIC picoPower PICSTART PIC32 logo Prochip Designer QTouch RightTouch SAM-BASpyNIC SST SST Logo SuperFlash tinyAVR UNIO and XMEGA are registered trademarks ofMicrochip Technology Incorporated in the USA and other countries

ClockWorks The Embedded Control Solutions Company EtherSynch Hyper Speed Control HyperLightLoad IntelliMOS mTouch Precision Edge and Quiet-Wire are registered trademarks of MicrochipTechnology Incorporated in the USA

Adjacent Key Suppression AKS Analog-for-the-Digital Age Any Capacitor AnyIn AnyOut BodyComchipKIT chipKIT logo CodeGuard CryptoAuthentication CryptoCompanion CryptoControllerdsPICDEM dsPICDEMnet Dynamic Average Matching DAM ECAN EtherGREEN In-Circuit SerialProgramming ICSP Inter-Chip Connectivity JitterBlocker KleerNet KleerNet logo Mindi MiWimotorBench MPASM MPF MPLAB Certified logo MPLIB MPLINK MultiTRAK NetDetach OmniscientCode Generation PICDEM PICDEMnet PICkit PICtail PureSilicon QMatrix RightTouch logo REALICE Ripple Blocker SAM-ICE Serial Quad IO SMART-IS SQI SuperSwitcher SuperSwitcher II TotalEndurance TSHARC USBCheck VariSense ViewSpan WiperLock Wireless DNA and ZENA aretrademarks of Microchip Technology Incorporated in the USA and other countries

SQTP is a service mark of Microchip Technology Incorporated in the USA

Silicon Storage Technology is a registered trademark of Microchip Technology Inc in other countries

GestIC is a registered trademark of Microchip Technology Germany II GmbH amp Co KG a subsidiary ofMicrochip Technology Inc in other countries

All other trademarks mentioned herein are property of their respective companies

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 48

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 49: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

copy 2017 Microchip Technology Incorporated Printed in the USA All Rights Reserved

ISBN

Quality Management System Certified by DNV

ISOTS 16949Microchip received ISOTS-169492009 certification for its worldwide headquarters design and waferfabrication facilities in Chandler and Tempe Arizona Gresham Oregon and design centers in Californiaand India The Companyrsquos quality system processes and procedures are for its PICreg MCUs and dsPICreg

DSCs KEELOQreg code hopping devices Serial EEPROMs microperipherals nonvolatile memory andanalog products In addition Microchiprsquos quality system for the design and manufacture of developmentsystems is ISO 90012000 certified

ATBTLC1000

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 49

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service
Page 50: ATBTLC1000 BluSDK v6.1 Release Notesww1.microchip.com/downloads/en/DeviceDoc/ATBTLC1000-BluSDK-v6… · Quality Management System Certified by DNV ... Alert Notification Profile Example

AMERICAS ASIAPACIFIC ASIAPACIFIC EUROPECorporate Office2355 West Chandler BlvdChandler AZ 85224-6199Tel 480-792-7200Fax 480-792-7277Technical SupporthttpwwwmicrochipcomsupportWeb AddresswwwmicrochipcomAtlantaDuluth GATel 678-957-9614Fax 678-957-1455Austin TXTel 512-257-3370BostonWestborough MATel 774-760-0087Fax 774-760-0088ChicagoItasca ILTel 630-285-0071Fax 630-285-0075DallasAddison TXTel 972-818-7423Fax 972-818-2924DetroitNovi MITel 248-848-4000Houston TXTel 281-894-5983IndianapolisNoblesville INTel 317-773-8323Fax 317-773-5453Tel 317-536-2380Los AngelesMission Viejo CATel 949-462-9523Fax 949-462-9608Tel 951-273-7800Raleigh NCTel 919-844-7510New York NYTel 631-435-6000San Jose CATel 408-735-9110Tel 408-436-4270Canada - TorontoTel 905-695-1980Fax 905-695-2078

Australia - SydneyTel 61-2-9868-6733China - BeijingTel 86-10-8569-7000China - ChengduTel 86-28-8665-5511China - ChongqingTel 86-23-8980-9588China - DongguanTel 86-769-8702-9880China - GuangzhouTel 86-20-8755-8029China - HangzhouTel 86-571-8792-8115China - Hong Kong SARTel 852-2943-5100China - NanjingTel 86-25-8473-2460China - QingdaoTel 86-532-8502-7355China - ShanghaiTel 86-21-3326-8000China - ShenyangTel 86-24-2334-2829China - ShenzhenTel 86-755-8864-2200China - SuzhouTel 86-186-6233-1526China - WuhanTel 86-27-5980-5300China - XianTel 86-29-8833-7252China - XiamenTel 86-592-2388138China - ZhuhaiTel 86-756-3210040

India - BangaloreTel 91-80-3090-4444India - New DelhiTel 91-11-4160-8631India - PuneTel 91-20-4121-0141Japan - OsakaTel 81-6-6152-7160Japan - TokyoTel 81-3-6880- 3770Korea - DaeguTel 82-53-744-4301Korea - SeoulTel 82-2-554-7200Malaysia - Kuala LumpurTel 60-3-7651-7906Malaysia - PenangTel 60-4-227-8870Philippines - ManilaTel 63-2-634-9065SingaporeTel 65-6334-8870Taiwan - Hsin ChuTel 886-3-577-8366Taiwan - KaohsiungTel 886-7-213-7830Taiwan - TaipeiTel 886-2-2508-8600Thailand - BangkokTel 66-2-694-1351Vietnam - Ho Chi MinhTel 84-28-5448-2100

Austria - WelsTel 43-7242-2244-39Fax 43-7242-2244-393Denmark - CopenhagenTel 45-4450-2828Fax 45-4485-2829Finland - EspooTel 358-9-4520-820France - ParisTel 33-1-69-53-63-20Fax 33-1-69-30-90-79Germany - GarchingTel 49-8931-9700Germany - HaanTel 49-2129-3766400Germany - HeilbronnTel 49-7131-67-3636Germany - KarlsruheTel 49-721-625370Germany - MunichTel 49-89-627-144-0Fax 49-89-627-144-44Germany - RosenheimTel 49-8031-354-560Israel - RarsquoananaTel 972-9-744-7705Italy - MilanTel 39-0331-742611Fax 39-0331-466781Italy - PadovaTel 39-049-7625286Netherlands - DrunenTel 31-416-690399Fax 31-416-690340Norway - TrondheimTel 47-7289-7561Poland - WarsawTel 48-22-3325737Romania - BucharestTel 40-21-407-87-50Spain - MadridTel 34-91-708-08-90Fax 34-91-708-08-91Sweden - GothenbergTel 46-31-704-60-40Sweden - StockholmTel 46-8-5090-4654UK - WokinghamTel 44-118-921-5800Fax 44-118-921-5820

Worldwide Sales and Service

copy 2017 Microchip Technology Inc Release Note WSGA-1881B-page 50

  • Description
  • Table of Contents
  • 1 BluSDK Software Architecture
  • 2 Supported Hardware Platforms and IDEs
  • 3 BluSDK Host Library Supported Architecture and Compilers
  • 4 BluSDK Release Contents
    • 41 BluSDK Firmware Contents
      • 5 BluSDK Firmware Contents
      • 6 BluSDK Release Features
      • 7 Release Revision History
        • 71 BluSDK v61
          • 711 Major New Features of BluSDK Software
          • 712 Major Improvements and Bug Fixes
            • 72 BluSDK v50
              • 721 Major New Features of BluSDK Software
              • 722 Major improvements and bug fixes
                • 73 BluSDK v40
                  • 731 Major New Features of BluSDK Software
                  • 732 Mobile Application
                  • 733 Adapter Library
                  • 734 Major Improvements and Bug Fixes
                    • 74 BluSDK v30
                      • 741 Major New Features of BluSDK Software
                      • 742 Mobile Application
                      • 743 Adapter Library
                      • 744 Documentation
                        • 75 BluSDK v23
                          • 751 Major New Features of BluSDK Software
                            • 76 BluSDK v22
                              • 761 Major New Features of BluSDK Software
                              • 762 Major Improvements and Bug Fixes
                                • 77 BluSDK v21
                                  • 771 Major New Features of BluSDK Software
                                  • 772 Major Improvements and Bug Fixes
                                    • 78 BluSDK v20
                                      • 781 Major New Features of BluSDK Software
                                      • 782 Mobile Application
                                      • 783 Major Improvements and Bug Fixes
                                        • 79 BluSDK v1x
                                          • 8 Known issues
                                          • 9 Limitations
                                            • 91 BluSDK Software
                                            • 92 Mobile Applications
                                              • 10 Additional InformationPre-requisites
                                              • 11 Power Save Measure Settings
                                                • 111 Hardware Setup
                                                  • 1111 Board Wiring
                                                  • 1112 Connection
                                                  • 1113 Troubleshooting (Optional)
                                                    • 112 Power Measure with Data Visualizer
                                                    • 113 Average Advertisement Current
                                                      • 12 Appendix 1 - Atmel BluSDK Change Log
                                                        • 121 BluSDK Module Changes
                                                        • 122 BLE Library API ndash New Features
                                                        • 123 Difference Between BLE APIs - BluSDK 61 versus BluSDK 50
                                                          • 13 Appendix 2 - Hardware UART Flow Control Settings
                                                            • 131 ATBTLC1000 Initialization
                                                            • 132 Evaluation Kit Interface Details (With Adapter Board)
                                                            • 133 Evaluation Kit Interface Details (Without Adapter Board)
                                                              • 14 Appendix 3 - Hardware Pin Mapping to Interface with Host MCU
                                                                • 141 Host Flow Control 4-Wire Mode
                                                                • 142 Host Flow Control 6-Wire Mode
                                                                  • 15 Appendix 4 - Hardware Resources Used by BluSDK
                                                                    • 151 Timer
                                                                    • 152 UART
                                                                    • 153 GPIO
                                                                      • 16 Appendix 5 - ASF Installation Instructions for Atmel Studio 70
                                                                        • 161 Installation Steps for VSIX File
                                                                        • 162 External Interrupt (Host Wake-up)
                                                                          • 17 Appendix 6 - Re-initializing the BluSDK library
                                                                          • The Microchip Web Site
                                                                          • Customer Change Notification Service
                                                                          • Customer Support
                                                                          • Microchip Devices Code Protection Feature
                                                                          • Legal Notice
                                                                          • Trademarks
                                                                          • Quality Management System Certified by DNV
                                                                          • Worldwide Sales and Service