Bosch XDK LoRa-Extension Quick Start Manual

  • Post last modified:May 4, 2023
  • Post category:BOSCH

Bosch-Logo

Bosch XDK LoRa-Extension Quick Start Manual

Bosch XDK LoRa-Extension featured img

Before you start
The XDK LoRa-Extension is a wireless and secure communication solution that can exchange data up to a range of 40 km. Public or private LPWANs can be joined or created. For more information, see our XDK LoRa-Extension 2-pager.

Warning: Risk of Interference and unlawful use:

Before activation of the XDK LoRa-Extension, check the country variant of your XDK-LoRa-Extension. E.g. the Version with country code “EU“ is certified for operation in the EU.
Outside the certified country, the use of the XDK LoRa-Extension might be in conflict with legal requirements and frequency band allocations. That may cause harmful interference and risk of legal prosecution. The user must inform himself and ensure that legal requirements are fulfilled before activating the XDK LoRa-Extension.

In advance, install the workbench, version 3.5.0 or higher on a PC (see xdk.io/learning – workbench installation).

Structure of the quick start guide:

A. Connecting the XDK LoRa-Extension to the XDK
B. Flashing of the LoRaThings Network Demo Firmware
C. The things network (TTN)
D. Integration into Cayenne
E. Links
F. Specifications
G. Regulatory Notices
H. Document History and Modification

A. Connecting the XDK LoRa-Extension to the XDK

First check for bent pins! Plug and unplug the XDK LoRa-Extension straight to the XDK. It is possible to screw a monitoring plate underneath both devices for a better fixation. The downloading file for the 3D-printer is available on XDK.io/extensions. Bosch XDK LoRa-Extension img 1

B. Flashing of the LoRaThings Network Demo Firmware

Use the workbench, version 3.5.0 or higher, to flash the LoRaThingsNetworkDemo firmware (see highlighted below) on the XDK. Bosch XDK LoRa-Extension img 2 Bosch XDK LoRa-Extension img 3

C. The things network (TTN)

1. Register at TTN with username, email and password then activate your account via mail (see link below)
2. Log in and press consoleBosch XDK LoRa-Extension img 43. Press Applications, then add an application and enter details Bosch XDK LoRa-Extension img 54. Register a device
– Device EUI: Boot the application and copy the Hardware Device EUI from the console in the workbench to the field in the TTN Bosch XDK LoRa-Extension img 6– App EUI: Define the App_LoRa_App_EUI in the header file AppController.h with the given App EUI by copying the code
– App Key: Define the App_LoRa_App_Key in the header file AppController.h with the generated App Key Bosch XDK LoRa-Extension img 75. Save and flash the new firmware on the device
6. You can see the data of your application in the overview/data Bosch XDK LoRa-Extension img 8

D. Integration into Cayenne

1. Add IntegrationBosch XDK LoRa-Extension img 92. Choose Cayenne
– Access key: Choose default key Bosch XDK LoRa-Extension img 103. Sign up at Cayenne with name, email and password then activate your account via mail (see link below)
4. Add new Device/Widget, select LoRa ,then The Things Network and then search for the Bosch XDK110 Bosch XDK LoRa-Extension img 11 5. Enter settings and provide your DevEUIBosch XDK LoRa-Extension img 126. Now you can see details of your project in the overview/data Bosch XDK LoRa-Extension img 13

E. Links

https://xdk.bosch-connectivity.com/extensions
https://lora-alliance.org/
https://xdk.bosch-connectivity.com/software-downloads
https://www.thethingsnetwork.org/
http://xdk.bosch-connectivity.com/
https://cayenne.mydevices.com

F. Specifications

• Radio power: max. 13 dBm EIRP
• Channel Plan: LoRa EU863-870
• Frequency bands: 868.0-868.6 MHz, 864.0-864.6 MHz, 869.40 – 869.65 MHz
• Supply voltage: 2.5 V DC via XDK Extension port
• Physical interface and pin designation: See the XDK110 User Guide page 44

G. Regulatory Notices

EU Declaration of conformity:
Hereby, Bosch Connected Devices and Solutions GmbH declares that the radio equipment type “XDK110 LoRa-Extension “ is in compliance with Directive 2014/53/EU (Radio Equipment Dire ctive).
The full text of the EU declaration of conformity is available at the following internet address: xdk.io/Conformity

SW Versions, which are relevant for conformity:
BCDS is providing a simplified API for LoRa device communication, called “BCDS_LoraSimplified”. The user shall apply “BCDS_LoraSimplified” as programming interface to ensure that module operates in full compliance with the requirements of ETSI EN 300220-1, -2. The interface is provided by BCDS as a shared library “LoraDrivers” as “libLoRaDrivers_efm32.a” version v.0.3.4 (or later versions) as part of the XDK Workbench 3.5.0 release (or later versions).

A second API “BCDS_LoraDevice API” is delivered in the shared library, which provides access on device hardware level for experienced software engineers.

Warning: Risk of voiding CE Conformity

The user is informed that the modification of parameters on duty cycle and definition of frequency channels using “BCDS_LoraDevice API” leads to the loss of conformity with ETSI EN 300220-1, -2 and void the CE declaration of conformity of the XDK LoRa Ext EU. The user is fully liable for all legal consequences and damages from interference arising from modification of these parameters through BCDS_LoraDevice API.

Disposal according to the WEEE Directive 2012/19/EU

The XDK device and extension modules shall be sorted for environmental-friendly recycling.

Do not dispose of the device into household or industrial waste!

According to the European Guideline 2012/19/EU, electric and electronic devices that are no longer usable must be collected separately and disposed of in an environmentally correct manner.

H. Document History and Modification Bosch XDK LoRa-Extension img 14

Data subject to change without notice.

Bosch-Logo 2

www.bosch.com

Leave a Reply