4. Running The Demonstration Example

This section describes the steps required to prepare the Pro DevKit and other tools to successfully run the example code. A serial terminal, a breadboard, a few jumper wires and a potentiometer (POT) are required for testing and verifying the code. If you are not familiar with the recommended process on how to clone a project or configure a serial terminal, read the Starting a Project tutorial.

4.1. Verifying with a Serial Terminal

  1. Establish a connection between the target device and your PC through the USB1 port of the motherboard. This port is used both for powering and communicating to the DA1469x SoC. For this tutorial a Pro DevKit is used.

  2. Import and then make a copy of the freertos_retarget sample code found in the SDK of the DA1469x family of devices.

Note

It is essential to import the folder named python_scripts to perform various operations (including building, debugging, and downloading).

  1. In the newly created project and under the project’s /config folder you should create the following three files: platform_devices.c, platform_devices.h and peripheral_setup.h.

'Creating new files'

Figure 7 Creating New Files

  1. Place the project’s /config folder in the compiler’s include path. To do this, select Project > Properties > C/C++ Build > Settings > Tool Settings > Cross ARM C Compiler > Includes and click on the Add… icon (1.6).

'Include New Folder 1'

Figure 8 Add the New Folder to the Include Search Path

In the Add directory path window, click Workspace… and specify the path of the folder. It will be displayed in the Directory section. Click OK and then click OK in the previously opened window (1.7).

'Include New Folder 2'

Figure 9 Input New Folder Name

  1. Make sure the compiler does not generate errors instead of warnings. To do this, select Project > Properties > C/C++ Build > Settings > Tool Settings > Warnings and deselect the corresponding tick box. Finally, click OK.

'Configure Compiler's Warnings'

Figure 10 Configure Compiler’s Warnings

  1. In the target application, add/modify all the required code blocks as illustrated in the Code Overview section.

Note

It is possible for the defined macros not to be taken into consideration instantly. Hence, resulting in errors during compile time. If this is the case, the easiest way to proceed with is to: right-click on the application folder, select Index > Rebuild and then Index > Freshen All Files.

  1. Build the project either in Debug_QSPI or Release_QSPI mode and burn the generated image to the chip.

  2. Connect the potentiometer to the Pro DevKit. For this demonstration, a simple 3-terminal potmeter has been selected. Two terminals are connected to the main power source, that is 3.3 V and GND, and the third to the selected ADC pin on Pro DevKit, that is P0_25.

  3. Press the RESET button on Pro DevKit to start the chip executing its firmware.

  4. Open a serial terminal (115200, 8-N-1) and press the K1 button on Pro DevKit. A debugging message is displayed on the console indicating the status of the current GPADC operation as well as the result of the analog-to-digital conversion.

'Debugging messages for the various analog-to-digital operations'

Figure 11 Debugging Messages for the Various Analog-to-Digital Operations

  1. Change the input voltage level of the P0_25 pin by rotating the potentiometer position both right and left. Press the K1 button again and observe the new results on the serial console.