ON Semiconductor RSL10 Getting Started

Previous Edition © 2018 “All Rights Reserved” Getting Started with RSL10 AND9697/D June 2019, Rev. P5

www.onsemi.com 2 Page 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Setting Up the Hardware and Software . . . . . . . . . . . . . . . . . . . . . . . . 5 2.1 Prerequisite Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 Connecting the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2.1 Preloaded Sample . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.3 Prerequisite Software . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3. Getting Started with the Eclipse-Based ON Semiconductor IDE . . . . . . . . . . . . . . . . 7 3.1 ON Semiconductor IDE and RSL10 CMSIS-Pack Installation Procedures . . . . . . . . . . 7 3.2 Building Your First Sample Application with the ON Semiconductor IDE . . . . . . . . . . 9 3.2.1 Launching the ON Semiconductor IDE. . . . . . . . . . . . . . . . . . . . 9 3.2.2 Importing the Sample Code . . . . . . . . . . . . . . . . . . . . . . . 9 3.2.3 Build the Sample Code. . . . . . . . . . . . . . . . . . . . . . . . 11 3.3 Debugging the Sample Code . . . . . . . . . . . . . . . . . . . . . . . .13 3.3.1 Debugging with the .elf File . . . . . . . . . . . . . . . . . . . . . . 13 3.3.2 Peripheral Registers View with the ON Semiconductor IDE . . . . . . . . . . . . 15 4. Getting Started with Keil . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 4.1 Prerequisite Software . . . . . . . . . . . . . . . . . . . . . . . . . .19 4.2 RSL10 CMSIS-Pack Installation Procedure . . . . . . . . . . . . . . . . . . .19 4.3 Building Your First Sample Application with the Keil uVision IDE . . . . . . . . . . . .20 4.3.1 Import the Sample Code . . . . . . . . . . . . . . . . . . . . . . . 21 4.3.2 Build the Sample Code. . . . . . . . . . . . . . . . . . . . . . . . 22 4.3.3 Debugging the Sample Code . . . . . . . . . . . . . . . . . . . . . . 23 4.3.3.1 Preparing J-Link for Debugging . . . . . . . . . . . . . . . . . . . 23 4.3.3.2 Debugging Applications . . . . . . . . . . . . . . . . . . . . . 23 5. Getting Started with IAR . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 5.1 Prerequisite Software . . . . . . . . . . . . . . . . . . . . . . . . . .25 5.2 RSL10 CMSIS-Pack Installation Procedure . . . . . . . . . . . . . . . . . . .25 5.3 Building Your First Sample Application with the IAR Embedded Workbench . . . . . . . .26 5.3.1 Import the Sample Code . . . . . . . . . . . . . . . . . . . . . . . 26 5.3.2 Building the Sample Code. . . . . . . . . . . . . . . . . . . . . . . 28 5.3.3 Debugging the Sample Code . . . . . . . . . . . . . . . . . . . . . . 29 5.3.3.1 Debugging Applications . . . . . . . . . . . . . . . . . . . . . 29 6. Advanced Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 6.1 Printf Debug Capabilities . . . . . . . . . . . . . . . . . . . . . . . . .32 6.1.1 Adding Printf Debug Capabilities . . . . . . . . . . . . . . . . . . . . 32 6.2 Debugging Applications that Do Not Start at the Base Address of Flash . . . . . . . . . .32 6.3 Arm Cortex-M3 Core Breakpoints . . . . . . . . . . . . . . . . . . . . . .33 6.4 Debugging with Low Power Sleep Mode . . . . . . . . . . . . . . . . . . . .33 6.4.1 Downloading Firmware in Sleep Mode. . . . . . . . . . . . . . . . . . . 40 Table of Contents

7.1 Folder Structure of the RSL10 CMSIS-Pack Installation . . . . . . . . . . . . . . . 41 7.2 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 7.2.1 Documentation Included with the CMSIS-Pack . . . . . . . . . . . . . . . . 41 7.2.2 Documentation in the documentation.zip File . . . . . . . . . . . . . . . . . 46 A. Migrating to CMSIS-Pack . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 A.1 Migrating an Existing Eclipse Project to the CMSIS-Pack Method . . . . . . . . . . . 48 A.2 Using the Latest RSL10 Firmware in a Previous Version of the Eclipse-Based IDE . . . . . . 49 B. Arm Toolchain Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 B.1 Basic Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 B.2 Configuring the Arm Toolchain in the ON Semiconductor IDE . . . . . . . . . . . . . 50 B.3 Additional Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 50

consumption in the industry. It is designed to be used in devices that require high performance and advanced wireless features, with minimal system size and maximized battery life. The RSL10 Software Development Kit (SDK) includes firmware, software, example projects, documentation, and development tools. The Eclipse-based ON Semiconductor Integrated Development Environment (IDE) is offered as a free download with optional support for Arm® Keil® Vision® and IAR Embedded Workbench®. Software components, device and board support information are delivered using the CMSIS-Pack standard. Standard CMSIS-Drivers for peripheral interfaces and FreeRTOS sample applications are supported. With the CMSIS-Pack standard, you can easily go beyond what is included in our software package and have access to a variety of generic Cortex-M software components. If you have existing RSL10 projects and have not used the RSL10 CMSIS-Pack before, see Appendix A, “Migrating to CMSIS-Pack” on page 48 for more information. The RSL10 SDK allows for rapid development of ultra-low power Bluetooth Low Energy applications. Convenient abstraction decouples user application code from system code, allowing for simple modular code design. Features such as FOTA (Firmware Over-the-Air) can easily be added to any application. Advanced debugging features such as support for SEGGER® RTT help developers monitor and debug code. Sample applications, from Blinky to ble_peripheral_server_bond and everything in between, help get software development moving quickly. An optional Bluetooth mesh networking CMSIS-Pack quickly enables mesh networking for any application. This document helps you to get started with the RSL10 SDK. It guides you through the process of connecting your RSL10 Evaluation and Development Board, installing an IDE and the CMSIS-Pack, configuring your environment, and building and debugging your first RSL10 application. NOTE: RSL10 contains a low power DSP processor core; see RSL10 LPDSP32 Software Package.zip for more information. 1.2 INTENDED AUDIENCE This manual is for people who intend to develop applications for RSL10. It assumes that you are familiar with software development activities. 1.3 CONVENTIONS The following conventions are used in this manual to signify particular types of information: monospace Commands and their options, file and path names, error messages, code samples and code snippets. mono bold A placeholder for the specified information. For example, replace filename with the actual name of the file. bold Graphical user interface labels, such as those for menus, menu items and buttons. italics File names and path names, or any portion of them.

2.1 Prerequisite Hardware The following items are needed before you can make connections: • RSL10 Evaluation and Development Board and a micro USB cable • A computer running Windows 2.2 CONNECTING THE HARDWARE To connect the Evaluation and Development Board to a computer: 1. Check the jumper positions: Ensure that the jumper CURRENT is connected and POWER OPTIONS is selected for USB. Also, connect the jumpers TMS, TCK and SWD. Finally, connect the headers P7, P8, P9 and P10 to 3.3 V, as highlighted in Figure 1. Figure 1. Evaluation and Development Board with Pins and Jumpers for Connection Highlighted 2. Once the jumpers are in the right positions, you can plug the micro USB cable into the socket on the board. The LED close to the USB connector flashes green during the first time plugging in, then turns a steady green once the process is finished.