Dialog Semiconductor SmartBond DA14585 User manual

Company Confidential
User Manual
DA14585 IoT Multi Sensor
Development Kit User Guide
UM-B-100
Abstract
IoT Multi Sensor Development Kit (MSK) based on DA14585 supports 15 Degrees of Freedom and
includes five reference designs: IoT Sensors, Smart Tag, and three different types of beacons. The
corresponding apps run on iOS/Android devices and the cloud services offers great flexibility to
customers in product design. This document describes the architecture and the implementation
details of DA14585 IoT MSK reference design and the supporting applications.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
2 of 60
© 2019 Dialog Semiconductor
Contents
Abstract................................................................................................................................................ 1
Contents............................................................................................................................................... 2
Figures.................................................................................................................................................. 4
Tables ................................................................................................................................................... 5
1 Terms and Definitions................................................................................................................... 6
2 References..................................................................................................................................... 6
3 Introduction.................................................................................................................................... 8
4 IoT Sensors Reference Application............................................................................................. 8
4.1 Introduction ........................................................................................................................... 8
4.2 IoT Sensors App in Android and iOS.................................................................................... 9
4.2.1 Installing from Apple AppStore.............................................................................. 9
4.2.2 Installing from Google PlayStore........................................................................... 9
4.3 Screens of Dialog IoT Sensors App.................................................................................... 10
4.3.1 Scan Screen........................................................................................................ 10
4.3.2 Side Menu............................................................................................................ 11
4.3.2.1 Environmental Sensors ................................................................... 11
4.3.2.2 IMU sensors..................................................................................... 12
4.3.2.3 Sensor Fusion 3D screen................................................................ 13
4.3.3 Basic Settings Screen.......................................................................................... 15
4.3.3.1 Calibrate Proximity Sensor.............................................................. 16
4.3.4 Magnetometer Calibration Settings Screen......................................................... 17
4.3.4.1 Magnetometer Calibration File ........................................................ 18
4.3.5 Magnetometer Auto-Calibration Procedure......................................................... 18
4.3.5.1 Prerequisites for Magnetometer Calibration.................................... 19
4.3.5.2 Procedure of Magnetometer Calibration ......................................... 19
4.3.5.3 Magnetometer Sensor and Calibration State Reporting.................. 19
4.3.6 SmartFusion Coefficients Screen........................................................................ 20
4.3.7 Fast Accelerometer Calibration Screen............................................................... 21
4.4 Air Quality Index.................................................................................................................. 21
5 Smart Tag Reference Application.............................................................................................. 22
5.1 Introduction ......................................................................................................................... 22
5.2 SmartTags App in Android and iOS.................................................................................... 22
5.2.1 Overview.............................................................................................................. 22
5.2.2 Installation............................................................................................................ 23
5.2.3 Device List........................................................................................................... 24
5.2.4 Device Details...................................................................................................... 24
6 Beacon Reference Applications ................................................................................................ 28
6.1 Introduction ......................................................................................................................... 28
6.2 What is a Beacon?.............................................................................................................. 28
6.3 Beacon Example................................................................................................................. 29
6.4 Finding Advertising Devices................................................................................................ 30
7 IoT Cloud Applications............................................................................................................... 30
7.1 Introduction ......................................................................................................................... 30

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
3 of 60
© 2019 Dialog Semiconductor
7.2 User and Device Management ........................................................................................... 31
7.2.1 Users.................................................................................................................... 31
7.2.2 Devices................................................................................................................ 32
7.3 Sensor Data........................................................................................................................ 33
7.3.1 Live Data.............................................................................................................. 33
7.4 Historical Data..................................................................................................................... 33
7.4.1 Cloud Application................................................................................................. 34
7.4.2 Mobile Application................................................................................................ 34
7.4.3 Rest API............................................................................................................... 35
7.5 Alerting................................................................................................................................ 35
7.5.1 Cloud Application................................................................................................. 35
7.5.2 Mobile Application................................................................................................ 36
7.6 IoT Control Application........................................................................................................ 37
7.6.1 Cloud Application................................................................................................. 37
7.6.2 Mobile application................................................................................................ 37
7.7 IoT Asset Tracking Application ........................................................................................... 38
7.7.1 Cloud Application................................................................................................. 38
7.7.1.1 Asset Tracking................................................................................. 38
7.7.1.2 Asset Management.......................................................................... 40
7.7.1.3 Gateway Management .................................................................... 41
7.7.1.4 Location Management..................................................................... 41
7.7.1.5 Supervisor Management ................................................................. 42
7.7.2 Mobile and Raspberry Pi application................................................................... 42
7.7.2.1 Mobile.............................................................................................. 42
7.7.2.2 Raspberry Pi.................................................................................... 43
7.7.2.3 Quick Start-up Guide....................................................................... 44
7.8 3D Game............................................................................................................................. 45
7.8.1 Cloud application................................................................................................. 45
7.9 Amazon Alexa..................................................................................................................... 46
7.9.1 Skill Activation...................................................................................................... 47
7.9.2 How to Use.......................................................................................................... 48
7.10 IFTTT................................................................................................................................... 49
7.10.1 Create an IFTTT Applet....................................................................................... 49
7.10.2 IFTTT Web Hook Key.......................................................................................... 54
7.10.3 Web App - IFTTT Settings................................................................................... 55
7.10.4 Mobile App: IFTTT Settings................................................................................. 56
Appendix A Troubleshooting........................................................................................................... 58
A.1 Magnetometer or Sensor Fusion Have Inconsistent Behaviors.......................................... 58
A.2 Device Does Not Connect after Switching to a Different Firmware.................................... 58
A.3 Proximity Sensor is always On ........................................................................................... 58
A.4 Air Quality Index is not Working.......................................................................................... 58
A.5 Magnetometer is not Working............................................................................................. 58
Revision History................................................................................................................................ 59

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
4 of 60
© 2019 Dialog Semiconductor
Figures
Figure 1: Internet of Things (IoT)........................................................................................................... 8
Figure 2: Installing Dialog IoT Sensors App from Apple AppStore....................................................... 9
Figure 3: Installing Dialog IoT Sensors App from Google PlayStore.................................................. 10
Figure 4: Scan screen of Dialog IoT Sensors App.............................................................................. 10
Figure 5: Side Menu............................................................................................................................ 11
Figure 6: Environmental Sensor Screen of Dialog IoT Sensors App.................................................. 12
Figure 7: IMU Sensor Screen of Dialog IoT Sensors App................................................................... 13
Figure 8: 3D Screen of Dialog IoT Sensors App................................................................................. 14
Figure 9: Basic settings of Dialog IoT Sensors App............................................................................ 15
Figure 10: Proximity Sensor Calibration prompt.................................................................................. 16
Figure 11: Calibration Settings of Dialog IoT Sensors App................................................................. 17
Figure 12: Sensor Fusion Settings of Dialog IoT Sensors App........................................................... 20
Figure 13: Accelerometer Calibration Settings of Dialog IoT Sensors App ........................................ 21
Figure 14: SmartTags APP Icon.......................................................................................................... 23
Figure 15: Installation of Dialog SmartTags App................................................................................. 24
Figure 16: Device List.......................................................................................................................... 24
Figure 17: Device Details .................................................................................................................... 25
Figure 18: Distance Alert Window....................................................................................................... 25
Figure 19: How to Access the Side Menu........................................................................................... 26
Figure 20: Device Information ............................................................................................................. 27
Figure 21: Disclaimer........................................................................................................................... 27
Figure 22: Seek & Find screens.......................................................................................................... 28
Figure 23: Beacon Protocol Logos...................................................................................................... 28
Figure 24: Bluetooth Low Energy Beacon........................................................................................... 29
Figure 25: Description of the Exhibit on a Smartphone....................................................................... 29
Figure 26: Locate App Screenshot...................................................................................................... 30
Figure 27: Cloud Settings.................................................................................................................... 31
Figure 28: Create New Account or Pairing with an Existing Account ................................................. 32
Figure 29: User Management in Cloud Application............................................................................. 32
Figure 30: Device Management.......................................................................................................... 33
Figure 31: Live Data............................................................................................................................ 33
Figure 32: Historical Data: Cloud application...................................................................................... 34
Figure 33: Historical Data: Mobile Application..................................................................................... 34
Figure 34: Alerting: Cloud Application................................................................................................. 36
Figure 35: Alerting: Mobile application................................................................................................ 36
Figure 36: Control: Cloud Application.................................................................................................. 37
Figure 37: Control: Mobile Application ................................................................................................ 38
Figure 38: Asset Tracking Table ......................................................................................................... 39
Figure 39: Asset Tracker..................................................................................................................... 39
Figure 40: Asset Tracker - Settings..................................................................................................... 40
Figure 41: Asset Tracker - Gateway settings...................................................................................... 40
Figure 42: Asset Management............................................................................................................ 41
Figure 43: Gateway Management....................................................................................................... 41
Figure 44: Location Management........................................................................................................ 42
Figure 45: Supervisor Management.................................................................................................... 42
Figure 46: Dialog IoT Sensors App, Asset Tracking Tab.................................................................... 43
Figure 47: Configuration File of Raspberry Pi Asset Tracking Gateway............................................. 44
Figure 48: 3D Game IoT Application................................................................................................... 45
Figure 49: 3D Demo............................................................................................................................ 46
Figure 50: 3D Ball-Board Control Game............................................................................................. 46
Figure 51: Dialog Evaluation Kit Skill for Alexa................................................................................... 47
Figure 52: Alexa: Skill Activation Succeeded Screen ......................................................................... 47
Figure 53: Alexa: Sign in Procedure.................................................................................................... 48
Figure 54: Alexa Mobile Application Main Screen............................................................................... 48
Figure 55: IFTTT Signup Page............................................................................................................ 49

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
5 of 60
© 2019 Dialog Semiconductor
Figure 56: New Applet......................................................................................................................... 49
Figure 57: Make an IFTTT Applet ....................................................................................................... 50
Figure 58: Make an IFTTT Applet Step 1............................................................................................ 50
Figure 59: Make an IFTTT Applet Step 2............................................................................................ 51
Figure 60: Make an IFTTT Applet, Complete Step 2 .......................................................................... 51
Figure 61: Make an IFTTT Applet, Create That.................................................................................. 52
Figure 62: Make an IFTTT Applet, Step 3........................................................................................... 52
Figure 63: Make an IFTTT Applet, Step 4........................................................................................... 53
Figure 64: Make an IFTTT Applet Step 5............................................................................................ 53
Figure 65: Make an IFTTT applet, Finish............................................................................................ 54
Figure 66: IFTTT Web Hook Key, step 1............................................................................................. 54
Figure 67: IFTTT Web Hook Key Step 2............................................................................................. 55
Figure 68: IFTTT Web Hook Key Step 3............................................................................................. 55
Figure 69: Web App - IFTTT Settings ................................................................................................. 56
Figure 70: IFTTT Settings - Mobile app............................................................................................... 56
Figure 71: Email When "Temperature" Occurred................................................................................ 57
Tables
Table 1: Air Quality Index.................................................................................................................... 22
Table 2: Example of Advertising Data from a Museum Beacon.......................................................... 29

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
6 of 60
© 2019 Dialog Semiconductor
1 Terms and Definitions
AQI Air Quality Index
BD Bluetooth Device
BLE Bluetooth Low Energy
GAP Generic Access Profile
GATT Generic Attribute Profile
IMU Inertial Measurement Unit
IoT Internet of Things
MSK Multi Sensor Development Kit
MSK Multi Sensor Kit
PC Personal Computer
RAM Random Access Memory
Report Notification of Sensor Data and Control
RSSI Received Signal Strength Indicator
SF Sensor Fusion
SFL Sensor Fusion Library
SI Sensors Interface
SUOTA Software Update over the Air
UART Universal Asynchronous Receiver/Transmitter
VOC Volatile Organic Compound
2 References
[1] UM-B-080, DA14585/586 SDK 6 Software Developer"s Guide, User Manual, Dialog
Semiconductor.
[2] UM-B-079, DA14585/586 SDK 6 Software Platform Reference, User Manual, Dialog
Semiconductor.
[3] RW-BLE-GAP-IS, GAP Interface Specification, Riviera Waves.
[4] UM-B-048, DA14585/DA14586 Getting Started Guide with the Basic Development Kit V2.0,
User Manual, Dialog Semiconductor.
[5] DA14585, Datasheet v3.2, Dialog Semiconductor.
[6] UM-B-089, DA14585 Range Extender Reference Application, User Manual, Dialog
Semiconductor.
[7] https://www.bluetooth.com/specifications/assigned-numbers/company-identifiers
[8] UM-B-065, Bluetooth®Smart Communication Interface Board, User Manual, Dialog
Semiconductor.
[9] https://github.com/google/eddystone
[10] https://github.com/google/eddystone/tree/master/eddystone-uid
[11] https://github.com/google/eddystone/tree/master/eddystone-url
[12] https://github.com/google/eddystone/blob/master/eddystone-tlm/tlm-plain.md
[13] https://github.com/AltBeacon/spec
[14] UM-B-095, DA14585 IoT Multi Sensor Development Kit Hardware Design, User Manual, Dialog
Semiconductor.
[15] https://www.bluetooth.com/specifications/gatt.
[16] AN-B-001, DA14580/581/583 Booting from serial interfaces, Application Note, Dialog
Semiconductor

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
7 of 60
© 2019 Dialog Semiconductor
[17] BST-BME680-AN008, BSEC Integration Guide, Bosch Sensortec
[18] UM-B-101, DA14585 IoT Multi Sensor Development Kit Developer"s Guide, User Manual,
Dialog Semiconductor

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
8 of 60
© 2019 Dialog Semiconductor
3 Introduction
With yearly shipments of more than 10 billion microcontrollers that all can exchange information
locally or through the Internet, a huge variety of so called "intelligent devices" are enabled. These
devices include motion sensors, pool pumps, gas/electric meters, street lamps, and many more.
All these devices can be accessed over the Internet; thanks to the rapid increase in infrastructure
coverage and Internet access. This evolution is often called the Internet of Things (IoT). Other names
include Internet of Everything (IoE), Web of Things, Embedded Web, and Industry 4.0. The goal is to
establish an Internet connection for the small “things”you carry with you or use in a factory, hospital,
city, or at home (Figure 1). IoT industrial experts predict that there are going to be more than 50
billion connected devices within the next 10 years.
Figure 1: Internet of Things (IoT)
Dialog"s IoT Multi Sensor development kit (MSK) is a compact development kit with 15 degrees of
freedom accompanied by five software reference applications and incorporating versatile sensor
management with cloud applications. The IoT MSK is based on DA14585 Bluetooth Low Energy SoC
and several motion and environmental sensors. The five software reference applications can be used
by Dialog"s apps running in iOS or Android devices. Users can build a rich cloud application with the
data from this IoT MSK in just a few configuration steps. In addition, the cloud applications provided
by Dialog can be used to monitor the data from the IoT MSK sensors and program IFTT events. This
IoT MSK offers users high flexibility in product design to cope with the fast changing IoT market.
4 IoT Sensors Reference Application
4.1 Introduction
The IoT Sensors reference application is a mobile application developed by Dialog Semiconductor
for both iOS and Android. It is designed to work with the DA14585 IoT MSK and offers a variety of
functionalities that use the most capabilities of the IoT MSK. Among others, users can graphically
monitor the readings from environmental sensors, inertial measurement unit (IMU), or SmartFusion
and configure the application according to the scenario"s needs at the same time.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
9 of 60
© 2019 Dialog Semiconductor
The chapter describes how to download and install the Dialog IoT Sensor App on a mobile device
and provides detailed information on the App interfaces and how to configure the App.
4.2 IoT Sensors App in Android and iOS
4.2.1 Installing from Apple AppStore
Dialog IoT Sensors app for iOS devices is available from Apple AppStore.
Figure 2: Installing Dialog IoT Sensors App from Apple AppStore
4.2.2 Installing from Google PlayStore
Dialog IoT Sensors app for Android devices is available from Google PlayStore.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
10 of 60
© 2019 Dialog Semiconductor
Figure 3: Installing Dialog IoT Sensors App from Google PlayStore
4.3 Screens of Dialog IoT Sensors App
4.3.1 Scan Screen
Once the DA14585 IoT MSK receives power, users will see the advertising LED blinking, indicating
that the device is currently visible to client applications. After starting the app, the first screen users
see is the "scan screen" (Figure 4).
Figure 4: Scan screen of Dialog IoT Sensors App
Only IoT MSK are listed on this page. The App hides BLE devices that do not have the advertise
values related to this DK.
Two fields are listed on the scan screen: the device type and the last three bytes of the Bluetooth
Device (BD) address. Tap on a device in the list to connect to it. Note that a listed device might not
be active (and the LED does not blink) when the advertise timeout has expired. To update the scan
list, touch the screen to scroll downwards (iOS) or press the Scan button (Android).

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
11 of 60
© 2019 Dialog Semiconductor
4.3.2 Side Menu
From the side menu (Figure 5) users can navigate to the rest of the screens that present:
●Environmental sensors
●IMU sensors
●Sensor Fusion 3D
●Cloud specific settings
●Settings
●Information
●Disclaimer
●Magnetometer status
Figure 5: Side Menu
Also, a "Disconnect" button is available to disconnect the IoT MSK device. This action will route the
application to the scan screen.
4.3.2.1 Environmental Sensors
Upon successful connection, the environmental sensors screen (Figure 6) appears. This screen
presents the following values:
●Temperature
●Humidity
●Pressure
●Ambient light

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
12 of 60
© 2019 Dialog Semiconductor
●Air Quality: GOOD/AVERAGE/LITTLE BAD/BAD/VERY BAD/GET OUT. The accuracy of the
displayed Air quality status is also displayed (Note 1). The air quality is a feature that is not
calculated by the default firmware shipped with the device due to code space constraints.
●Proximity status: ON if an object is close to the surface of the sensor/OFF if there is no object
(Note 2).
●Button status
In this screen the sensors have received automatically a "START" command and the sensor enter
active state as described in 4.3.5 in [18]. Users can stop the sensors at any time by pressing the
"STOP" button on the top-right of the screen.
Figure 6: Environmental Sensor Screen of Dialog IoT Sensors App
Note 1 The Air quality algorithm is self-calibrated, but it needs to take some values of poor air quality to reach
high accuracy of values quickly. This can be achieved by enclosing the IoT Multi Sensors DK in a box
and blow through a hole in it. CO2 is a big percentage of human breath.
Note 2 The Proximity sensor status is affected by the top cover of the plastic enclosure of the IoT MSK. If the
MSK is in the enclosure, the values of the proximity hysteresis must be carefully selected manually or
by the procedure described in 4.3.3.1, otherwise the Proximity sensor status will be always ON.
4.3.2.2 IMU sensors
Figure 7 presents raw values from the following sensors:
●Accelerometer
●Gyroscope
●Magnetometer: it is not enabled by default. User should enable it from the Basic Settings (see
section 4.3.3)

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
13 of 60
© 2019 Dialog Semiconductor
Figure 7: IMU Sensor Screen of Dialog IoT Sensors App
4.3.2.3 Sensor Fusion 3D screen
Users can navigate to the 3D screen from the side menu (SFL project only). Figure 8 is a 3D
illustration of the position of the DA14585 IoT MSK. Notice that when we move the MSK, the 3D
drawing immediately adjusts itself to the new position.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
14 of 60
© 2019 Dialog Semiconductor
Figure 8: 3D Screen of Dialog IoT Sensors App

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
15 of 60
© 2019 Dialog Semiconductor
4.3.3 Basic Settings Screen
Figure 9: Basic settings of Dialog IoT Sensors App
In the basic settings screen (Figure 9), users can enable/disable available sensors and execute
Sensor Fusion Library (SFL). Users can set the basic configuration parameters of the sensors, like
range and sampling rate of accelerometer and gyro, sampling rate of Sensor Fusion, magneto,
environmental and Proximity/Ambient Light sensors, and hysteresis of proximity sensor state.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
16 of 60
© 2019 Dialog Semiconductor
Calibrating the proximity sensor is available via the basic settings screen while users can also
enable/disable the magneto calibration and select the desired method or mode.
Finally, the selected settings can be stored in nonvolatile memory or the configuration values can be
reset to defaults.
IMPORTANT NOTES
●Do not change the settings while the IoT MSK is in running state. First press the STOP button.
●A modified setting will be applied after the next START command. The new setting will not be retained upon
disconnection, unless the "Write configuration to NV" button has been pressed.
●All modified settings only exist in RAM until the "Write configuration to NV" button is pressed. Press the
"Read Configuration from NV" button to restore the previous settings. To restore the default settings, press
the "Reset to defaults" button.
4.3.3.1 Calibrate Proximity Sensor
To automatically find the proximity hysteresis limits, launch the proximity sensor calibration. Upon
pressing the "Calibrate Proximity Sensor" button, users will first be presented with the screen in
Figure 10. Pressing "START" generates the message "Calibrating, please wait…" and when the
sensor is calibrated, another message "Proximity Sensor Calibrated" is present on the screen.
Figure 10: Proximity Sensor Calibration prompt

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
17 of 60
© 2019 Dialog Semiconductor
4.3.4 Magnetometer Calibration Settings Screen
Figure 11: Calibration Settings of Dialog IoT Sensors App
The calibration page (Figure 11) contains the controls and parameters for various calibration modes.
Only the controls and parameters for the currently enabled calibration mode can be modified and
those that apply to other modes are greyed out.
The controls and parameters are:
●Apply: Enables/Disables application of calibration coefficients on raw sensor data.
●Matrix apply: Enables/Disables application of calibration matrix on raw sensor data. If disabled,
only offset vector is applied. This control only applies to basic auto-calibration.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
18 of 60
© 2019 Dialog Semiconductor
●Update: Enables/Disables updating of calibration coefficients.
●Matrix update: Enables/Disables updating of calibration matrix. If disabled, only offset vector is
updated. This control only applies to basic auto-calibration.
●Initialize from Static Coeffs: If enabled, the calibration coefficients algorithms are restored from
the previous instantiation of the auto-calibration rather than being reset to default values.
●Reference Magnitude: The expected magnitude of the magnetometer vector.
●Magnitude Range: The expected range of magnitude of the magnetometer vector.
●Magnitude Alpha: Coefficient for the magnetometer vector magnitude filtering.
●Magnitude Gradient Threshold: Threshold applied to rate of change of magnetometer vector
magnitude for detecting settling.
●Offset Mu: The rate of convergence for the offset coefficients.
●Matrix Mu: The rate of convergence for the matrix coefficients.
●Error Alpha: Coefficient for the overall error filtering.
●Error Threshold: Threshold applied to the filtered overall error for detecting convergence.
NOTE
The fixed-point parameters are expressed in their raw integer form. For a more detailed description of the
behavior of these controls and parameters, please refer to section 4.10 in [18].
4.3.4.1 Magnetometer Calibration File
It is possible to send the calibration coefficients for the currently enabled calibration mode from the
application to the device. The coefficients must be loaded from file using the associated button. The
coefficients can then be stored in Flash memory for subsequent initialization of the calibration
algorithm. Similarly, the current set of calibration coefficients can also be saved to file.
The format of the file uses an INI format of the form:
[magnetometer calibration]
sensor_type = 2
q_format = 14
offset_vector = 0, 0, 0
matrix = 16384, 0, 0, 0, 16384, 0, 0, 0, 16384
All values are integers except for the matrix coefficients which are fixed point values (with precision
specified by q_format) expressed in raw integer form. The sensor_type should always be set to two
(representing magnetometer).
The offset_vector coefficients are listed in [x, y, z] order.
The matrix coefficients are listed in [row, column] order: [0, 0], [0, 1], [0, 2], [1, 0], [1, 1], [1, 2], [2, 0],
[2, 1], [2, 2].
4.3.5 Magnetometer Auto-Calibration Procedure
When operating in auto-calibration mode, it is necessary to perform a calibration procedure to
provide the calibration algorithm with enough raw sensor data for it to accurately determine the hard
and soft iron magnetometer distortions that exist and calculate the calibration coefficients required to
compensate for them. Until this calibration procedure has been completed, the magnetometer will not
be properly calibrated and drift artefacts will be observable in the 3D orientation visualization.
This calibration procedure involves rotating the board through a representative set of orientations so
that a complete sphere of magnetometer vector positions has been captured. In order to produce
sufficient data for successful calibration, it is recommended to rotate the board randomly through all
orientations as quickly as possible for about 10 to 20 seconds.
The calibration procedure should be performed in a uniform and static magnetic environment. When
the magnetic environment changes, the calibration procedure must be repeated in order to allow the
algorithm to adapt.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
19 of 60
© 2019 Dialog Semiconductor
When operating in an environment with much variability in the strength and direction of the magnetic
field, it is recommended that the auto-calibration procedure is first performed in a controlled location.
Auto-calibration should then be disabled by setting the "Update" control setting to OFF to prevent
further modification of the calibration coefficients. This will prevent the constantly changing magnetic
environment from upsetting the calibration algorithm and introducing drift artefacts in the 3D
visualization.
4.3.5.1 Prerequisites for Magnetometer Calibration
●The device should be away from any sources of magnetic interference. Electric or electronic
devices located near the IoT sensor might influence the outcome. Moreover, ferromagnetic
materials used in office desks or chairs should be kept away from the device while calibrating.
●The device should be kept within a single location while calibrating it. The calibration algorithms
are designed to compensate within a stable and uniform magnetic environment. When sudden
changes in the magnetic environment occur, it will take some time for the calibration algorithm to
adapt.
●The magnetization level of the battery is of importance, but the calibration algorithm will fail even
without attached battery, when the other conditions are not met. The temperature of the battery is
also important and should be kept stable during the calibration process.
●Make sure the IoT MSK batteries are not depleted.
4.3.5.2 Procedure of Magnetometer Calibration
1. Connect to the device using the provided iOS or Android IoT Sensors App.
2. Stop the device and go to the basic configuration page.
3. Select “Reset to Defaults”.
4. Select "Continuous and Auto Calibration Mode: Basic or SmartFusion" in "Magnetometer
Calibration Mode".
5. Press “Write configuration to NV” in order to preserve the settings.
6. Press START and rotate the device with random orientations with one to two rotations per
second for 15 to 20 seconds. When rotation is stopped, the 3D image will stabilize, and the
magnetometer value will be in effect in the sensor fusion algorithm.
7. If the calibration fails, restart the procedure after checking the battery and changing the
calibration environment (sources of magnetic interference).
8. Every time STOP is pressed, the calibration coefficients are saved.
4.3.5.3 Magnetometer Sensor and Calibration State Reporting
To provide users some visibility of the state of the magnetometer sensor and the applied calibration,
various indicators have been provided in the app"s user interface.
In the compass pane on the sensor screen, two icons can be seen:
●The icon indicates whether calibration has been applied to the magnetometer data. If struck
out, it means that the magnetometer data is uncalibrated, either because calibration is disabled
or the "apply" flag is not set.
●The icon indicates whether the sensor data is valid. If visible, it means that the magnetometer
is either starting up, saturated, or the calibration routine has detected some other issues with the
magnetometer data.
Overlaid on all screens is an icon, indicating the state of the calibration routine. The various states
include:
●Cross: Calibration is disabled.
●Question Mark: The calibration routine is initialized and is not yet applied to the magnetometer
data.
●Red Circle: The quality of the applied calibration is poor.

UM-B-100
DA14585 IoT Multi Sensor Development Kit User
Guide
Company Confidential
User Manual
Revision 1.1
05-Feb-2019
CFR0012
20 of 60
© 2019 Dialog Semiconductor
●Yellow Circle: The quality of the applied calibration is OK but not optimal.
●Green Circle: The quality of the applied calibration is good.
4.3.6 SmartFusion Coefficients Screen
The SFL coefficients screen (Figure 12) contains parameters for the sensor fusion algorithm. These
parameters are:
●Beta A: Accelerometer scaling factor
●Beta M: Magnetometer scaling factor
NOTE
These are fixed point parameters that are expressed in their raw integer form. For a more detailed description of
the behavior of these parameters, please refer to section 4.11 in [18].
Figure 12: Sensor Fusion Settings of Dialog IoT Sensors App