This document helps you to get started with the RSL10 SDK. It guides you through the process of connecting your hardware, installing the software with the option of applying the CMSIS-Pack, configuring your environment, and building and debugging your first RSL10 application.
CMSIS-Pack, as a practical introduction to using the SDK. • Chapter 5: Installing and Working with RSL10 Software for Keil describes the steps for importing the CMSIS-Pack for Keil, and explains how to build your first sample application.
CHAPTER 2 Connecting the Hardware 2.1 Prerequisites The following items are needed before you can make connections: • RSL10 Evaluation and Development Board and a USB to Micro-USB cable • A computer running Windows 2.2 C ONNECTING THE ARDWARE To connect the Evaluation and Development Board to a computer:...
LOCK_INFO_SETTING because in that case the system would require high VBAT to start. For more information about why this change is needed and how to do it, see the RSL10 Hardware Reference manual, in the section titled “IP Protection”. www.onsemi.com...
Check if the RSL10 SDK folder is still there; if it is, delete it. Install your new RSL10 SDK. The release version and build number are stored in the REVISION text file at the root of the installed RSL10 SDK software development tools.
Page 9
On the top right corner, click on the Open Perspective icon, select CMSIS Pack Manager, and click OK (see Figure 3). Figure 3. Opening the CMSIS-Pack Manager Perspective Click on the Import existing packs icon, select your pack file ONSemiconductor.RSL10. .pack, version where is a number such as 2.3.27, and click Open (see Figure 4).
Page 10
Figure 5. Reload Packs Icon 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.
Page 11
ON Semiconductor Figure 6. Pack Manager Perspective after RSL10 CMSIS-Pack is Installed For the next steps of working with a sample application, see Chapter 4, “Building Your First Sample Application in Eclipse” on page 12. www.onsemi.com...
To use the IDE for the first time, follow the steps below: To start the IDE, go to the Windows Start menu, and select ON Semiconductor > RSL10 SDK IDE. 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.
Page 13
ON Semiconductor Figure 7. Importing an Existing Project Click Next, and the Import Projects dialog appears. Select the Copy projects into workspace check box, as shown in Figure 8 on page 13. Figure 8. Import Projects Dialog Box www.onsemi.com...
Getting Started with RSL10 Browse to the folder blinky, as shown in Figure 9 on page 14, and click OK. The sample code is in the RSL10 installation directory (C:\Program Files (x86)\ON Semiconductor\RSL10 SDK by default) under source\samples Figure 9. Select a Project to Import On the Import Projects dialog, click Finish.
Page 15
Startup (libcmsis) components selected for blinky (see Figure 12 on page 16). 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 the source code of the library directly into your project (see Figure 12 on page 16).
Getting Started with RSL10 Figure 12. RTE Configuration for the Blinky Example Project in Eclipse IDE 4.3 B UILD THE AMPLE 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 13.
Page 17
ON Semiconductor Figure 13. Starting to Build a Project in Eclipse IDE When the build is running, the output of the build is shown in the Eclipse C/C++ Development Tooling (CDT) Build Console, as illustrated in Figure 14. Figure 14. Example of Build Output The key resulting output in Project Explorer includes: •...
Getting Started with RSL10 Figure 15. Output Files from Building a Sample Project NOTE: If the Eclipse IDE has trouble finding the GNU toolchain, it might be caused by having other GNU toolchains installed. See Appendix A, “Arm Toolchain Support” on page 38 for more information.
Page 19
Once the updates to the configuration are completed, make sure the Evaluation and Development Board is connected to the PC via a micro USB cable, and click Debug. J-Link automatically downloads the blinky sample code to RSL10’s flash memory. www.onsemi.com...
Page 20
Getting Started with RSL10 NOTE: If J-Link does not automatically write your program to RSL10’s flash memory, make sure you are using the J-Link version specified in Section 3.1, “Prerequisite Software” on page 8. IMPORTANT: If the preloaded sample “Peripheral Device with Sleep Mode” is currently on your board (see Section 2.2.1, “Preloaded Sample”...
Figure 17. Debug Perspective 4.4.2 Peripheral Registers View with RSL10 IDE The RSL10 IDE includes the EmbSysReg third party plugin, which can be used in a Debug session to visualize and modify RSL10 registers values. To configure the plugin, open Window > Preferences On the left panel, select C/C++ >...
Page 22
Figure 19. Opening the EmbSys Register View The EmbSys Registers view will open and display all the RSL10 peripheral registers. If you wish, you can drag the EmbSys registers window and place it side-by-side with your source code view (see Figure 20 on page 23) Expand and double click the DIO >...
4.5 F RSL10 SDK I OLDER TRUCTURE OF THE NSTALLATION By default, all files are installed in C:\Program Files (x86)\ON Semiconductor\RSL10 SDK, but you can choose to install the SDK anywhere. The subfolders are described in Table 1. www.onsemi.com...
Page 24
Hardware, firmware and software documentation in PDF format. Also 3rd-party documentation documentation from other companies besides ON Semiconductor. Available from Start a link in the menu. Full installation of Eclipse Oxygen version with GNU Arm plugins to support eclipse Arm Cortex-M3 processor processor development.
REREQUISITE OFTWARE The following software must be installed before adding the RSL10 CMSIS-Pack: Install Keil MDK from the Keil website: http://www2.keil.com/mdk5. To add a license, open the dialog File > Licence > Management and follow the instructions available from this link: https://www.keil.com/download/ license/.
Page 26
Figure 24. Refresh Pack after installation 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.
For more information about the sample applications, see the RSL10 Sample Code User’s Guide. 5.3.1 Import the Sample Code In the Pack installer, click on the Examples tab to list all the example projects included in the RSL10 CMSIS-Pack. Choose the example project called blinky, and click the Copy button to import it into your workspace (see Figure 26 on page 28).
Figure 26. 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 code of those libraries is included directly (see Figure 27 on page 28).
ON Semiconductor Figure 28. Starting to Build a Project in Keil IDE When the build is running, the output of the build is shown in the Build Output view in Keil, as illustrated in Figure 29. Figure 29. Example of Build Output The key resulting output in Project Explorer in Keil IDE includes: •...
Page 30
Getting Started with RSL10 Figure 30. Start/Stop Debug Session Icon IMPORTANT: If the preloaded sample “Peripheral Device with Sleep Mode” is currently on your board (see Section 2.2.1, “Preloaded Sample” on page 7 for help determining what your preloaded sample is), and you are having difficulty connecting to the board, do the following: Connect DIO12 to ground.
Page 31
ON Semiconductor Figure 31. Debug Session in Keil NOTE: Debug configurations are preconfigured for the sample applications in Keil CMSIS-Pack. Flash downloading through the Download icon (Figure 32) or F8 is not supported for J-Link in Keil at this point. Keil may add support for this feature in future releases.
5.4 F RSL10 CMSIS-P OLDER TRUCTURE OF THE NSTALLATION By default, your files are installed in a location like C:\Keil_v5\ARM\PACK\ONSemiconductor\RSL10. The subfolders are described in Table 2. Table 2. Installed Folders Contents Folder Root installation folder ON Semiconductor license agreement, revision file and pack description file.
Documentation. You can also access documentation through the documentation.zip file downloaded with this release of RSL10. If you added the RSL10 CMSIS-Pack to your Eclipse IDE, a set of documents is included. From your IDE, you can access the documents through the C/C++ perspective by opening any RTE configuration file, such as blinky.rteconfig, and selecting the tab Device (see Figure 33 on page 35).
Page 34
LPDSP32 Documentation The following documents are available in the RSL10_LPDSP32_Support.zip file: • RSL10 Getting Started with the LPDSP32 Processor, which provides an overview of the techniques involved when writing and integrating code for the LPDSP32 processor that is on RSL10.
Page 35
ON Semiconductor Figure 33. Accessing RSL10 Documentation from Eclipse www.onsemi.com...
SoC. RSL10 USB Dongle The RSL10 USB Dongle acts as a generic central Bluetooth low energy device so that you can develop applications for peripherals. It is designed to be used with the Bluetooth Low Energy Explorer, which allows developers to become familiar with developing, testing, and evaluating Bluetooth low energy devices.
Page 37
An introduction to our Bluetooth Mesh networking package, including how to use the sample application, installing the software, setting up your system and accessing the code files. See the RSL10 product page for more information such as data sheets, application notes, and videos. www.onsemi.com...
When the user starts the RSL10 SDK with the IDE.exe program (whose shortcut is located in Windows menu items), the arm_tools\bin directory is added to the path, to give Eclipse access to the toolchain installed with the RSL10 software tools.
Page 40
APPENDIX B Advanced Debugging If you want to debug an application that does not start at the first address of the flash memory (0x00100000), read on. For example, you might be debugging an application in RAM, or a flash memory application that has been placed in a different address.
Page 41
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...
Need help?
Do you have a question about the RSL10 and is the answer not in the manual?
Questions and answers