background image

AND9697/D

ON Semiconductor

Windows is a registered trademark of Microsoft Corporation. Arm, Cortex, Keil, and uVision are registered trademarks of Arm Limited (or its subsidiaries) in the US and/or elsewhere. 
IAR and IAR Embedded Workbench are trademarks or registered trademarks of IAR Systems AB. All other brand names and product names appearing in this document are 
trademarks of their respective holders.

ON Semiconductor and the ON Semiconductor logo are trademarks of Semiconductor Components Industries, LLC dba ON Semiconductor or its subsidiaries in the United
States and/or other countries. ON Semiconductor owns the rights to a number of patents, trademarks, copyrights, trade secrets, and other intellectual property. A listing of ON
Semiconductor’s  product/patent  coverage  may  be  accessed  at 

www.onsemi.com/site/pdf/Patent-Marking.pdf

.  ON  Semiconductor  is  an  Equal  Opportunity/Affirmative  Action

Employer. This literature is subject to all applicable copyright laws and is not for resale in any manner.

The evaluation board/kit (research and development board/kit) (hereinafter the “board”) is not a finished product and is as such not available for sale to consumers. The board is
only  intended  for  research,  development,  demonstration  and  evaluation  purposes  and  should  as  such  only  be  used  in  laboratory/development  areas  by  persons  with  an
engineering/technical  training  and  familiar  with  the  risks  associated  with  handling  electrical/mechanical  components,  systems  and  subsystems.  This  person  assumes  full
responsibility/liability for proper and safe handling. Any other use, resale or redistribution for any other purpose is strictly prohibited.

The board is delivered “AS IS” and without warranty of any kind including, but not limited to, that the board is production-worthy, that the functions contained in the board will
meet  your  requirements,  or  that  the  operation  of  the  board  will  be  uninterrupted  or  error  free.  ON  Semiconductor  expressly  disclaims  all  warranties,  express,  implied  or
otherwise, including without limitation, warranties of fitness for a particular purpose and non-infringement of intellectual property rights.

ON Semiconductor reserves the right to make changes without further notice to any board.

You are responsible for determining whether the board will be suitable for your intended use or application or will achieve your intended results. Prior to using or distributing any
systems that have been evaluated, designed or tested using the board, you agree to test and validate your design to confirm the functionality for your application. Any technical,
applications or design information or advice, quality characterization, reliability data or other services provided by ON Semiconductor shall not constitute any representation or
warranty by ON Semiconductor, and no additional obligations or liabilities shall arise from ON Semiconductor having provided such information or services.

The  boards  are  not  designed,  intended,  or  authorized  for  use  in  life  support  systems,  or  any  FDA  Class  3  medical  devices  or  medical  devices  with  a  similar  or  equivalent
classification in a foreign jurisdiction, or any devices intended for implantation in the human body. Should you purchase or use the board for any such unintended or unauthorized
application, you shall indemnify and hold ON Semiconductor and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs, damages,
and expenses, and reasonable attorney fees arising out of, directly or indirectly, any claim of personal injury or death associated with such unintended or unauthorized use, even
if such claim alleges that ON Semiconductor was negligent regarding the design or manufacture of the board.

This  evaluation  board/kit  does  not  fall  within  the  scope  of  the  European  Union  directives  regarding  electromagnetic  compatibility,  restricted  substances  (RoHS),  recycling
(WEEE), FCC, CE or UL, and may not meet the technical requirements of these or other related directives.

FCC  WARNING  –  This  evaluation  board/kit  is  intended  for  use  for  engineering  development,  demonstration,  or  evaluation  purposes  only  and  is  not  considered  by  ON
Semiconductor to be a finished end product fit for general consumer use. It may generate, use, or radiate radio frequency energy and has not been tested for compliance with
the limits of computing devices pursuant to part 15 of FCC rules, which are designed to provide reasonable protection against radio frequency interference. Operation of this
equipment may cause interference with radio communications, in which case the user shall be responsible, at its expense, to take whatever measures may be required to correct
this interference.

ON Semiconductor does not convey any license under its patent rights nor the rights of others.

LIMITATIONS OF LIABILITY: ON Semiconductor shall not be liable for any special, consequential, incidental, indirect or punitive damages, including, but not limited to the costs
of requalification, delay, loss of profits or goodwill, arising out of or in connection with the board, even if ON Semiconductor is advised of the possibility of such damages. In no
event shall ON Semiconductor’s aggregate liability from any obligation arising out of or in connection with the board, under any theory of liability, exceed the purchase price paid
for the board, if any.

For more information and documentation, please visit 

www.onsemi.com

.

PUBLICATION ORDERING INFORMATION

LITERATURE FULFILLMENT:

Literature Distribution Center for ON Semiconductor
19521 E. 32nd Pkwy, Aurora, Colorado 80011 USA

Phone

: 303-675-2175 or 800-344-3860 Toll Free USA/Canada

Fax

: 303-675-2176 or 800-344-3867 Toll Free USA/Canada

Email

: orderlit@onsemi.com

N. American Technical Support

: 800-282-9855 Toll 

Free USA/Canada

Europe, Middle East and Africa Technical Support

Phone: 421 33 790 2910

ON Semiconductor Website: www.onsemi.com

Order Literature

: http://www.onsemi.com/orderlit

For additional information, please contact your local 
Sales Representative

Summary of Contents for RSL10

Page 1: ... SCILLC 2019 Previous Edition 2018 All Rights Reserved Getting Started with RSL10 AND9697 D June 2019 Rev P5 ...

Page 2: ... 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 Pa...

Page 3: ...k 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 ...

Page 4: ...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 ne...

Page 5: ...r 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 socke...

Page 6: ...ral Device with Server is on boards with a serial number higher than 1741xxxxx For more information about sample applications refer to the RSL10 Sample Code User s Guide 2 3 PREREQUISITE SOFTWARE Install the latest version of J Link It is available from the SEGGER website Make sure to run the J Link DLL updater as shown in Figure 2 to update the J Link DLL inside your IDE and confirm that the vers...

Page 7: ...ault C Program Files x86 ON Semiconductor IDE The release version and build number are stored in the REVISION text file at the root of the installed ON Semiconductor IDE To install the RSL10 CMSIS Pack 1 Download the RSL10 CMSIS Pack from www onsemi com RSL10 and save it in any temporary folder 2 Open the ON Semiconductor IDE and choose the desired location for your new workspace for example c wor...

Page 8: ... The RSL10 CMSIS Pack now appears in the list of installed packs In the Devices tab if you expand All Devices ONSemiconductor RSL10 Series you can see RSL10 listed there You can manage your installed packs in the Packs tab Expanding ONSemiconductor RSL10 makes the Pack Properties tab display the details of the RSL10 CMSIS Pack Figure 5 on page 9 illustrates what the Pack Manager perspective looks ...

Page 9: ...o start the IDE go to the Windows Start menu and select ON Semiconductor ON Semiconductor IDE 2 When you open the IDE for the first time you are prompted to select a workspace for the session The workspace is the work area for all your IDE projects 3 2 2 Importing the Sample Code Import the sample code as follows 1 In the Pack Manager perspective click on the Examples tab to list all the example p...

Page 10: ...de the blinky rteconfig file displays software components If you expand Device Libraries you can see the System library libsyslib and the Startup libcmsis components selected for blinky see Figure 7 on page 11 NOTE Sample projects are preconfigured with Release versions of RSL10 libraries which are distributed as object files In the RTE configuration you can switch to the Source variant to include...

Page 11: ... Blinky Example Project in the ON Semiconductor IDE 3 2 3 Build the Sample Code Follow these steps to build the sample code 1 Right click on the folder for blinky and click Build Project Alternatively you can select the project and click the hammer icon shown in Figure 8 ...

Page 12: ...re 9 Figure 9 Example of Build Output 3 The key resulting output in Project Explorer includes blinky hex HEX file for loading into Flash memory blinky elf Arm executable file run from RAM used for debugging blinky map map file of the sections and memory usage These files are shown in Figure 10 on page 13 NOTE You might need to refresh the project to see the three built output files To do so right ...

Page 13: ... elf File Debug the application using the elf file as follows 1 Within the Project Explorer right click on the blinky elf file and select Debug As Debug Configurations 2 When the Debug Configurations dialog appears right click on GDB SEGGER J Link Debugging and select New A new configuration for blinky appears under the GDB SEGGER heading with new configuration details in the right side panel 3 Ch...

Page 14: ...lash memory make sure you are using the J Link version specified in Section 2 3 Prerequisite Software on page 6 If you are having trouble downloading firmware because an application with Sleep Mode is on the Evaluation and Development Board see Section 6 4 1 Downloading Firmware in Sleep Mode on page 40 5 The ON Semiconductor IDE asks if you would like to open the Debug perspective Answer Yes and ...

Page 15: ...the path to the SVD file in the Debug session The following steps demonstrate how to configure and use the Peripheral Registers View with the Blinky application 1 Right click on the blinky elf file select Debug As Debug Configurations and open your configuration details set as described in Section 3 3 1 Debugging with the elf File on page 13 2 Change to the SVD Path tab and set the path to the rsl...

Page 16: ...d only registers are highlighted in green If you wish you can drag your Memory window and place it side by side with your source code view see Figure 15 on page 18 5 Select DIO and CLK in the peripherals window Now you can monitor the selected peripherals from the Monitors tab and switch between them To see or change the DIO register status choose DIO and expand the DIO DIO_DATA register in the Me...

Page 17: ...eripheral Registers View Perspective in Debug Session After Setting SVD Path 7 Click on the Value tab of the GPIO register to change the HIGH LOW state of GPIO6 as shown in Figure 15 You can observe that the LED DIO6 on your board changes its state ...

Page 18: ...Getting Started with RSL10 www onsemi com 18 Figure 15 Toggling RSL10 DIO Using the Peripheral Registers View ...

Page 19: ...k installer or click on the icon shown in Figure 16 Figure 16 Pack Installer Icon 2 Click on File Import select your pack file ONSemiconductor RSL10 version pack and click Open see Figure 17 version is the RSL10 version such as 2 2 347 Figure 17 Installing the RSL10 CMSIS Pack for the Keil Vision IDE 3 The IDE prompts you to read and accept our license agreement then installs the RSL10 CMSIS Pack ...

Page 20: ... tab display the details of the RSL10 CMSIS Pack Figure 19 on page 20 illustrates what the Pack Installer perspective looks like after installation Figure 19 Pack Installer after RSL10 CMSIS Pack is Installed in the Keil Vision IDE 4 3 BUILDING YOUR FIRST SAMPLE APPLICATION WITH THE KEIL UVISION IDE This section guides you through importing and building your first sample application named blinky T...

Page 21: ...py button to import it into your workspace see Figure 20 on page 21 Choose a destination folder for a copy of the sample code Figure 20 Pack Manager Perspective Examples Tab Sample projects are preconfigured with Release versions of RSL10 libraries which are distributed as object files For Keil System library libsyslib and Startup libcmsis are preconfigured with the Source variant so the source co...

Page 22: ...ple Code Build the sample code as follows 1 Right click on Target 1 and choose Rebuild all target files Alternatively you can use the icon shown in the Figure 22 Figure 22 Starting to Build a Project in the Keil Vision IDE 2 When the build is running the output of the build is shown in the Build Output view in the IDE as illustrated in Figure 23 ...

Page 23: ...ion 2 3 Prerequisite Software on page 6 4 3 3 2 Debugging Applications The IDE s debug configurations are already set in the CMSIS Pack To debug an application 1 Make sure the Evaluation and Development Board is connected to the PC via a micro USB cable 2 Select Debug Start Stop Debug Session or click the icon shown in Figure 24 Figure 24 Start Stop Debug Session Icon If you are having trouble dow...

Page 24: ...nfigurations are preconfigured for the sample applications in the IDE s CMSIS Pack Flash downloading through the Download icon Figure 26 or F8 is not supported for J Link in the IDE at this point The IDE may add support for this feature in future releases Figure 26 Download Button Not Supported for J Link ...

Page 25: ...he icon shown in Figure 27 Figure 27 Pack Installer Icon 3 Click on CMSIS Manager Import Existing Packs select your pack file ONSemiconductor RSL10 version pack and click Open see Figure 28 version is the RSL10 version such as 2 3 27 Figure 28 Installing the RSL10 CMSIS Pack for the IAR Embedded Workbench IDE 4 The IDE prompts you to read and accept the license agreement then installs the RSL10 CM...

Page 26: ...bedded Workbench CMSIS Manager after RSL10 CMSIS Pack is Installed 5 3 BUILDING YOUR FIRST SAMPLE APPLICATION WITH THE IAR EMBEDDED WORKBENCH This section guides you through importing and building your first sample application named blinky This application makes the LED DIO6 blink on the Evaluation and Development Board The procedure described in this section assumes that you have installed the SD...

Page 27: ...s Tab Sample projects are preconfigured with Release versions of RSL10 libraries which are distributed as object files For the IDE System library libsyslib and Startup libcmsis are preconfigured with the Source variant so the source code of those libraries is included directly in both CMSIS Manager and IDE windows see Figure 32 on page 27 and Figure 33 on page 28 Figure 32 RTE Configuration for th...

Page 28: ...xample Project in the IAR Embedded Workbench window 5 3 2 Building the Sample Code To build the sample code 1 Right click on the folder for blinky and choose Rebuild all Alternatively you can use the icon shown in Figure 34 Figure 34 Starting to Build a Project in the IAR Embedded Workbench ...

Page 29: ...executable file used for debugging blinky map map file of the sections and memory usage 5 3 3 Debugging the Sample Code 5 3 3 1 Debugging Applications IDE debug configurations are already set in the CMSIS pack To debug an application 1 Make sure the Evaluation and Development Board is connected to the PC via a micro USB cable 2 Select Project Download and Debug or click the icon shown in Figure 36...

Page 30: ...tion and Development Board see Section 6 4 1 Downloading Firmware in Sleep Mode on page 40 3 The application runs up to the first breakpoint in main You can press F5 or the Run icon as shown in Figure 38 multiple times to step through the code and observe that the LED changes its state when the application executes the function Sys_GPIO_Toggle LED_DIO To stop the debug session press the Stop icon ...

Page 31: ...ON Semiconductor www onsemi com 31 Figure 38 Debug Session in the IAR Embedded Workbench ...

Page 32: ...on about SEGGER RTT can be found in JLINK user manual at www segger com 6 1 1 Adding Printf Debug Capabilities To add printf debug capabilities over UART change the define in the app_trace h file to define RSL10_DEBUG DBG_UART and set the RSL10_DEBUG macro to DBG_UART A standard terminal program on a PC can be used to view the debug output To add RTT printf debug capabilities change the define in ...

Page 33: ...ink 6 4 DEBUGGING WITH LOW POWER SLEEP MODE Debugging applications that use sleep mode is a challenging task because the hardware debug logic and system clocks are powered down when the device goes to sleep Therefore the debug session cannot be kept alive between sleep cycles IMPORTANT You can use hardware breakpoints when using the debugger with the Arm Cortex M3 core but software breakpoints can...

Page 34: ...ion Figure 40 Continue_Application Function Perspective After Adding While Loop 3 Within the Project Explorer right click on the elf file and select Debug As Debug Configurations 4 When the Debug Configurations dialog appears create two debug sessions a Debug session that initiates restart and halts the target i Right click on GDB SEGGER J Link Debugging and select New A new configuration appears ...

Page 35: ...ON Semiconductor www onsemi com 35 Figure 41 Setting Reset Type in the Debug Configuration Session Figure 42 Startup Tab Debug Session that Initiates Restart ...

Page 36: ...reate another new debug configuration under the GDB SEGGER heading with new configuration details in the right panel ii Adjust the displayed values for your configuration then click on Apply see Figure 43 and Figure 44 on page 37 Figure 43 Debugger Tab Debug Session that Connects to the Running Target ...

Page 37: ...4 The default Reset type is set to 0 which only resets the Arm Cortex M3 core and leaves the device peripherals in a state where the J Link cannot reconnect By setting it to 1 you ensure that not only the Arm Cortex M3 core is reset but also all the peripherals If this does not work see Section 6 4 1 Downloading Firmware in Sleep Mode on page 40 for more ideas 5 Start the first debug session which...

Page 38: ...sion Perspective Before Starting Execution 6 Wait until the target enters Deep Sleep Mode At this point the debug connection is lost and even when the target is awake it cannot establish a connection with JTAG The following output is generated on the console see Figure 46 ...

Page 39: ...move all terminated targets see Figure 47 Figure 47 Terminate Targets Icon 8 After the target exits Deep Sleep Mode it is running in the infinite loop step 1 and we can connect to the running target by starting the second debug session see Figure 48 Note that the debugger is able to reattach to the running target and halt the processor after waking up from sleep ...

Page 40: ...e is not working try the following 1 Connect DIO12 to ground 2 Press the RESET button this restarts the application which pauses at the start of its initialization routine 3 Repeat step 2 above After successfully downloading blinky to flash memory disconnect DIO12 from ground and press the RESET button so that the application works properly Alternatively use the Stand Alone Flash Loader available ...

Page 41: ...arty documentation from other companies besides ON Semiconductor Available from the books tab in the IDE images Contains evaluation board pictures include Include files for the firmware components and libraries Projects can point to this directory and sub directories when including firmware header files lib Pre built libraries which can be linked to by sample code or other source code Project link...

Page 42: ...inky rteconfig and selecting the tab Device see Figure 49 on page 42 Keil Vision IDE documentation is available in the Books tab as shown in Figure 50 on page 43 IAR Embedded Workbench documentation is accessible through the IAR Embedded Workbench CMSIS Manager window as shown in Figure 51 on page 44 Figure 49 Accessing RSL10 Documentation from the ON Semiconductor IDE ...

Page 43: ...ON Semiconductor www onsemi com 43 Figure 50 Accessing RSL10 Documentation from the Keil Vision IDE ...

Page 44: ...on the configuration and use of the RSL10 Evaluation and Development Board When you use this board with the software development tools you can test and measure the performance and capabilities of the RSL10 radio SoC RSL10 Firmware Reference The system firmware provides functionality that isolates you from the hardware and implements complex but common tasks making it easier to support and maintain...

Page 45: ...ion RW BLE Device Information Service Interface Specification RW BLE Find Me Profile Interface Specification RW BLE Glucose Profile GLP Interface Specification RW BLE HID Over GATT Profile Interface Specification RW BLE Heart Rate Profile HRP Interface Specification RW BLE Health Thermometer Profile Interface Specification RW BLE Location and Navigation Profile Interface Specification RW BLE Phone...

Page 46: ... sample application ble_mesh demonstrates how to configure the project to set up different mesh network scenarios and how to experiment with them to verify their features and operations Files in the mindtree folder related to Bluetooth Low Energy Mesh networking EtherMind_Mesh_API chm EtherMind_Mesh_Application_Developer s_Guide_Generic pdf EtherMind_Mesh_CLI_User_Guide pdf RSL10 Bootloader Guide ...

Page 47: ...o LPDSP32 various tips for optimization to make the best use of the processor and compiler resources and certain things the programmers should be aware of when porting applications It also provides a few examples to show the usage of LPDSP32 intrinsic functions and to give an idea of how certain DSP functions can be ported to and optimized for LPDSP32 RSL10 Stand Alone Flash Loader Manual Provides...

Page 48: ... like to migrate For example if your existing application uses the Heart Rate Profile you might want to import the ble_peripheral_server_hrp sample application as a reference 2 Right click the project and rename it as you wish 3 Remove the source code from the sample project 4 Copy over the source and header files from your existing project into the new one 5 Open the RTE Configuration Wizard by d...

Page 49: ...a previous version of the Eclipse based IDE If this is your case try the following steps 1 Download the RSL10 SDK CMSIS Pack from www onsemi com RSL10 and save it in any temporary folder 2 Use a compressing tool such as 7 Zip and extract the contents of the ONSemiconductor RSL10 version pack file 3 Copy and replace the lib and include folders from the CMSIS Pack into your existing RSL10 SDK Instal...

Page 50: ... IDE if an Arm based toolchain has been installed elsewhere or already exists on the path and the IDE selects that toolchain rather than the one included in arm_tools B 2 CONFIGURING THE ARM TOOLCHAIN IN THE ON SEMICONDUCTOR IDE All toolchain location options can be accessed by right clicking on the project in the Project Explorer view selecting Properties at the bottom of the pop up menu and choo...

Page 51: ...h information or services The boards are not designed intended or authorized for use in life support systems or any FDA Class 3 medical devices or medical devices with a similar or equivalent classification in a foreign jurisdiction or any devices intended for implantation in the human body Should you purchase or use the board for any such unintended or unauthorized application you shall indemnify...

Reviews: