Dialog Semiconductor DA1468 series User manual

User Manual
DA1468x Getting Started with the
Development Kit
UM-B-047
Abstract
This guide is intended to help customers setup the hardware development environment, install
required software and download and run an example application on the DA1468x development
platform.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
2 of 36
© 2018 Dialog Semiconductor
Contents
Abstract................................................................................................................................................ 1
Contents............................................................................................................................................... 2
Figures.................................................................................................................................................. 3
Tables ................................................................................................................................................... 3
Codes.................................................................................................................................................... 3
1 Terms and definitions................................................................................................................... 4
2 References..................................................................................................................................... 4
3 Prerequisites.................................................................................................................................. 4
4 Introduction.................................................................................................................................... 5
5 DA1468x –The hardware.............................................................................................................. 6
5.1 The ProDK mainboard .......................................................................................................... 6
5.2 The ProDK daughter-boards................................................................................................. 6
5.3 Connecting the ProDK to the host PC .................................................................................. 7
6 DA1468x –Software Installation.................................................................................................. 8
6.1 Introduction ........................................................................................................................... 8
6.2 Requirements of the Development PC ................................................................................. 8
6.3 Driver installation................................................................................................................... 8
6.3.1 Microsoft Windows................................................................................................. 8
6.3.2 Linux ...................................................................................................................... 9
6.3.3 COM port usage .................................................................................................. 10
6.4 Configuring the serial port for UART1................................................................................. 10
6.4.1 Windows Host...................................................................................................... 10
6.4.2 Linux Host............................................................................................................ 12
6.5 Troubleshooting .................................................................................................................. 12
7 Software Development Tools..................................................................................................... 14
7.1 SmartSnippets™ Introduction ............................................................................................. 14
7.2 Installation........................................................................................................................... 14
7.2.1 Windows .............................................................................................................. 14
7.2.2 Linux .................................................................................................................... 20
7.3 Extracting and using the SDK............................................................................................. 25
7.4 Starting SmartSnippetsTM Studio....................................................................................... 26
7.5 Additional Software ............................................................................................................. 26
8 Your First DA1468x Application –Blinky.................................................................................. 27
8.1 Introduction ......................................................................................................................... 27
8.2 Software Architecture.......................................................................................................... 27
8.3 Software Build..................................................................................................................... 28
8.3.1 Build the project to run from RAM ....................................................................... 30
8.3.2 Build the project to run from QSPI Flash............................................................. 31
8.4 Running the project in the Debugger .................................................................................. 33
8.5 Troubleshooting .................................................................................................................. 34
Revision history................................................................................................................................. 35

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
3 of 36
© 2018 Dialog Semiconductor
Figures
Figure 1: The DA1468x ProDK.............................................................................................................. 6
Figure 2: The daughter-boards a) QFN60 and b) WLCSP to combine with the DA1468x ProDK
Development Kit .................................................................................................................................... 7
Figure 3: USB2 (DBG) connector.......................................................................................................... 7
Figure 4: Windows driver installation..................................................................................................... 8
Figure 5: Device Manager Ports............................................................................................................ 9
Figure 6: Ports assigned to ProDK........................................................................................................ 9
Figure 7: K2 RESET button in ProDK ................................................................................................. 11
Figure 8: Setting port and testing connectivity via RealTerm.............................................................. 11
Figure 9: Chip version in RealTerm in Windows................................................................................. 12
Figure 10: Chip version in PuTTY in Linux.......................................................................................... 12
Figure 11: Automatically install J-Link................................................................................................. 14
Figure 12: Select Smart Snippets Studio install directory ................................................................... 15
Figure 13: Tools that require manual installation ................................................................................ 15
Figure 14: Start Ozone download........................................................................................................ 16
Figure 15: Automatic Ozone download failed...................................................................................... 16
Figure 16: SEGGER Ozone download page....................................................................................... 17
Figure 17: Set Ozone installation directory ......................................................................................... 17
Figure 18: Set J-Link installation directory .......................................................................................... 18
Figure 19: SystemView Download fails............................................................................................... 18
Figure 20: Download SystemView installer......................................................................................... 19
Figure 21: Set SystemView installation directory................................................................................ 19
Figure 22: Automatically install J-Link................................................................................................. 20
Figure 23: Select Smart Snippets Studio install directory ................................................................... 21
Figure 24: Tools that require manual installation ................................................................................ 21
Figure 25: Start Ozone download........................................................................................................ 22
Figure 26: Automatic Ozone download failed...................................................................................... 22
Figure 27: SEGGER Ozone download page....................................................................................... 23
Figure 28: Set Ozone installation directory ......................................................................................... 23
Figure 29: Set J-Link installation directory .......................................................................................... 24
Figure 30: Download SystemView installer......................................................................................... 24
Figure 31: Set J-Link installation directory .......................................................................................... 25
Figure 32: Extract SDK to Workspace (on Windows) ......................................................................... 25
Figure 33: LED D2 on ProDK.............................................................................................................. 28
Figure 34: SmartSnippetsTM Studio welcome page........................................................................... 29
Figure 35: Project import..................................................................................................................... 29
Figure 36: Build Blinky in Release RAM configuration........................................................................ 30
Figure 37: Start Debug in RAM mode ................................................................................................. 31
Figure 38: Build Blinky in Release QSPI configuration ....................................................................... 31
Figure 39: Write Blinky to QSPI Flash................................................................................................. 32
Figure 40: Start Debug in QSPI mode................................................................................................. 32
Figure 41: Executing the Blinky project in Eclipse............................................................................. 33
Tables
Table 1: Parameters for connecting to UART1 ................................................................................... 10
Table 2: Troubleshooting Blinky.......................................................................................................... 34
Codes
Code 1: The main task in SysInit() the prvTemplateTask()................................................................. 27
Code 2: Set function for GPIO............................................................................................................. 28
Code 3: The main routine inside the prvTemplateTask().................................................................... 28

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
4 of 36
© 2018 Dialog Semiconductor
1 Terms and definitions
CLI Command Line Tool
COM Communication Port
DBG Debug
FTDI Future Technology Devices International
FTP File Transfer Protocol
GPIO General Purpose Input/Output
HW Hardware
IDE Integrated Development Environment
IRQ Interrupt Request
LED Light Emitting Diode
LLD Low-Level Driver
OPT One Time Programmable
OS Operating System
PC Personal Computer
RAM Random Access Memory
RTOS Real Time Operating System
SDK Software Development Kit
SoC System on Chip
SW Software
UART Universal Asynchronous Receiver/Transmitter
USB Universal Serial Bus
2 References
[1] DA14680, Datasheet, Dialog Semiconductor.
[2] UM-B-057-SmartSnippets_Studio_user_guide, User manual, Dialog Semiconductor.
[3] UM-B-056 DA1468x Software Developer's Guide, User manual, Dialog Semiconductor
[4] UM-B-044-DA1468x Software Platform Reference, User manual, Dialog Semiconductor
[5] UM-B-060-DA1468x_DA1510x Development kit –Pro, User manual, Dialog Semiconductor
[6] UM-B-083 SmartSnippets Toolbox, User manual, Dialog Semiconductor
[7] AN-B-046 DA1468x Booting from serial interfaces, Application Note, Dialog Semiconductor
[8] UM-B-094 DA14683 USB Kit, User manual, Dialog Semiconductor
3 Prerequisites
●SmartSnippetsTM Studio package
●Dialog’s Semiconductor SmartSnippets TM DA1468x SDK
●Operating System (Windows or Linux)
●Pro DK DA1468x and accessories
●Serial-port terminal software (e.g. RealTerm)
●A USB connection supporting USB-Serial (FTDI)

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
5 of 36
© 2018 Dialog Semiconductor
4 Introduction
The purpose of this guide is to provide an overview of the DA1468x ProDK Development Board and
describe the hardware and software setup needed for using the board. Finally, it guides the user
through the process of building and running a basic application called Blinky.
The following hardware and software elements are required to use the DA1468x Development Kit:
●The ProDK Development Kit
●SmartSnippetsTM Studio which can be installed on Windows or Linux hosts
●Windows users should download and install terminal software such as RealTerm, Putty or
Teraterm. The rest of the document uses RealTerm. Linux users can use Putty
The rest of the guide is organized as follows:
Section 5describes the hardware components and their initial installation and setup.
Sections 6and 7describe the installation of the SmartSnippetsTM DA1468x SDK software, along
with all necessary tools.
Section 8contains all steps for downloading and executing the Blinky application.
Note 1 If you are using the DA14683 USB Kit, please consult [8] for usage instructions and limitations that
may apply

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
6 of 36
© 2018 Dialog Semiconductor
5 DA1468x –The hardware
The Pro Development Kit (ProDK) consists of a main board (MB-PRO) and a daughterboard
featuring DA1468x SoC of the desired package (AQFN60 or WLCSP).
5.1 The ProDK mainboard
Figure 1 illustrates the physical layout of the ProDK. The two (2) daughter boards containing
DA1468x devices (AQFN60 as well as WLCSP packages) are shown in Figure 2.
The ProDK main board provides all necessary hardware to enable:
●Full functional verification of the DA1468x family of products with the ability to take precise power
measurements by isolating the DA1468x device.
●Full digital connectivity with external hardware using UART, SPI, I2C, quadrature encoder or
GPIOs.
●USB based debugging capabilities using the SEGGER J-Link on-board debugger.
●USB based UART communication with the host PC using a Future Technology Devices
International (FTDI) chipset which converts UART to USB.
For additional details regarding the DA1468x, please refer to [5] or contact Dialog Bluetooth Device
Forum.
Figure 1: The DA1468x ProDK
5.2 The ProDK daughter-boards
The ProDK mainboard can be combined with one of the two daughter-boards shown in Figure 2.
These daughter boards allow evaluation of the two different package options for the DA1468x
devices. The daughter-boards each have a switch to select the power supply for the device:

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
7 of 36
© 2018 Dialog Semiconductor
●USB port/charger input (USB1/CHG or USB2/DBG) which is marked VBAT or
●Coin cell battery which is marked VBAT. The coin cell battery can be either rechargeable or non-
rechargeable. To use a non-rechargeable coin cell battery the user must make sure that the
battery charger code is disabled in the project.
DA1468x –AQFN60 package
DA1468x –WLCSP package
Figure 2: The daughter-boards a) QFN60 and b) WLCSP to combine with the DA1468x ProDK
Development Kit
Note 3 Both daughter-boards are supported in the SmartSnippetsTM DA1468x SDK. More details on how to
set the build configuration for each board can be found in [3].
5.3 Connecting the ProDK to the host PC
The ProDK Development Kit allows functional verification of the DA1468x family of devices. It
supports connecting external hardware by exporting DA1468x pins to standard headers and enables
the user to do precise power measurements through the integrated power measurements circuitry.
Additionally, the ProDK mainboard includes an embedded J-Link debugger and an FTDI chipset
which allow easy communication with the development host over USB.
The ProDK Development Kit is connected to the host PC over the connector marked as USB2(DBG),
as shown in Figure 3 using a standard mini-USB cable. Before connecting the ProDK Development
Kit to the host PC, make sure that the mainboard and the desired daughterboard module are properly
connected and that the power switch on the daughterboard is in the VBAT position to select USB
from motherboard.
Additional information on the exact capabilities of each daughterboard can be found in [5].
Figure 3: USB2 (DBG) connector

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
8 of 36
© 2018 Dialog Semiconductor
6 DA1468x –Software Installation
6.1 Introduction
This Section describes the installation procedure for the drivers, the configuration of the serial port,
and all necessary steps to verify the connection with the PC as well as solutions to any problems that
may occur.
6.2 Requirements of the Development PC
For proper evaluation and application development using the DA1468x SoC and the ProDK an
external host is required. This external host must have an operating system already installed
(Windows or Linux) and USB ports as described in section 3.
Internet connectivity is also highly recommended for proper driver and software installation.
6.3 Driver installation
6.3.1 Microsoft Windows
On the first connection to a host PC which is running Microsoft Windows and has Internet
connectivity, the system will detect several devices and will automatically install all necessary drivers.
If the system is configured to use Windows Update, this process may need several minutes to be
finished.
Figure 4: Windows driver installation
After driver installation is successfully completed, the system will pop-up a window similar to the one
presented in Figure 4. Please note that the COM port number assigned to the newly attached ProDK
mainboard might be different than the one shown in Figure 4, where the assigned COM port numbers
are COM4 and COM5. The COM port number can be found in Device Manager (Control Panel >
Device Manager > Ports (COM & LPT)) as shown in Figure 5.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
9 of 36
© 2018 Dialog Semiconductor
Figure 5: Device Manager Ports
6.3.2 Linux
When ProDK is connected to a host PC running a Linux distribution (such as Ubuntu or CentOS) and
has Internet connectivity, the system will detect several devices and all necessary drivers will be
silently installed. Provided that the process has properly finished, two additional devices will appear
in the /dev directory under the names ttyUSB0 and ttyUSB1, as shown in Figure 6. These names
might be different in case other serial converters are connected to the system beforehand. If no other
serial port converters are connected, the device that should be used with the terminal or programmer
utility will be called /dev/ttyUSB0. If there are more devices with the name ttyUSBx, note which ones
showed up when the ProDK was connected and use the lower number of the two devices.
Figure 6: Ports assigned to ProDK

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
10 of 36
© 2018 Dialog Semiconductor
6.3.3 COM port usage
There are two virtual COM ports created by the driver with either Windows or Linux. The first (lower
number) is used to export a UART from the DA1468x device. In the previous sections this was either
COM4 or /dev/ttyUSB0. The second (higher number) is used to export measurement data from the
current sense circuitry on the ProDK [5] to the Power Profiler tool [6].
6.4 Configuring the serial port for UART1
Several development tools require UART1 to be routed to the FTDI serial port. Please refer to [5] for
details on how to properly configure the specific port. ProDK board connection verification can be
made using the pre-existing Terminal application.
6.4.1 Windows Host
On a Windows Host the utility RealTerm can be used to fully validate the connection to the ProDK
To make sure that the communication between the ProDK board and the development host is
properly established, it is necessary to verify the UART connection between the two nodes. To do so,
execute the following steps:
1. Connect the ProDK board to the PC board via USB cable to USB2(DBG) as described in
Paragraph 5.3 above.
2. Verify that the host discovered two serial ports –the first of which connected to UART1 (see
section 6.3.3).
3. Start a terminal software with HEX display capabilities (Figure 8, Reference points 2 and 3) (i.e.
RealTerm)
4. Open the serial port (Figure 8, Reference points 4 and 5) which corresponds to ProDK UART1
(i.e. COM4 for Windows), using the parameters shown in Table 1:
Table 1: Parameters for connecting to UART1
Settings
Values
Baud rate
57600
Data bits
8
Parity
None
Stop bits
1
Handshaking
None
5. Click K2 Reset button on the ProDK board as depicted in Figure 7. If terminal shows bytes (non-
printable characters) similar to those presented in Reference point 1 in Figure 8 on every reset
button push, the connection has been correctly setup and the programmer can be used
(sometimes other characters bytes can be sent). The sequence shows in Figure 8 is a
confirmation sequence corresponding to a correct setup confirmation. The sequence is generated
by the Bootloader [7] and corresponds to an ASCII string with the chip version.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
11 of 36
© 2018 Dialog Semiconductor
Figure 7: K2 RESET button in ProDK
Figure 8: Setting port and testing connectivity via RealTerm
Note 4 To verify the chip version user can select ASCII display option. After pushing and releasing the K2
reset button the chip version is printed four times, as shown in Figure 9.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
12 of 36
© 2018 Dialog Semiconductor
Figure 9: Chip version in RealTerm in Windows
6.4.2 Linux Host
Under Linux there is a simpler approach to validate the connection using a basic terminal such as
putty. Connect putty to /dev/ttyUSB0 at 57600 baud and press K2 Reset. There should be an output
as shown in Figure 10 which contains ASCII characters with the device name as well as non-ASCII
characters. This is enough to validate the connection to UART1.
Figure 10: Chip version in PuTTY in Linux
6.5 Troubleshooting
If there any problems with the ProDK connection to PC some possible solutions might be:
●Make sure that the Host PC is connected to Internet

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
13 of 36
© 2018 Dialog Semiconductor
●Make sure that no old FTDI drivers are installed
●Check for possible cabling issue by using a different USB cable
●Connect the two elements using a different USB port on the host PC
If none of these actions resolved the issue, please contact Dialog Software Forum.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
14 of 36
© 2018 Dialog Semiconductor
7 Software Development Tools
7.1 SmartSnippets™ Introduction
Dialog SmartSnippetsTM Studio is a royalty-free software development platform for Smartbond™
devices. It fully supports the DA1468x family of devices.
SmartSnippetsTM Studio contains:
●SmartSnippetsTM IDE: Eclipse CDT based IDE with pre-configured plugins to provide the
build/debug environment
●SmartSnippetsTM DA1468x SDK
●SmartSnippetsTM Toolbox: A tool suite covering all software development requirements,
including:
○Programming and loading of firmware into SRAM, OTP and Flash
○Power profiling
●SmartSnippetsTM Documentation
The SmartSnippetsTM IDE is enabled by an on-board J-Link debugger from SEGGER. This offers
standard debug capabilities such as single stepping, setting breakpoints, software download and
many more. For more details on the debugger capabilities, visit https://www.segger.com/ .
7.2 Installation
The installation procedure for SmartSnippetsTM Studio is described in detail in [2]. A summary of the
steps is given here. Download the Windows or Linux version of SmartSnippetsTM Studio from the
Software and Tools section of the DA14681 Product Dialog Support Website: https://support.dialog-
semiconductor.com/connectivity/product/da14681
7.2.1 Windows
SmartSnippetsTM Studio installer (.msi). Several of the required tools will automatically install and
others need to be manually downloaded and installed.
●Install the recommended version of SEGGER J-Link GDB server.
Figure 11: Automatically install J-Link

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
15 of 36
© 2018 Dialog Semiconductor
●Select the destination folder for the SmartSnippetsTM Studio.
Figure 12: Select Smart Snippets Studio install directory
●The installer will then check if the other required SEGGER tools are installed. On a clean PC they
will probably not be there and so the next steps are to download, install and point SmartSnippets
to them
Figure 13: Tools that require manual installation
●Tick the download and install radio button and then press Download button for SEGGER
Ozone tool

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
16 of 36
© 2018 Dialog Semiconductor
Figure 14: Start Ozone download
●The download will fail and so click on the link to manually download Ozone
Figure 15: Automatic Ozone download failed
●Using a browser download the latest version from
https://www.segger.com/downloads/jlink/#Ozone which at the point of writing was 2.52a and run
the installer.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
17 of 36
© 2018 Dialog Semiconductor
Figure 16: SEGGER Ozone download page
●This will install the tool to C:\Program Files\SEGGER\Ozone v2.52a. Use the Browse button to
find this folder and then press Next.
Figure 17: Set Ozone installation directory
●The next stage is to set the J-Link installation directory. This software is installed as part of
Ozone install and so it is only necessary to set the directory which should be C:\Program Files
(x86)\SEGGER\JLink_V512f.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
18 of 36
© 2018 Dialog Semiconductor
Figure 18: Set J-Link installation directory
●The final stage is to install SEGGER SystemView. The automatic download will fail so it must be
done manually
Figure 19: SystemView Download fails
●Using a browser download the latest SystemView installer from
https://www.segger.com/downloads/jlink/#SystemView . The latest version at the time of writing
was v2.52a.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
19 of 36
© 2018 Dialog Semiconductor
Figure 20: Download SystemView installer
●Run the installer which will install SystemView to C:\Program Files
(x86)\SEGGER\SystemView_V252a. Use Browse button to set this directory and then press
Finish.
Figure 21: Set SystemView installation directory
●SmartSnippetsTM Studio is now installed.

UM-B-047
DA1468x Getting Started with the Development Kit
User Manual
Version 7.0
23-Jul-2018
CFR0012
20 of 36
© 2018 Dialog Semiconductor
7.2.2 Linux
Before running the installer, it is necessary to install some Linux packages that are mandatory for the
execution of SmartSnippetsTM Studio. Without them SmartSnippetsTM Studio will not run correctly
but will fail with no reported error. More details are available in [2].
○For CentOS 7:
sudo yum install install epel-release
sudo yum install webkitgtk.x86_64
sudo yum install glibc.i686 ncurses-libs.i686
sudo yum install qt-x11 (required for SystemView tool)
○For Fedora 25:
sudo yum install webkitgtk.x86_64
sudo yum install glibc.i686 ncurses-libs.i686
sudo yum install gcc-c++
sudo yum install libncurses.so.5
○For Ubuntu 16.04.1 install:
sudo apt-get install libz1:i386 libncurses5:i386 libbz2-1.0:i386
sudo apt-get install libwebkitgtk-1.0-0 libwebkitgtk-3.0-0
sudo apt-get install gawk
●The first step is to make the SmartSnippetsTM Studio installer executable.
●$chmod a+x SmartSnippets_Studio-linux.gtk.x86_64-1.6.3.run
●And then run it.
●$./SmartSnippets_Studio-linux.gtk.x86_64-1.6.3.run
●Several of the required tools will automatically install and others need to be manually downloaded
and installed.
●Install the recommended version of SEGGER J-Link GDB server.
Figure 22: Automatically install J-Link
●Select the destination folder for the SmartSnippetsTM Studio.