Dialog Semiconductor DA1468 series Bedienungsanleitung

Company Confidential

User Manual

DA1468x Mesh SDK

UM-B-098

Abstract

This document provides basic guidelines for developers and kit users to get familiar with the

DA1468x Mesh SDK and to modify or create a BLE Mesh application based on it.

 
 
UM-B-098 
 
DA1468x Mesh SDK 
Company Confidential 
User Manual 
Revision 1.2 
1-April-2019 
CFR0012 
of 47 
© 2019 Dialog Semiconductor 
Contents 
Abstract................................................................................................................................................ 1 
Contents............................................................................................................................................... 2 
Figures.................................................................................................................................................. 3 
Terms and Definitions................................................................................................................... 5 
References..................................................................................................................................... 5 
Introduction.................................................................................................................................... 7 
Features and Highlights ............................................................................................................... 7 
Getting Started: Running the Demo Application ....................................................................... 8 
1 Description ............................................................................................................................ 8 
2 Connecting Hardware and Powering On .............................................................................. 9 
3 Button and LED Usage ......................................................................................................... 9 
3.1 Buttons and Switches............................................................................................ 9 
3.2 LEDs...................................................................................................................... 9 
4 Mesh SDK Demo Examples Bring up................................................................................. 10 
4.1 Mobile Application Instructions............................................................................ 10 
5 Various SDK Example Demonstrations.............................................................................. 19 
5.1 Generic ON/OFF Model Demonstration.............................................................. 19 
5.2 Generic Level Model Demonstration................................................................... 19 
5.3 Light HSL Model Demonstration.......................................................................... 19 
5.4 Generic ON/OFF Model with Multiple Elements Demonstration......................... 19 
5.5 Vendor Specific Model Demonstration ................................................................ 20 
5.6 Provisioner Example Demonstration ................................................................... 20 
5.7 Proxy Example Demonstration............................................................................ 20 
5.8 Relay Example Demonstration............................................................................ 21 
5.9 Friend and Low Power Node Example Demonstration ....................................... 21 
5.10 SW Upgrade Over The Air (SUOTA) Support..................................................... 22 
5.11 Microbus Devices Example Demonstration......................................................... 22 
Development Environment Setup.............................................................................................. 24 
1 Installing the Environment................................................................................................... 24 
2 Importing and Building the BLE Mesh Project .................................................................... 24 
2.1 Build project for DA14681.................................................................................... 25 
3 Flashing New Software into the SDK.................................................................................. 25 
4 Modify the Bluetooth Address and Mesh Device UUID ...................................................... 27 
5 Specify the Role of a Device............................................................................................... 27 
6 Debugging the Application.................................................................................................. 27 
7 Obtaining Logging Information............................................................................................ 29 
7.1 UART Logging Window ....................................................................................... 29 
8 Developing on Linux Host OS............................................................................................. 29 
9 Developing on MacOS........................................................................................................ 30 
10 Understanding Serial Terminal Options.............................................................................. 30 
10.1 Reset the Accessory............................................................................................ 31 

 
 
UM-B-098 
 
DA1468x Mesh SDK 
Company Confidential 
User Manual 
Revision 1.2 
1-April-2019 
CFR0012 
3 of 47 
© 2019 Dialog Semiconductor 
6.10.2 Reset to Factory Default State ............................................................................ 32 
6.10.3 Enabling or Disabling Mesh Features (Proxy/Relay/Friendship)......................... 32 
6.10.4 Security Keys Dump Function ............................................................................. 32 
6.10.5 Monitor FreeRTOS Heap Usage and Task Stack Usage.................................... 33 
6.10.6 Change Log Level................................................................................................ 33 
6.10.7 Change Default TTL Value Used when Sending Messages ............................... 33 
6.10.8 Change Maximum BLE RF Range to around Two Meters.................................. 33 
6.10.9 Commands Related to Friendship and Low Power Node ................................... 34 
6.10.10 Modify the Subscription Address List of a Server Model..................................... 34 
6.10.11 Modify the Publish Address of a Client Model..................................................... 35 
6.10.12 Change Client Model State using the UART Console......................................... 35 
6.10.13 Change Provisioning Bearer................................................................................ 36 
6.10.14 Scan for Unprovisioned Devices ......................................................................... 36 
6.10.15 Start Provision for Selected Device..................................................................... 36 
6.10.16 Start Configuration for Selected Node................................................................. 36 
6.11 Using the SEGGER SystemView........................................................................................ 37 
7 Software Architecture................................................................................................................. 40 
7.1 BLE Mesh Specification...................................................................................................... 40 
7.2 DA14683 Mesh SW Architecture ........................................................................................ 40 
7.2.1 Overview.............................................................................................................. 40 
7.2.2 Mesh DK SW Architecture................................................................................... 41 
7.2.2.1 Folder and File Structure................................................................. 42 
7.2.2.2 The user_<onoff/level/hsl>_<server/client>_example Files .. 42 
7.2.2.3 The appl_proxy.c File .................................................................... 43 
7.2.2.4 The appl_provision.c file.............................................................. 43 
7.2.2.5 The appl_conf.c file ....................................................................... 43 
7.2.2.6 The demo_hw.c file........................................................................... 43 
7.2.2.7 The appl_storage.c file.................................................................. 43 
7.2.2.8 The mesh_console.c file.................................................................. 44 
Revision History ................................................................................................................................ 45 
Figures 
Figure 1: DA14683 USB Development Kit ............................................................................................ 8 
Figure 2: DA1468x PRO Development Kit, Motherboard and Daughterboard ..................................... 8 
Figure 3: DA1468x Basic Development Kit ........................................................................................... 9 
Figure 4: Start Dialog's BLE Mesh App............................................................................................... 11 
Figure 5: Create A Group in the Mesh Tab ......................................................................................... 11 
Figure 6: Name the Group................................................................................................................... 12 
Figure 7: Power the Board Programmed as a Light............................................................................ 12 
Figure 8: Provision a new device ........................................................................................................ 13 
Figure 9: Complete the provisioning process...................................................................................... 13 
Figure 10: Nodes screen..................................................................................................................... 14 
Figure 11: Settings, publish and subscribe configuration screens...................................................... 14 
Figure 12: Select the Nodes Tab......................................................................................................... 15 
Figure 13: Light Node screen.............................................................................................................. 15 

 
 
UM-B-098 
 
DA1468x Mesh SDK 
Company Confidential 
User Manual 
Revision 1.2 
1-April-2019 
CFR0012 
4 of 47 
© 2019 Dialog Semiconductor 
Figure 14: Configuration Tab............................................................................................................... 16 
Figure 15: Nodes screen containing both switch and light node......................................................... 16 
Figure 16: Toggle Light Bulb States by SW1...................................................................................... 17 
Figure 17: The group screen............................................................................................................... 17 
Figure 18: Red LED on Light Bulb Board Turned on .......................................................................... 18 
Figure 19: Microbus 7-Segment Display and Slider Modules............................................................. 23 
Figure 20: Build Configurations of ble_mesh Project in SmartSnippets™ Studio ............................... 24 
Figure 21: Build Log of ble_mesh Project in SmartSnippets™ Studio................................................. 25 
Figure 22: Writing the generated Image into the flash ........................................................................ 26 
Figure 23: Writing the generated Image into the flash: Log Output .................................................... 26 
Figure 24: Debug Configurations ........................................................................................................ 27 
Figure 25: Eclipse Debug Perspective ................................................................................................ 28 
Figure 26: UART Logging Window...................................................................................................... 29 
Figure 27: Verifying the Correct J-Link Version................................................................................... 37 
Figure 28: SEGGER SystemView Capture Settings........................................................................... 38 
Figure 29: SEGGER SystemView Trace Capture............................................................................... 39 
Figure 30: SystemView Trace - Task Switching.................................................................................. 41 
Figure 31: Mesh DK SW Architecture ................................................................................................. 41 
Figure 32: SW Stack and File Location............................................................................................... 42 
 

UM-B-098

DA1468x Mesh SDK

Company Confidential

User Manual

Revision 1.2

1-April-2019

CFR0012

5 of 47

1 Terms and Definitions

ADV Advertising

ATT ATTribute Protocol

BLE Bluetooth Low Energy

CPU Central Processing Unit

DIS Device Information Service

DK Development Kit

FW Firmware

GATT Generic ATTribute Profile

GDB GNU Debugger

HSL Hue Saturation Level

HW Hardware

iOS iPhone Operating System (Apple)

IDE Integrated Development Environment

LED Light Emitting Diode

LPN Low Power Node

LTK Long Term Key

MACOS Macintosh Operating System (Apple)

PCB Printed Circuit Board

PTS Profile Tuning Suite

RF Radio Frequency

SDK Software Development Kit

SIG (Bluetooth) Special Interest Group

SRP Secure Remote Password (protocol)

SUOTA Software Upgrade Over the Air

SW Software

SWD Serial Wire Debug

TLL Time-to-Live

USB Universal Serial Bus

UUID Universally Unique Identifier

2 References

[1] Mesh_Model_Specification v1.0.pdf

[2] Mesh Device Properties v1.0.pdf

[3] Mesh_v1.0.pdf

[4] Mesh Technology Overview.pdf

[5] WGS17_Group Updates Main Deck.pdf

[6] Dialog-BLE-Mesh-Training.ppt

[7] UM-B-060, DA1468x/DA1510x Development kit Pro Hardware, User Manual, Dialog

Semiconductor

[8] UM-B-057, SmartSnippets™ Studio User Guide, User Manual, Dialog Semiconductor

[9] UM-B-066, DA1468x Development Kit Basic, User Manual, Dialog Semiconductor

UM-B-098

DA1468x Mesh SDK

Company Confidential

User Manual

Revision 1.2

1-April-2019

CFR0012

6 of 47

[10] UM-B-047, DA1468x Getting Started with the Development Kit, User Manual, Dialog

Semiconductor

[11] UM-B-056, DA1468x Software Developer's Guide, User Manual, Dialog Semiconductor

[12] AN-B-037, DA1468x Power Measurements, Application Note, Dialog Semiconductor

[13] UM-B-094, DA14683 USB Kit, User Manual, Dialog Semiconductor

[14] UM-B-044, DA1468x Software platform reference, User Manual, Dialog Semiconductor

UM-B-098

DA1468x Mesh SDK

Company Confidential

User Manual

Revision 1.2

1-April-2019

CFR0012

7 of 47

3 Introduction

This document provides basic guidelines for developers and kit users to get familiar with the

DA1468x Mesh SDK and to modify or create a BLE Mesh application based on it.

The reference implementation is tested against the latest profile tuning suite (PTS) tool from the

Bluetooth Special Interest Group (SIG) and is under certification for BLE Mesh v1.0 specification.

Users are expected to have some basic understanding about the BLE Mesh protocol

(http://blog.bluetooth.com/introducing-bluetooth-mesh-networking).

4 Features and Highlights

■Supports Bluetooth BLE Mesh v1.0 specification [1]

□Provisioning over generic attribute profile (GATT) and advertising (ADV) bearer

□Support for all Mesh SIG defined models except sensor and time model

□Support for Vendor Specific Mesh models

□Support for Relay, Proxy, Friend, and Low Power Node features

■Qualified Bluetooth subsystem (QDID)

□Tested as part of UnPlugFest UPF53, (Jan 2016), UPF54 (June 2016), UPF55 (Oct 2016),

UPF56 (Jan 2017), UPF57 (June 2016), UPF58 (Oct 2017), UPF59 (Jan 2018), UPF60 (May

2018), UPF61 and UPF62

■Single-chip solution with hardware (HW) acceleration for all Mesh security operations

■Bluetooth low energy (BLE) 4.2 wireless connectivity

■Easy scalable software (SW) architecture to integrate other smart home protocols in a single

design

■User application memory resources:

□Application size only limited by size of external Flash memory

□~64 kB RAM remaining after existing reference app/BLE stack/Mesh library usage

■Compatible with DA1468x Basic, Pro, and USB HW development boards

■Debug features: Segger J-Link debugger/RTT/Systemview and print to console

■Sample iOS and Android applications demonstrating many of the BLE Mesh features

UM-B-098

DA1468x Mesh SDK

Company Confidential

User Manual

Revision 1.2

1-April-2019

CFR0012

8 of 47

5 Getting Started: Running the Demo Application

5.1 Description

The DA1468x Mesh SDK is compatible with both Pro, Basic and USB DK HW. The HW boards are

described at reference documents [7], [13], and [9]. For all Mesh reference applications, the same

HW can be used. The DK can be reprogrammed to run a single instance of an application. In order to

switch between different applications, these HW boards can be upgraded over JTAG using the

development process explained in section 6.2.1.

NOTE

The preferred DK HW to start using the Mesh SDK with is the DA14683 USB development kit. It has a much

smaller form factor, is more affordable, and is easier to create and test large Mesh networks with multiple

nodes.

Figure 1: DA14683 USB Development Kit

Figure 2: DA1468x PRO Development Kit, Motherboard and Daughterboard

UM-B-098

DA1468x Mesh SDK

Company Confidential

User Manual

Revision 1.2

1-April-2019

CFR0012

9 of 47

Figure 3: DA1468x Basic Development Kit

5.2 Connecting Hardware and Powering On

The DK HW boards are pre-assembled and does no need extra rework. There is no need to change

any jumper positions to get a functional demo application running.

The DK HW boards are shipped unprogrammed. So to flash the demo image, please first follow the

instructions in sections 6.1, 6.2,and 6.2.1. The boards will then be in factory reset state and their

node database will be empty (start from un-provisioned state).

The boards are powered via USB. Connect the provided USB cable to laptops, desktops, or power

adapters to power the accessories.

The boards should then enter the unprovisioned Beacon advertising mode and be ready to interact

with any Mesh enabled provisioner. The default provisioning bearer is GATT.

5.3 Button and LED Usage

The buttons and LEDs that are used in the reference implementation are listed in section 5.3.1 and

5.3.2. This guide assumes that the DA14683 USB DKs are used:

5.3.1 Buttons and Switches

●RESET: resets the DA14683 HW.

●SW1 short press: toggles Mesh model state (represents the behavior of manually switching ON

or OFF a fan, a lock, a light bulb, or others).

●SW1long press (~5 sec): reset the device to factory state (start from un-provisioned state).

●SW2: it is only used in the multiple-element example to represent operation of the second

element

5.3.2 LEDs

●D10: it represents Mesh model state (for example, ON: lightbulb is turned on; OFF: lightbulb is

turned off)

●D8: it represents the provisioning and configuration state:

UM-B-098

DA1468x Mesh SDK

Company Confidential

User Manual

Revision 1.2

1-April-2019

CFR0012

10 of 47

○Fast blinking: Device is unprovisioned and waits to be provisioned

○Slow blinking: Device is provisioned (belongs to a network) but not configured yet (no publish

or subscription address is assigned yet)

○Turned off: Device is both provisioned and configured and can interact with other devices in

the network

○Its intensity level represents the state of the level server model in the corresponding example

○Its color represents the hue saturation level (HSL) settings of the HSL server model in the

corresponding example

●D9: it is only used in the multiple-element example to represent operation of the second element

5.4 Mesh SDK Demo Examples Bring up

The device can be tested against any iOS or Android smartphone applications which support the

Mesh protocol.

Make sure that Dialog's Mesh application, which can be found under

DA14683_MESH_vXXX\projects\host_apps\ethermind-mobile directory, is used.

Dialog's USB DK should be programmed with the default ble_mesh application found in the directory

DA14683_MESH_vXXX\projects\dk_apps\demos\ble_mesh. The default application code enables

provisioning over GATT and expects the devices to be provisioned over GATT.

At least two different nodes need to be programmed. Both should have a unique node ID and

different roles (for example, one is a lightbulb and the other is a switch). One of them should get

configured as the server of the model and the other one as the client. The available model examples

in this release are:

●Generic ON/OFF

●Generic level

●Generic ON/OFF with multiple elements

●Light HSL

●Vendor specific

For every node after factory reset, a random BLE address and Mesh universally unique identifier

(UUID) is assigned to the node. Users do not need to try to assign UUIDS to the nodes like when

using the previously released SDKs, for example, programming NVPARAM partition.

NOTE

This release contains support for all the SIG models defined in the Mesh specification v1.0. The examples

can be used as a guideline to how models can be initialized and used.

The provisioner example in the release is not meant to be tested with the mobile app. This example

demonstrates provisioning over the ADV bearer with the other examples in the SDK, while the mobile app

demonstrates provisioning over the GATT bearer. For more information regarding the provisioner example

refer to section 5.5.6.

5.4.1 Mobile Application Instructions

The section describes how the mobile app can be used to provision and configure a new device to

the network. Any of the SDK examples can be used but new users are recommended to start with

the Generic ON/OFF example, which provides a simple demo of how to turn ON/OFF a LED in the

server (for example, a lightbulb) side by using a button from the client (for example, a switch) side.

Note 1 The mobile application can provision and configure all the examples in the SDK, but its current version

can only remotely control the generic ON/OFF example.

Andere Handbücher für DA1468 series

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere Dialog Semiconductor Mikrocontroller Handbücher

Dialog Semiconductor

Dialog Semiconductor DA1468 series Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA14531 PRO Gebrauchsanweisung

Dialog Semiconductor

Dialog Semiconductor DA14681 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA14681 Anleitung zur Verwendung

Dialog Semiconductor

Dialog Semiconductor DA1458 Series Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA1468 series Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA14530/1 Gebrauchsanweisung

Dialog Semiconductor

Dialog Semiconductor DA14695 ProDK Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA14695 USB Kit Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA1458 Series Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA14683 USB Kit Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA1469 PRO series Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor SmartBond DA14585 Bedienungsanleitung

Dialog Semiconductor

Dialog Semiconductor DA14681 Bedienungsanleitung

Beliebte Mikrocontroller Handbücher anderer Marken

AMS

AMS AS7261 Demo Kit Bedienungsanleitung

Novatek

Novatek NT6861 Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266 SDK Einrichtungshandbuch

Nuvoton

Nuvoton ISD61S00 ChipCorder Leitfaden

STMicrolectronics

STMicrolectronics ST7 Assembler Linker Bedienungsanleitung

Texas Instruments

Texas Instruments Chipcon CC2420DK Bedienungsanleitung

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM Bedienungsanleitung

NEC

NEC 78GK0S/K 1+ Series Montage- und Bedienungsanleitung

Mikroe

Mikroe SEMITECH N-PLC Click Montage- und Bedienungsanleitung

Intel

Intel Agilex Bedienungsanleitung

Cypress

Cypress CY4607 HX2VL Bedienungsanleitung

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE Bedienungsanleitung

Texas Instruments

Texas Instruments TMS320F2837 D Series Bedienungsanleitung

CYPRES

CYPRES CY14NVSRAMKIT-001 Bedienungsanleitung

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266EX Betriebsanleitung

Abov

Abov AC33M8128L Bedienungsanleitung

Laird

Laird BL654PA Bedienungsanleitung