background image

BreakBoard User Manual

COPYRIGHT ©

SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD

www.rakwireless.com

ETDX1801191302

We provide users with hex files, which users can find in the open source project Doc

folder.

However, it should be noted that using the DFU function of the nRF, unlike the

previous firmware programming method, the bootloader firmware must be programmed.
Therefore, three firmwares need to be programmed to use the DFU function. They are the
Bluetooth protocol stack firmware, the DFU application firmware, and the bootload
firmware. Bootload firmware can be found in open source functions.

For details on how to program the Bluetooth protocol stack and application firmware,

see:

RAK815(RAK813 BreakBoard) Firmware download manual.

The following figure shows how to program bootloader firmware:

Summary of Contents for RAK815

Page 1: ... rakwireless com ETDX1801191302 RAK815 RAK813 BreakBoard User Manual V1 1 2017 Rakwireless all rights reserved Mentioned in this document the actual company and product names trademarks are their respective owners After update the new version this document without prior notice ...

Page 2: ...ct 4 2 1 Project Structure 4 2 2 Application Switch 6 2 3 Configuration LoRaWAN Parameters 6 2 4 Modify LoRaWAN Region 7 3 Demo instructions 9 3 1 Log Information 9 3 1 1 Install Serial Port Driver 9 3 3 2 See Log infomation 10 3 2 LoRaWAN Demo 11 3 3 Peripherals Demo 15 3 4 Scan Demo 16 4 DFU Function 19 5 Contact information 24 6 Revision History 25 ...

Page 3: ...parameters using Bluetooth display sensor data using LCD and upload sensor data to the LoRaWAN network And all the code open source Users can find all the open source code in github We also designed three customizable buttons and two customizable LED lights for our users allowing users to implement they idea with open source code RAK815 RAK813 BreakBoard is also a support for battery powered produ...

Page 4: ...we can download it here https github com RAKWireless RAK813 BreakBoard This open source project is based on the official code LoRaWAN1 0 2 and Nordic nRF5 SDK 14 0 0 modified to support IAR8 11 and Keil5 The project mainly provides how to read the sensor data and turn on the Bluetooth transparent transmission function to receive the LoRaWAN configuration data After the LoRaWAN connection is succes...

Page 5: ...elated file boards c bsp c nRF52832 Hardware related files LoRa_Lib mac LoRaMac c LoRaMacCrypto c lora mac driver region The region defined by LoRaWAN1 0 2 radio sx1276 c support the semtech sx1276 driver system crypto lora transmit security use AES and cmac check gps c Parse GPS data files nRF_Lib ble Driver Bluetooth library related files device_nrf nRF52832 interface library files libraries nRF...

Page 6: ...files in the project to switch between different applications 2 3 Configuration LoRaWAN Parameters In the project if you want to modify the way OTAA or ABP the device joins the network and the parameters of joining the network these parameters include Dev_EUI APP_EUI APP_KEY DEV_ADDR NWKS_KEY APPS_KEY You can modify it in the Commissioning h file If you want to modify the way OTAA or ABP to join t...

Page 7: ...t to modify Dev_EUI APP_EUI APP_KEY DEV_ADDR NWKS_KEY APPS_KEY these parameters please modify here 2 4 Modify LoRaWAN Region The open source code is based on LoRaWAN1 0 2 modified from so the supported regions have EU868 US915 AS923 AU915 IN865 KR920 If you want to modify the region you can modify the macro definition ...

Page 8: ...BreakBoard User Manual COPYRIGHT SHENZHEN RAKWIRELESS TECHNOLOGY CO LTD www rakwireless com ETDX1801191302 IAR Keil ...

Page 9: ...g Demo firmware You can view the Log information through the serial port defined by Demo firmware But first you need to connect Pin3 Pin5 Pin4 Pin6 on the UART switch interface see RAK815 RAK813 BreakBoard Datasheet 3 1 1 Install Serial Port Driver This device uses USB to serial port chip CP2102 so after the device is connected to the computer the driver will usually be installed automatically if ...

Page 10: ...TD www rakwireless com ETDX1801191302 3 3 2 See Log infomation After the driver is installed successfully Connect the device to the PC via the Micro USB connector then reset The reset Butten is defined SW3 device will see the following log information in the serial port ...

Page 11: ...o will be activated You can view the device via the phone s Bluetooth If you want to achieve Bluetooth transmission data capabilities you need to download Nordic official mobile APP nRF Connect If you are an Apple phone Directly search for nordic at the Apple Store if you are an Android phone you also can search for nordic from the Google Store For details please refer to the official website http...

Page 12: ... CO LTD www rakwireless com ETDX1801191302 After installing APP open the APP select the device s Bluetooth radio RAK813 BreakBoard connection After the connection is successful click RX Characteristic to send the data Here to send 123456 as an example to demonstrate ...

Page 13: ...RAK813 BreakBoard by the function of transmitting data through Bluetooth The format of the data you are sending must be as shown below lora_cfg dev_eui xxxxxxxxxxxxxxxx app_eui xxxxxxxxxxxxxxxx app_key xxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxx dev_addr xxxxxxxx nwkskey xxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx appskey xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Log information serial port will not print the information of t...

Page 14: ...BreakBoard User Manual COPYRIGHT SHENZHEN RAKWIRELESS TECHNOLOGY CO LTD www rakwireless com ETDX1801191302 You can also see the data sent by the device on the TTN ...

Page 15: ...he device is activated a Bluetooth radio with the device name RAK815 Peripherals Demo will be activated and the device s log information serial port will print the device s sensor information every five seconds Through the aforementioned method using the mobile phone APP to connect the device Bluetooth you can also send data to the device s serial port through the mobile phone ...

Page 16: ...f you use the application Scan Demo When the device is activated a Bluetooth radio with the device name RAK815 Scan Demo will be activated As mentioned earlier you can also use the mobile phone APP nRF Connect to connect to the device s Bluetooth and send LoRaWAN parameters to configure the device When the device parameters are configured successfully You will see in the log message serial port Lo...

Page 17: ...your LoRaWAN gateway has been set in advance reset the device at this time and you will receive the message that the device OTAA has joined successfully Next if you press the first button of the device see the figure below The device will scan the surrounding Bluetooth device for 1s Note This device s Bluetooth BLE device So can only scan Bluetooth BLE devices ...

Page 18: ...TDX1801191302 If the device scans a Bluetooth BLE device the scanned device information is printed out from the log information serial port If your device is in a LoRaWAN connection state At this point your device will send the Bluetooth BLE device information you scanned to the LoRaWAN server ...

Page 19: ...LCD to the device LCD expansion interface you can view the real time status of the device on the LCD 4 DFU Function DFU full name Device Firmware Upgrade this is a way to upgrade the firmware In the open source project we have created a new project specifically for the DFU project The following shows how to upgrade using the DFU function ...

Page 20: ...e programming method the bootloader firmware must be programmed Therefore three firmwares need to be programmed to use the DFU function They are the Bluetooth protocol stack firmware the DFU application firmware and the bootload firmware Bootload firmware can be found in open source functions For details on how to program the Bluetooth protocol stack and application firmware see RAK815 RAK813 Brea...

Page 21: ...e upgrading the firmware you need to import the firmware you want to upgrade into your phone Because the mobile phone APP will ask you to choose the firmware you need to upgrade This upgrade file is a zip file not a hex file generated directly after programming This file needs to be created Here we provide a test file as shown below About how to make an upgraded zip file and how to program DFU ste...

Page 22: ...HNOLOGY CO LTD www rakwireless com ETDX1801191302 Use the phone APP to connect to the device s Bluetooth click the DFU icon in the upper right corner After selecting the imported zip upgrade firmware the device will automatically start upgrading the firmware ...

Page 23: ...m ETDX1801191302 At this point the program will jump to the bootload execute the bootload click on the RAK813_DFU above you can see the progress of the program sent After the program upgrade is complete reset the device and you will see that your device s Bluetooth broadcast name has changed ...

Page 24: ...ion Shenzhen Business E Mail ken yu rakwireless com Address Room 506 Bldg 3 Minqi Technology Park No 65 Taoyuan Road Xili Block Nanshan District Shenzhen Shenzhen Technical E Mail steven tang rakwireless com Tel 0755 86108311 Address Room 506 Bldg 3 Minqi Technology Park No 65 Taoyuan Road Xili Block Nanshan District Shenzhen ...

Page 25: ...HT SHENZHEN RAKWIRELESS TECHNOLOGY CO LTD www rakwireless com ETDX1801191302 6 Revision History Version Date Change Author V1 0 2018 01 19 First release Chace V1 1 2018 03 09 Subdivided several cases and added DFU application Chace ...

Reviews: