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
Company confidential
User manual
DA1468x Mesh SDK
UM-B-098

Abstract

This document provides basic guidelines for developers and kit users, in order to get familiar with the
DA1468x Mesh SDK and 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, in order to get familiar with the DA1468x Mesh SDK and modify or create a BLE Mesh application based on it.

  • Page 2: Table Of Contents

    Developing on Linux Host OS ..................30 Developing on Mac OS ....................30 Understanding Serial Terminal Options ................ 30 Reset the Accessory ..................31 User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 2 of 48 © 2018 Dialog Semiconductor...

  • Page 3: Figures

    Figure 14 SystemView Trace - Task Switching ................... 41 Figure 15: Mesh DK SW Architecture ....................42 Figure 17: SW stack and file location ....................43 User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 3 of 48 © 2018 Dialog Semiconductor...

  • Page 4: Tables

    UM-B-098 DA1468x Mesh SDK Company confidential Tables No table of figures entries found. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 4 of 48 © 2018 Dialog Semiconductor...

  • Page 5: Terms And Definitions

    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 Rev 1.0, User Manual, Dialog Semiconductor User manual Revision 0.1 - DRAFT 17 - July - 2018...

  • Page 6: Introduction

    Debug features: Segger J-Link debugger/RTT/Systemview and print to console ■ Sample iOS and Android application demonstrating many of the BLE Mesh features User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 6 of 48 © 2018 Dialog Semiconductor...

  • Page 7: Getting Started - Running The Demo Application

    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: PRO Development Kit, Motherboard and Daughterboard User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 7 of 48 © 2018 Dialog Semiconductor...

  • Page 8: Figure 3: Da1468X Basic Development Kit

    UM-B-098 DA1468x Mesh SDK Company confidential Figure 3: DA1468x Basic Development Kit User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 8 of 48 © 2018 Dialog Semiconductor...

  • Page 9: Connecting Hardware And Powering On

     The Dialog USB DK should be programmed with the default ble_mesh application 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. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 9 of 48 © 2018 Dialog Semiconductor...
  • Page 10 GATT bearer. For more information regarding the provisioner example refer to section 5.5.6. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 10 of 48 © 2018 Dialog Semiconductor...

  • Page 11: Mobile Application Instructions

    4. Enter a name for the Group and press the Add button 5. Verify Group has been added 6. Power-on the board programmed as a Switch User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 11 of 48 © 2018 Dialog Semiconductor...
  • Page 12 10. Select the Nodes Tab and the Node to be configured 11. Device information will be read out and displayed 12. Select the Configuration Tab User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 12 of 48 © 2018 Dialog Semiconductor...
  • Page 13 It should not affect demo operation. 15. Select the Group field, set to previously created group User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 13 of 48 © 2018 Dialog Semiconductor...
  • Page 14 19. Power-on the board programmed as a Light Bulb 20. Select the Unprovisioned Tab and start a Scan 21. Select the device to be provisioned User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 14 of 48 © 2018 Dialog Semiconductor...
  • Page 15 It should not affect demo operation. 27. Select the Function field and set to On/Off User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 15 of 48 © 2018 Dialog Semiconductor...
  • Page 16 33. Proxy nodes (the Switch) will be highlighted green. If this is not the case make sure step 13 was executed properly. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 16 of 48 © 2018 Dialog Semiconductor...
  • Page 17 38. Turn all Light Bulbs on and off using the Group Slider 39. Toggle state of Light Bulbs by using SW1 on Switch board User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 17 of 48 © 2018 Dialog Semiconductor...
  • Page 18 UM-B-098 DA1468x Mesh SDK Company confidential User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 18 of 48 © 2018 Dialog Semiconductor...

  • Page 19: Notes Regarding The Sdk Examples Demonstration

    At this point by toggling the SW2 in client side, the D10 LED which represents the second element in server side should toggle. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 19 of 48 © 2018 Dialog Semiconductor...

  • Page 20: Vendor Specific Model Demonstration

    After the new node is added, it can communicate with the others as described in the previous sections of this chapter. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 20 of 48 © 2018 Dialog Semiconductor...

  • Page 21: Proxy Example Demonstration

    By using a TTL value of 1 will make the relay Node B to drop the packet, preventing the message in this way to reach Node C. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 21 of 48 © 2018 Dialog Semiconductor...

  • Page 22: Friend - Low Power Node Example Demonstration

    For more details refer to DA14683 SW developer guide UM-B-056 [11]. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 22 of 48 © 2018 Dialog Semiconductor...

  • Page 23: Microbus Devices Example Demonstration

    For more details regarding the HW support and the PCB mounting refer to UM-B-094, DA14683 USB Kit. Figure 4: Microbus 7-segment display and slider modules User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 23 of 48 © 2018 Dialog Semiconductor...

  • Page 24: Development Environment Setup

    Click Finish. 8. Select a configuration and build the ble_mesh project. Figure 5: BLE Mesh App - Build Configurations User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 24 of 48 © 2018 Dialog Semiconductor...

  • Page 25: Flashing The New Sw Into The Sdk

    If scripts are not shown, select ‘Organize Favorites’ -> ‘Add’ -> ‘Select All’. Figure 7: Programming the Flash Image User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 25 of 48 © 2018 Dialog Semiconductor...

  • Page 26: Figure 7: Programming Flash - Log Output

    12. Successful programming of the board should look like this: Figure 8: Programming Flash – Log Output 13. The Flash memory is now programmed. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 26 of 48 © 2018 Dialog Semiconductor...

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

    ‘Organize Favorites’ -> ‘Add’ -> ‘Select All’ Figure 9: Debug Configurations 15. The Eclipse Debug perspective should now appear. See Figure User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 27 of 48 © 2018 Dialog Semiconductor...

  • Page 28: Figure 9: Debug Perspective

    UM-B-098 DA1468x Mesh SDK Company confidential Figure 10: Debug Perspective User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 28 of 48 © 2018 Dialog Semiconductor...

  • Page 29: Obtaining Logging Information

    16. Open the J-Link Configurator. 17. Right click on the connected J-Link device. 18. Select Configure. 19. Make sure “Virtual COM-Port” is checked. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 29 of 48 © 2018 Dialog Semiconductor...

  • Page 30: Developing On Linux Host Os

    > 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 User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 30 of 48 © 2018 Dialog Semiconductor...

  • Page 31: Reset The Accessory

    Config Model Server Registration Status: 0x0000 Health Server Initialized. Model Handle: 0x0001 In Generic OnOff Model Client Generic Onoff Client Initialized. Model Handle: 0x0002 User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 31 of 48 © 2018 Dialog Semiconductor...

  • Page 32: Reset To Factory Default State

    App Key[0x00]: D2 D3 8D F5 80 E9 40 0E FB 1D 0D 61 A1 CA AB F2 Shell> User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 32 of 48 © 2018 Dialog Semiconductor...

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

    ~2 meters away, so relay function can be easily tested within a typical room. This can be done by using the “lowrange” command. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 33 of 48 © 2018 Dialog Semiconductor...

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

    Subscription Address is set Successfully. Model_handle: 0x0002 addr: 0xC002 The new subscription address list is now: Shell> subscribe get 0 Subscription Address List Read Successfully Entries: 2 User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 34 of 48 © 2018 Dialog Semiconductor...

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

    DK HW, therefore certain UART commands are added for all client model examples. In a real product, the same code should be called at the corresponding call-back HW sensor routines. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 35 of 48 © 2018 Dialog Semiconductor...
  • Page 36 0 65535 32767 RED: hsl 21845 65535 32767 GREEN: hsl 43690 65535 32767 BLUE: hsl 0 0 0 OFF: User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 36 of 48 © 2018 Dialog Semiconductor...

  • Page 37: Using The Segger Rtt Systemview

    USB (Connection to J-Link), CORTEX-M0 (Target Device), SWD @ 8000 kHz (Target Interface & Speed) and enter the address of _SEGGER_RTT (from the binary MAP file). Press OK. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 37 of 48 © 2018 Dialog Semiconductor...

  • Page 38: Figure 12: Segger Systemview Capture Settings

    SystemView window for any missed events. This is quite rare, and is usually observed during I2C or SPI activity. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 38 of 48 © 2018 Dialog Semiconductor...

  • Page 39: Figure 13: Segger Systemview Trace Capture

    UM-B-098 DA1468x Mesh SDK Company confidential Figure 14: SEGGER SystemView Trace Capture User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 39 of 48 © 2018 Dialog Semiconductor...

  • Page 40: Software Architecture

    Before diving into the actual SW implementation, the user is expected to have a good understanding of Bluetooth Mesh Specification main features and architecture principles. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 40 of 48 © 2018 Dialog Semiconductor...

  • Page 41: Da14683 Mesh Sw Architecture

    BLE advertising event or to keep an active BLE connection alive. Figure 15 SystemView Trace - Task Switching User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 41 of 48 © 2018 Dialog Semiconductor...

  • Page 42: Mesh Dk Sw Architecture

    FreeRTOS thread with the actual user application function (user_application_main_task). This function is located inside the user_*_example.c files under the user_application folder. User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 42 of 48 © 2018 Dialog Semiconductor...

  • Page 43: The User___Example Files

    User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 43 of 48 © 2018 Dialog Semiconductor...

  • Page 44: The Appl_Provision.c File

    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) appl_storage_put_item(STORAGE_MS_PS_RECORD_BD_ADDR, addr->addr, 6, true); User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 44 of 48 © 2018 Dialog Semiconductor...

  • Page 45: The Mesh_Console.c File

    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 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 45 of 48 © 2018 Dialog Semiconductor...

  • Page 46: Revision History

    Date Description 17 - July-18 Initial version 17 - Sep-18 Update all sections according to R1.2 release Change details: User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 46 of 48 © 2018 Dialog Semiconductor...
  • Page 47 Dialog Semiconductor excludes all liability in this respect. Customer notes that nothing in this document may be construed as a license for customer to use the Dialog Semiconductor products, software and applications referred to in this document. Such license must be separately sought by customer with Dialog Semiconductor.
  • Page 48 Phone: +31 73 640 8822 Phone: +886 281 786 222 Phone: +82 2 3469 8291 Email: Web site: enquiry@diasemi.com www.dialog-semiconductor.com User manual Revision 0.1 - DRAFT 17 - July - 2018 CFR0012-00 Rev 2 48 of 48 © 2018 Dialog Semiconductor...

This manual is also suitable for:

Da14683

Table of Contents