7. Your First Application

This section describes how to construct, create, and run a straightforward software application using the instructions for DEVKT-P users. Two examples for DA14531 are provided in this chapter, one to test the output and show how it functions and the other to use the BLE functionality. Step-by-step instructions are provided for loading the example as a project in the Keil® environment, setting up and building the project, and then executing the project using the debug environment on the DA14531 devices.

Security in SDK6 Examples

The various projects in the Renesas SDK come with the BLE security disabled by default. During the development phase of a project, this helps debugging a custom application and making a wireless connection to the device. For a production version, Renesas is strongly advising to enable the security settings on the available BLE services. DA145xx Tutorial BLE Security and the SDK6 example project ble_app_security explain on how the different security levels can be applied.

Make sure that you have all required tools installed as described in Section 5 and Section 6. The DA14531 Software Development Kit (SDK) includes examples that run on the DEVKT-P. The examples are provided with preconfigured Keil® projects.

Build Options

The DA14531 examples are included in the same SDK as the DA14585/586. The examples have build options in the Keil® project for both DA14531 and DA14585 depending on which daughterboard is used. For more information, see the DA1453x DA14585/586 Software Platform Reference (UM-B-119).

7.1. The Blinky Peripheral Example Application

Blinky is a simple application that demonstrates the basic initialization of DA14531 and LED blinking. This is a good example to test the hardware, connection to PC and making sure the SDK is downloading correctly. After the SDK is downloaded, the blinky source code example is in the directory called peripheral_examples. The figure below shows the procedure of building the source code example for DA14531. The same process is applicable for the other chips in these families (DA1453x and DA1458x).

2-Wire UART Configuration for Blinky Project

Table and figure below show the configuration for the 2-wire UART while only need Tx wire.

Table 5 Blinky Example UART and LED Jumper Configuration for DA14531

GPIO

Function

Jumper

P0_6

UART2 TX (2 Wires)

Connect J1.17 - J2.27

P0_9

LED

Connect J8.3 – J8.4
../_images/2wire.svg

Figure 20 UART2 2-wire jumper configuration DA14531 PRO-Development kit

Single Wire UART

It is also possible to use single wire UART for this project. For more information about the configuration, see Appendices.

  1. Open the folder that has the SDK files. Figure 22 shows the folder with the extracted SDK zip file.

  2. In <sdk_root_directory>\projects\target_apps\peripheral_examples\blinky\Keil_5, double-click blinky.uvprojx to open the project in Keil®.

../_images/blinky_path.jpg

Figure 22 Blinky project directory

The development environment should look like the following figure when the project is opened with Keil®:

SDK6 Default Settings

These are the default settings on the latest SDK6 release. You do not need to make any change in the settings in this tutorial.

../_images/blinky_project_531.jpg

Figure 23 Blinky project Keil® workspace for DA14531

  1. Click the Target Options button, and then select the Device tab. The dialog window should look like Figure 25.

../_images/blinky_option.svg

Figure 25 Blinky project options

  1. Click the Linker tab. Scatter files (.sct) are used to select memory areas.

../_images/blinky_scatter.svg

Figure 26 Blinky project scatter file

  1. Click the Debug tab. Make sure that J-LINK/J-TRACE Cortex is selected and the Initialization File is correctly set to DA14531.ini.

../_images/blinky_linker.svg

Figure 27 Blinky project: Debug option

  1. Click the Settings button (in the top right of the “Debug” tab) and check the SW device is detected correctly.

The Serial Number (SN) should match the sticker on the bottom of the motherboard.

  1. Click OK to save the settings in both windows. All settings are now saved and you can continue to build the example.

  2. Press the F7 key to build the project or click the Build button:

../_images/blinky_built.jpg

Figure 30 Blinky project: Project building

  1. Make sure that you have a UART connection between your PC and the motherboard as shown in Figure 15. Find out what the COM port number is on your PC.

  2. Open Tera Term and select the same COM port that can be found in step 9, and click OK.

  3. In Tera Term, select Setup > Serial Port to configure the port as shown in Table 4.

  4. In Keil®, select Debug > Start/Stop Debug Session.

../_images/blinky_debug.jpg

Figure 32 Blinky project: Start debug session

  1. Press F5 or click the Run button to start code execution.

../_images/blinky_run.jpg

Figure 34 Blinky project: Code execution

When you see that the blinky message is displayed on your UART terminal screen and the orange LED is blinking, it means that you have successfully programmed and started the blinky program on the DA14531 Demo Board. The expected result on serial port can bee seen in the following figure:

../_images/blinky_blinky.jpg

Figure 35 Tera Term terminal

SPI Flash Programming

The whole application here is placed/executed in RAM. It can also use SPI Flash to download an image file (.hex or .bin). The SmartSnippets™ Toolbox can be used to download code and erase flash via Serial Wire Debug Port (SWD).You can find more information in Appendices.

7.2. The Barebone BLE Example Application

The Barebone BLE example application demonstrates basic BLE procedures such as advertising, connection, updating connection parameters, and implementation of the Device Information Service Server (DISS). For more information, see the Bluetooth SIG.

ble_app_all_in_one

It is important to pay attention that only DA14585/DA14586 and DA14535 devices are supported in the <sdk_root_directory>\projects\target_apps\ble_examples\ble_app_all_in_one project example.

  1. Open the folder with the SDK files. This is the folder where you extracted the SDK zip file.

  2. In <sdk_root_directory>\projects\target_apps\ble_examples\ble_app_barebone\Keil_5, double-click ble_app_barebone.uvprojx to open the project in Keil®.

../_images/barebone_path.jpg

Figure 36 Barebone BLE project directory

../_images/barebone_keil.jpg

Figure 37 Barebone BLE: Keil® Project layout

  1. To execute the code and run the example, repeat steps 3 to 14 in The Blinky Peripheral Example Application.

The barebone application does not use the UART (steps 9, 10, and 11 from Blinky can be skipped) and so the only jumpers required are those for the debugger interface as mentioned in Table 7.

  1. Use the SmartBond app to scan for, and connect to the DLG-BRBN app, see Figure 39.

../_images/barebone_scan.jpg

Figure 39 Using the SmartBond app to connect to the BLE application

Your BLE application is now running and advertising with the default advertiser string: DLG-BRBN.

Note

When you change the advertising name of your device and you leave the BD address the same, it will not show the update on your iPhone/iPad and not to connect to it anymore. It is easy to make your device forget about it. Follow some easy steps mentioned in the Apple Support Communities and your iPhone will not remember the Bluetooth device. If you change your mind, then you can pair the device as though it were new.

Bluetooth Device Address

When multiple devices use the same BD address in the same room test (close enough so both can be detected by the user’s Bluetooth explorer tool), it is highly recommended to change the BD address manually or use the static random address (advanced) to avoid any conflict. See DA145XX Tutorial BLE Advertising.

7.3. Troubleshooting

If there is any problem in connecting DEVKT-P Motherboard to the PC, here are some hints and possible solutions:

  • Make sure that your FTDI drivers are up to date. Drivers are available from the FTDI website

  • Use a different USB cable to rule out that a USB cable causes any issues

  • Connect the two elements to a different USB port on the host PC.

  • If you cannot see any blinky messages in your UART terminal and the LED is not blinking, check the UART and LED jumper configuration. See Table 9. The DA14531 has two different UART options: UART2 with 2 wires and UART2 with 1 wire.

  • If you cannot start a debug session, check the SWD debugger jumper configuration. See Table 7.

Table 7 Blinky Example SWD Debugger Jumper Configuration

JTAG

Function

Jumper

SWDIO

SWD IO

Connect J1.23 - J1.24

SWCLK

SWD CLK

Connect J1.21 - J1.22

  • Due to the limited number of pins on the DA14531, the P0_11 is shared with the SW_Trigger functionality. To get a capture on the SmartSnippets™ toolbox you must either remove J8[1-2] on the motherboard (you will not have SW_trigger functionality in this case), or assign the button to a different GPIO and wire it to J19[2] or J19[4].

Note

If none of these actions resolved the issue, please contact the Renesas Forums OR BLE wireless connectivity in the Renesas Engineering community.

7.4. What is the Next ?

This tutorial does not cover all the topics relevant to software development environments. It describes the first steps necessary to get started with the Pro Development Kit. The following links provide more information on DA14531: