Microchip Technology SAM L10 Xplained Pro User manual

AN2722
Getting Started with the SAM L10/L11 Xplained Pro
Abstract
This application note aims at getting started with the Atmel® SAM L10 and SAM L11 ARM®Cortex®-M23
based microcontrollers using their respective Xplained Pro evaluation kits.
The Atmel SAM L10 and SAM L11 Xplained Pro evaluation kits are hardware platforms used to evaluate
the ATSAML10E16A and ATSAML11E16A microcontrollers.
Each kit is supported by the Atmel Studio Integrated development Platform, and provides an easy access
to the features of the microcontroller.
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 1

Table of Contents
Abstract........................................................................................................................... 1
1. Device Documentation.............................................................................................. 3
2. Obtain the SAM L10/SAM L11 Xplained Pro Evaluation Kit...................................... 4
3. Obtain the Tools.........................................................................................................6
4. Getting Started With SAM L10/SAM L11 Using Atmel Studio 7 and START.............7
4.1. Instructional Guide ...................................................................................................................... 7
5. Getting Started With SAM L11 Secure Solution Using Atmel Studio 7 and Start.... 13
5.1. SAM L11 Security Concept Overview........................................................................................ 13
5.2. Instructional Guide..................................................................................................................... 15
The Microchip Web Site................................................................................................ 38
Customer Change Notification Service..........................................................................38
Customer Support......................................................................................................... 38
Microchip Devices Code Protection Feature................................................................. 38
Legal Notice...................................................................................................................39
Trademarks................................................................................................................... 39
Quality Management System Certified by DNV.............................................................40
Worldwide Sales and Service........................................................................................41
AN2722
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 2

1. Device Documentation
Data Sheet
Web page: http://www.microchip.com/.
Document: SAM L10/L11 Family Data Sheet, which provides peripheral descriptions and electrical
characteristics.
Silicon Errata
Web page: http://www.microchip.com/.
Document: SAM L10/L11 Family Silicon Errata and Data Sheet Clarification.
AN2722
Device Documentation
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 3

2. Obtain the SAM L10/SAM L11 Xplained Pro Evaluation Kit
CURRENT
MEASUREMENT
HEADER
DEBUG USB
USER LED0
MCU CURRENT
MEASUREMENT
SELECT JUMPER
I/O CURRENT
MEASUREMENT
SELECT JUMPER
32KHZCRYSTAL
MIKROBUS HEADER
QTOUCH
BUTTON
EXTENSION 2 HEADER
EXTENSION 1 HEADER
CORTEX DEBUG HEADER
FOR EXTERNAL DEBUGGER
POWER
HEADER
SW0 USER BUTTON RESET BUTTON
ATSAML10E16A OR ATSAML11E16A
ATECC508A
X32 HEADER
Web page: http://www.microchip.com/.
To order the kit, accessMicrochip Direct
Documents:
• SAM L10/L11 Xplained Pro User Guide (.pdf)
• SAML10-Xplained-Pro_Design-Documentation (.zip)
• SAML11-Xplained-Pro_Design-Documentation (.zip)
Key Features:
• ATSAML10E16A-AU or ATSAML11E16A-AU microcontrollers
• One mechanical reset button
• One mechanical programmable button
• One QTouch® button
• One user LED (yellow)
• 32.768 kHz crystal
AN2722
Obtain the SAM L10/SAM L11 Xplained Pro Ev...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 4

• ATECC508A Crypto Authentication IC
• Two Xplained Pro extension headers
• One X32 header
• One mikroBUS header
• Embedded Debugger
– Auto-ID for board identification in Atmel Studio
– One status LED (yellow)
– One board power LED (green)
– Symbolic debug of complex data types including scope information
– Programming and debugging, including power measurements
– Data Gateway Interface: SPI, I2C, four GPIOs
– Virtual COM-port (CDC)
• Embedded current measurement circuitry with Atmel Data Visualizer support for data visualization
• USB powered
Tip: The SAM L10/SAM L11 Xplained Pro User's Guide describes how to power the kit, and it
also describes the detailed information on board components, extension interface and the
hardware guide.
AN2722
Obtain the SAM L10/SAM L11 Xplained Pro Ev...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 5

3. Obtain the Tools
Atmel Studio 7, which uses a GCC compiler, is the preferred IDE to get started with SAM L10/SAM L11
MCUs. Atmel START is the preferred user interface to generate the initial project. Any Atmel START
project can be used in Atmel Studio 7, IAR or KEIL IDEs.
Atmel Studio 7
•Web page: Atmel Studio
Document: Atmel Studio 7.0 web installer(.exe)
Atmel Studio 7 is the preferred IDE for developing and debugging firmware for SAM L10/SAM L11.
Atmel Start
•Web page: Atmel Start
Document: Atmel Start User's guide: Also, use the help menu from the interface.
Atmel Start enables users to select and configure software components and tailor embedded applications
in a usable and optimized manner.
AN2722
Obtain the Tools
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 6

4. Getting Started With SAM L10/SAM L11 Using Atmel Studio 7 and
START
Note: The following steps are described using the SAM L10 Xplained Pro as reference; however, the
same sequence can be performed using the SAM L11 Xplained Pro.
4.1 Instructional Guide
Follow these steps to start exploring the Atmel Xplained Pro platform:
1. Download Atmel Studio.
2. Install Atmel Studio.
3. Launch Atmel Studio.
AN2722
Getting Started With SAM L10/SAM L11 Using ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 7

4. Connect the kit to the PC using a micro-USB cable (Standard-A to Micro-AB).
When the Xplained Pro MCU kit is connected to the computer for the first time, the operating
system will install the software driver. The driver file supports both 32-bit and 64-bit versions of
Microsoft® Windows®XP, Windows Vista®, Windows 7, Windows 8 and Windows 10.
When the Xplained Pro MCU board is powered, the power LED (green) will glow and Atmel Studio
will auto-detect the specific Xplained Pro MCU and extension boards that might be connected.
Atmel Studio will provide links to relevant information, such as data sheets and kit documentation.
Note: The ATSAML10E16A and ATSAML11E16A devices are programmed and debugged by the
on-board embedded debugger, hence no external programmer or debugger tool is required.
Figure 4-1. Atmel Studio SAM L10/SAM L11 Xplained Pro Introduction
3© 2016 Atmel Corporation
AN2722
Getting Started With SAM L10/SAM L11 Using ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 8

5. Launch Atmel Start from Atmel Studio: File > New > Atmel Start Example Project, and then open
Atmel Start directly into Atmel studio.
Figure 4-2. Opening Atmel Start Example Project in Atmel Studio
4© 2016 Atmel Corporation
Atmel Start will load the existing example list.
6. Choose the example "LED Flasher" in the list, and then click Open Selected Example.
Figure 4-3. Atmel start SAM L1x Available Example List
5© 2016 Atmel Corporation
c
c
7. Choose either the SAM L10 or SAM L11 Xplained Pro Board, and then click Select board.
AN2722
Getting Started With SAM L10/SAM L11 Using ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 9

Figure 4-4. Board Selection
6© 2016 Atmel Corporation
AN2722
Getting Started With SAM L10/SAM L11 Using ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 10

8. Click GENERATE PROJECT to generate the project from Atmel Start. My "Software Components
Window" will be displayed.
Figure 4-5. Atmel Start Project Generation
9© 2016 Atmel Corporation
9. The following window will be displayed: Enter Project Name, Solution, Solution Name, and then
browse and choose a location for the project. Click OK to open the project in Atmel Studio.
Figure 4-6. Atmel Studio New Atmel Start Project Importation
10 © 2016 Atmel Corporation
The Atmel Studio will create the project.
AN2722
Getting Started With SAM L10/SAM L11 Using ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 11

10. Configure the Debugger/Programmer Interface by following these steps:
– Open the project properties: Project > Properties or <ALT+F7>.
– Click Tool.
– For the Selected debugger/programmer, choose "EDBG ATMLxxx".
– For the Interface, choose "SWD".
Figure 4-7. Programming Tool Selection
11 © 2016 Atmel Corporation
11. Compile and run the LED Flasher application.
– Build the project: Build > Build Solution or <F7>.
– Load the code into the SAM L10 Xplained Pro and start debugging: Debug > Start debugging
and break or <ALT+F5>.
– The application is programmed and the debugger breaks in main.
– Run the code: Debug > Continue or <F5>.
– The example runs out of the Xplained Pro target.
AN2722
Getting Started With SAM L10/SAM L11 Using ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 12

5. Getting Started With SAM L11 Secure Solution Using Atmel Studio 7
and Start
5.1 SAM L11 Security Concept Overview
Using the ATSAM L11 requires to be familiar with different security features and concepts that involve a
TrustZone® for ARMv8-M devices.
The TrustZone technology is a System-on-Chip (SoC) and MCU system-wide approach to security that
enables Secure and Non-Secure code to run on a MCU. It enables creating multiple software security
domains that restrict access to selected memory, peripherals, and I/O to trusted software without
compromising the system performances. The user can consider the following deployment approaches:
• Single-developer approach (Customer A)
• Dual-developer approach (Customer A+ Customer B)
The Single developer approach involves a unique developer (Customer A), which is in charge of the
following:
• Developing, deploying, and protecting the Secure code
• Developing and deploying the Non-Secure code
In the Dual-Developer approach, the first developer (Customer A) is in charge of developing the Secure
application and its associated Non-Secure callable library. The Secure Application must be loaded in the
SAM L11 NVM and protected.
A different developer (Customer B) will then start Non-Secured application development on a
preprogrammed SAM L11 with limited access to Secure resources (call to Non-Secure API only).
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 13

Figure 5-1. Single-Developer and Dual Developer Approaches
1
- Confidential – For Microchip internal use Only -
Microchip Developer
A End-User
Blank L11 Final Application
Microchip Developer
A
Developer
B End-User
Blank L11
Secure Pre-
programmed
L11 / Modules
Final Application
This document describes how to debug a solution composed of the following two projects:
• Secure Project
• Non-Secure Project
Note: Refer to the "SAM L11 Security Reference Guide" application note, which describes the security
features available in the Microchip SAM L11 microcontroller that fulfill the security requirement of most
embedded systems.
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 14

5.2 Instructional Guide
Follow these steps to explore the Atmel Xplained Pro platform:
1. Download Atmel Studio.
2. Install Atmel Studio.
3. Launch Atmel Studio.
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 15

4. Connect the DEBUG USB port on the kit to the PC using a micro-USB cable (Standard-A to Micro-
AB). When the Xplained Pro MCU kit is connected to the computer for the first time, the operating
system will install the software driver. The driver file supports 32-bit and 64-bit versions of
Microsoft® Windows®XP, Windows Vista®, Windows 7, Windows 8 and Windows10.
When the Xplained Pro MCU board is powered, the power LED (green) will glow. Atmel Studio will
auto-detect the specific Xplained Pro MCU and extension boards that are connected. Atmel Studio
will present relevant information, such as data sheets and kit documentation.
The ATSAML11E16A device is programmed and debugged by the on-board embedded debugger,
hence no external programmer or debugger tool is required.
Figure 5-2. Atmel Studio SAM L11 Xplained Pro Introduction
14 © 2016 Atmel Corporation
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 16

5. Launch Atmel Start from Atmel Studio to Open the Secure Application Project: File > New > Atmel
Start Example Project and then open Atmel Start into Atmel studio 7.
Figure 5-3. Open a New Atmel Start Example Project in Atmel Studio
4© 2016 Atmel Corporation
Note: After few seconds the example llist will be displayed.
6. Select the "TrustZone Getting Started Example" for the Secure Project (TZ-GetStart-S) from the
examples list, and then click OPEN SELECTED EXAMPLE.
Figure 5-4. TrustZone Getting started SAM L11 Secure Project Example Selection
16 © 2016 Atmel Corporation
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 17

7. Generate the project from Atmel Start to open it in Atmel Studio. Once the project is open, click
GENERATE PROJECT.
Figure 5-5. Atmel Start Secure Project Overview and Generation
17 © 2016 Atmel Corporation
8. The following "New Atmel Start Project" window will be displayed.
Figure 5-6. Secure Project Importation View
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 18

9. Modify the following project information:
– Enter a new Project Name.
– Click Browse to choose a location.
– For Solution: Create New Solution.
– For Solution Name, enter TrustZoneGettingStarted.
– Cick OK to open the project in Atmel Studio.
Figure 5-7. Modifying the Project Information
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 19

10. To see the project in the Atmel Studio Solution Explorer: View > Solution Explorer or <CTRL+ALT
+L>.
Figure 5-8. Atmel Studio Solution Explorer Showing Secure Project
19 © 2016 Atmel Corporation
Currently, the TrustZoneGettingStarted solution is only composed of the SecureProject.
AN2722
Getting Started With SAM L11 Secure Solution ...
© 2018 Microchip Technology Inc. Application Note DS00002722A-page 20