1. Manuals
  2. Brands
  3. Dialog Semiconductor Manuals
  4. Microcontrollers
  5. DA1468 series
  6. User manual

Dialog Semiconductor DA1468 Series User Manual

Mesh sdk
Hide thumbs Also See for DA1468 Series:
Table of Contents

Advertisement

Quick Links

Download this manual See also: User Manual
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.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DA1468 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Dialog Semiconductor DA1468 Series

Summary of Contents for Dialog Semiconductor DA1468 Series

  • Page 1: Abstract

    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.

  • Page 2: Table Of Contents

    UART Logging Window ..................29 Developing on Linux Host OS ..................... 29 Developing on MacOS ......................30 6.10 Understanding Serial Terminal Options ................30 6.10.1 Reset the Accessory .................... 31 User Manual Revision 1.2 1-April-2019 CFR0012 2 of 47 © 2019 Dialog Semiconductor...

  • Page 3: Figures

    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 User Manual Revision 1.2 1-April-2019 CFR0012 3 of 47 © 2019 Dialog Semiconductor...
  • Page 4 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 User Manual Revision 1.2 1-April-2019 CFR0012 4 of 47 © 2019 Dialog Semiconductor...

  • Page 5: Terms And Definitions

    Dialog-BLE-Mesh-Training.ppt UM-B-060, DA1468x/DA1510x Development kit Pro Hardware, User Manual, Dialog Semiconductor UM-B-057, SmartSnippets™ Studio User Guide, User Manual, Dialog Semiconductor UM-B-066, DA1468x Development Kit Basic, User Manual, Dialog Semiconductor User Manual Revision 1.2 1-April-2019 CFR0012 5 of 47 © 2019 Dialog Semiconductor...
  • Page 6 [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...

  • Page 7: Introduction

    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 User Manual Revision 1.2 1-April-2019 CFR0012 7 of 47 © 2019 Dialog Semiconductor...

  • Page 8: Getting Started: Running The Demo Application

    Mesh networks with multiple nodes. Figure 1: DA14683 USB Development Kit Figure 2: DA1468x PRO Development Kit, Motherboard and Daughterboard User Manual Revision 1.2 1-April-2019 CFR0012 8 of 47 © 2019 Dialog Semiconductor...

  • Page 9: Connecting Hardware And Powering On

    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: User Manual Revision 1.2 1-April-2019 CFR0012 9 of 47 © 2019 Dialog Semiconductor...

  • Page 10: Mesh Sdk Demo Examples Bring Up

    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. User Manual Revision 1.2 1-April-2019 CFR0012 10 of 47 © 2019 Dialog Semiconductor...

  • Page 11: Figure 4: Start Dialog's Ble Mesh App

    (Figure Figure 5: Create A Group in the Mesh Tab 4. Enter a name for the group and press the "CONFIRM" button (Figure User Manual Revision 1.2 1-April-2019 CFR0012 11 of 47 © 2019 Dialog Semiconductor...

  • Page 12: Figure 6: Name The Group

    SW1 for at least 5 sec. (Figure Figure 7: Power the Board Programmed as a Light 6. Provision a new device by selecting in the side menu the "Unprovisioned devices" tab. (Figure User Manual Revision 1.2 1-April-2019 CFR0012 12 of 47 © 2019 Dialog Semiconductor...

  • Page 13: Figure 8: Provision A New Device

    8. Now the Nodes tab contains the new node that was just added. The default names for the elements and the nodes are used. These can be changed through the settings as shown below. (Figure Node settings User Manual Revision 1.2 1-April-2019 CFR0012 13 of 47 © 2019 Dialog Semiconductor...

  • Page 14: Figure 10: Nodes Screen

    10. The node settings screen can be used to set a friendly name for the node (eg Bedroom Lightbulb), set which mesh features are enabled (er proxy, beacon, friend, relay), or un-provision the node by clicking on the trashcan icon. (Figure User Manual Revision 1.2 1-April-2019 CFR0012 14 of 47 © 2019 Dialog Semiconductor...

  • Page 15: Figure 12: Select The Nodes Tab

    Note that the switch is a Generic ON/OFF client, it does not contain a state therefore unlike the lightbulb case, the application does not contain a control element switch any state (Figure User Manual Revision 1.2 1-April-2019 CFR0012 15 of 47 © 2019 Dialog Semiconductor...

  • Page 16: Figure 14: Configuration Tab

    14. At this point, since both nodes are subscribed to the same group, the user can toggle the state of light bulbs by using SW1 on the switch board (Figure User Manual Revision 1.2 1-April-2019 CFR0012 16 of 47 © 2019 Dialog Semiconductor...

  • Page 17: Figure 16: Toggle Light Bulb States By Sw1

    (Figure 17). Figure 17: The group screen 16. The red LED on all light bulb boards is turned on (Figure 18). User Manual Revision 1.2 1-April-2019 CFR0012 17 of 47 © 2019 Dialog Semiconductor...

  • Page 18: Figure 18: Red Led On Light Bulb Board Turned On

    UM-B-098 Company Confidential DA1468x Mesh SDK Figure 18: Red LED on Light Bulb Board Turned on User Manual Revision 1.2 1-April-2019 CFR0012 18 of 47 © 2019 Dialog Semiconductor...

  • Page 19: Various Sdk Example Demonstrations

    Note that another demo setup could be to add the same address in the first element of the server. subscribe add 0 49454 User Manual Revision 1.2 1-April-2019 CFR0012 19 of 47 © 2019 Dialog Semiconductor...

  • Page 20: Vendor Specific Model Demonstration

    Error! Reference source not found. described in section 5.4.1. NOTE The mobile applications with the version up to V0.0.3 only support the control over the ON/OFF example. User Manual Revision 1.2 1-April-2019 CFR0012 20 of 47 © 2019 Dialog Semiconductor...

  • Page 21: Relay Example Demonstration

    For simplicity, do not enable the relay and proxy feature in the nodes. 4. Now toggling the switch should toggle the two lightbulbs. 5. Let's call one lightbulb "Friend Lightbulb" and the other lightbulb "LPN Lightbulb". User Manual Revision 1.2 1-April-2019 CFR0012 21 of 47 © 2019 Dialog Semiconductor...

  • Page 22: Sw Upgrade Over The Air (Suota) Support

    This SW functionality is enabled in the code by defining the DEVICE_DISPLAY_7SEG and DEVICE_SLIDER defines in custom_config_qspi.h. For more details regarding the HW support and the PCB mounting, refer to [13]. User Manual Revision 1.2 1-April-2019 CFR0012 22 of 47 © 2019 Dialog Semiconductor...

  • Page 23: Figure 19: Microbus 7-Segment Display And Slider Modules

    UM-B-098 Company Confidential DA1468x Mesh SDK Figure 19: Microbus 7-Segment Display and Slider Modules User Manual Revision 1.2 1-April-2019 CFR0012 23 of 47 © 2019 Dialog Semiconductor...

  • Page 24: Development Environment Setup

    (Figure 20). 3. A successful build for the ble_mesh project will give a result shown in Figure SmartSnippets™ Figure 20: Build Configurations of ble_mesh Project in Studio User Manual Revision 1.2 1-April-2019 CFR0012 24 of 47 © 2019 Dialog Semiconductor...

  • Page 25: Build Project For Da14681

    2. If asked for product ID option, select the default one, "DA14683", in the command prompt. 3. If scripts are not shown, select "Organize Favorites" > "Add" > "Select All". User Manual Revision 1.2 1-April-2019 CFR0012 25 of 47 © 2019 Dialog Semiconductor...

  • Page 26: Figure 22: Writing The Generated Image Into The Flash

    6.2, because it will flash the last build configuration that has been compiled successfully based on the selected project. 4. Successful programming of the DA1468x DK should look like Figure Figure 23: Writing the generated Image into the flash: Log Output User Manual Revision 1.2 1-April-2019 CFR0012 26 of 47 © 2019 Dialog Semiconductor...

  • Page 27: Modify The Bluetooth Address And Mesh Device Uuid

    If no scripts are shown, select "Organize Favorites" > "Add" > "Select All". Figure 24: Debug Configurations Now the Eclipse debug perspective should appear (Figure 25). User Manual Revision 1.2 1-April-2019 CFR0012 27 of 47 © 2019 Dialog Semiconductor...

  • Page 28: Figure 25: Eclipse Debug Perspective

    UM-B-098 Company Confidential DA1468x Mesh SDK Figure 25: Eclipse Debug Perspective User Manual Revision 1.2 1-April-2019 CFR0012 28 of 47 © 2019 Dialog Semiconductor...

  • Page 29: Obtaining Logging Information

    Select Configure. Choose the option "Virtual COM-Port". Developing on Linux Host OS Please refer to [10] for how to install and use the development environment in Linux. User Manual Revision 1.2 1-April-2019 CFR0012 29 of 47 © 2019 Dialog Semiconductor...

  • Page 30: Developing On Macos

    (Get Prov-Bearer if no param) > feature <relay/proxy/friend/lpn> <enable/disable>- Enable/disable a Mesh feature <relay/proxy/friend/lpn> > friend <setup/poll> - Establish friendship or poll for messages > scan - Scan for unprovisioned devices User Manual Revision 1.2 1-April-2019 CFR0012 30 of 47 © 2019 Dialog Semiconductor...

  • Page 31: Reset The Accessory

    In Model Server - Foundation Models Config Model Server Registration Status: 0x0000 In Model Server - Foundation Mdels Config Model Server Registration Status: 0x0000 Health Server Initialized. Model Handle: 0x0001 User Manual Revision 1.2 1-April-2019 CFR0012 31 of 47 © 2019 Dialog Semiconductor...

  • Page 32: Reset To Factory Default State

    Net Key[0x00]: 9E A9 79 C3 15 F6 F6 D2 3D 5E 55 80 9F 52 9F E8 App Key[0x00]: D2 D3 8D F5 80 E9 40 0E FB 1D 0D 61 A1 CA AB F2 Shell> User Manual Revision 1.2 1-April-2019 CFR0012 32 of 47 © 2019 Dialog Semiconductor...

  • Page 33: Monitor Freertos Heap Usage And Task Stack Usage

    Reducing the maximum BLE RF can be done by using the "lowrange" command. Shell> lowrange BLE radio range reduced to ~2 meters User Manual Revision 1.2 1-April-2019 CFR0012 33 of 47 © 2019 Dialog Semiconductor...

  • Page 34: Commands Related To Friendship And Low Power Node

    Entry[2]: 0xC002 Shell> As an example, an existing address can be removed as: Shell> subscribe remove 0 0x1000 0xC001 Subscription Address is remove Successfully - 0xC001 Shell> User Manual Revision 1.2 1-April-2019 CFR0012 34 of 47 © 2019 Dialog Semiconductor...

  • Page 35: 6.10.11 Modify The Publish Address Of A Client Model

    For HSL client the following sample values can be used: ● hsl 0 65535 32767 RED: ● hsl 21845 65535 32767 GREEN: ● hsl 43690 65535 32767 BLUE: ● hsl 0 0 0 OFF: User Manual Revision 1.2 1-April-2019 CFR0012 35 of 47 © 2019 Dialog Semiconductor...

  • Page 36: 6.10.13 Change Provisioning Bearer

    This command is only available for the provisioner example. 6.10.16 Start Configuration for Selected Node Users can start the configuration of a selected node with the command: User Manual Revision 1.2 1-April-2019 CFR0012 36 of 47 © 2019 Dialog Semiconductor...

  • Page 37: 6.11 Using The Segger Systemview

    Figure 27: Verifying the Correct J-Link Version 5. Invoke the debugger by starting the Release_QSPI debug configuration. Do NOT press the RUN button (‘play’ icon) yet. The CPU is halted User Manual Revision 1.2 1-April-2019 CFR0012 37 of 47 © 2019 Dialog Semiconductor...

  • Page 38: Figure 28: Segger Systemview Capture Settings

    Depending on the interrupt service routine activity, the RTT buffer may overflow. Monitor the dropped/overflow counter in SystemView window for any missed events. The overflow of RTT buffer is quite rare and is usually observed during I2C or SPI activity. User Manual Revision 1.2 1-April-2019 CFR0012 38 of 47 © 2019 Dialog Semiconductor...

  • Page 39: Figure 29: Segger Systemview Trace Capture

    UM-B-098 Company Confidential DA1468x Mesh SDK Figure 29: SEGGER SystemView Trace Capture User Manual Revision 1.2 1-April-2019 CFR0012 39 of 47 © 2019 Dialog Semiconductor...

  • Page 40: Software Architecture

    BLE Adapter task has the highest priority and the scheduler switches to this task for every BLE advertising event or to keep an active BLE connection alive. User Manual Revision 1.2 1-April-2019 CFR0012 40 of 47 © 2019 Dialog Semiconductor...

  • Page 41: Mesh Dk Sw Architecture

    All user specific code ○ Mesh core call-back implementation functions ○ External HW handling (GPIOs and LEDs) ○ Any HW sensor interfaces ○ Etc. Figure 31: Mesh DK SW Architecture User Manual Revision 1.2 1-April-2019 CFR0012 41 of 47 © 2019 Dialog Semiconductor...

  • Page 42: Folder And File Structure

    (level_set_cb and level_get_cb) and the implementation of the user specific notification processing function process_notifications. In this example the button toggling functionality (BUTTON1_PROCESS_NOTIFY) and factory reset functionality (BUTTON_FACTORY_RESET_NOTIFY) is demonstrated. User Manual Revision 1.2 1-April-2019 CFR0012 42 of 47 © 2019 Dialog Semiconductor...

  • Page 43: The Appl_Proxy.c File

    As the first step, the corresponding variable is defined in appl_storage_keys.h: enum storage { STORAGE_MS_PS_RECORD_BD_ADDR = APPL_STORAGE_CAT(APPL_STORAGE_USER_DATA_CAT), STORAGE_MS_PS_RECORD_AVAILABLE_UNICAST_ADDR, Then this variable is accessed using the corresponding APIs: appl_storage_get_item(STORAGE_MS_PS_RECORD_BD_ADDR, &val, &len) User Manual Revision 1.2 1-April-2019 CFR0012 43 of 47 © 2019 Dialog Semiconductor...

  • Page 44: The Mesh_Console.c File

    The list of possible arguments For example, the command to enable/disable various mesh features is defined as: {"feature", 0, 2, cmd_enable_feature, "Enable/disable a Mesh feature <relay/proxy/friend/lpn>", "<relay/proxy/friend/lpn> <enable/disable>"} User Manual Revision 1.2 1-April-2019 CFR0012 44 of 47 © 2019 Dialog Semiconductor...

  • Page 45: Revision History

    Update section 6.10 to reflect latest UART console command changes Update section to handle build instructions for DA14861 12-Nov-2018 Update section 6.10 to add new terminal commands included in the latest examples 17-Sep-2018 Initial version. User Manual Revision 1.2 1-April-2019 CFR0012 45 of 47 © 2019 Dialog Semiconductor...
  • Page 46 Terms and Conditions of Sale, available on the company website (www.dialog-semiconductor.com) unless otherwise stated. Dialog and the Dialog logo are trademarks of Dialog Semiconductor plc or its subsidiaries. All other product or service names are the property of their respective owners.
  • Page 47 UM-B-098 Company Confidential DA1468x Mesh SDK enquiry@diasemi.com www.dialog-semiconductor.com User Manual Revision 1.2 1-April-2019 CFR0012 47 of 47 © 2019 Dialog Semiconductor...

This manual is also suitable for:

Da14683

Table of Contents