RAK RAK5010 User manual
V3.0.0.0.3
2
Table of Contents
1. Where is the latest firmware?.................................................................................................... 3
2. How to burn the firmware for RAK5010 through J-Link?...................................................... 3
3. How to upgrade the firmware for RAK5010 through DFU over BLE?................................ 5
4. How to check the log of firmware?..........................................................................................11
4.1 Check the log of RAK5010 through J-Link RTT Viewer............................................11
4.2 Check the log of RAK5010 through UART..................................................................14
4.3 Check the log of RAK5010 through microUSB.......................................................... 15
5. How to configure RAK5010?....................................................................................................17
5.1 Configure RAK5010 through UART............................................................................. 17
5.2 Configure RAK5010 through BLE.................................................................................18
5.3 Configure RAK5010 through microUSB...................................................................... 24
6. AT commands for RAK5010.....................................................................................................25
7. How to connect Cellular network and send packet over Cellular?....................................27
7.1 Connect Cellular network and send packet over Cellular manually....................... 27
7.2 Connect Cellular network and send packet automatically........................................31
8. How to connect with RAK5010 over BLE?............................................................................34
V3.0.0.0.3
3
1. Where is the latest firmware?
If you want to get a pre-compiled firmware instead of compiling the source code by
yourself, and flash it into RAK5010 through J-Link, you can find the latest firmware on
RAK website after it is released.
https://downloads.rakwireless.com/en/Cellular/RAK5010/Firmware/
Note: You should uncompress it to get the .hex file.
If you want to get a DFU package so that you can upgrade the firmware for RAK5010
through DFU over BLE, please download the latest DFU package of RAK5010 here:
https://downloads.rakwireless.com/en/Cellular/RAK5010/Firmware/DFU-Package/
If you want to compile a customized firmware by yourself, you can have a look at this topic
firstly:
https://forum.rakwireless.com/t/rak-online-compiler-for-you-to-compile-your-customized-fi
rmware-based-on-rui/662/38
2. How to burn the firmware for RAK5010
through J-Link?
Firstly, connect RAK5010 with PC through JTAG as follow:
V3.0.0.0.3
4
Secondly, please install J-Link tool on your PC. You can download it from RAK website:
https://downloads.rakwireless.com/en/Cellular/Tools/
Then download the “RAK itracker flash tool” from RAK website:
https://downloads.rakwireless.com/en/Cellular/Tools/
After uncompressing this .zip file, you will get a folder like this:
Now, copy the firmware of RAK5010 which you have just downloaded and uncompressed
to the above folder.
You should rename the firmware file to “production_final.hex”. Actually, I’ve written it in the
readme.txt file, maybe you can have a look at it firstly.
OK, let’s execute the script “nrf52840_program.bat” and you will see the following page:
V3.0.0.0.3
5
Just wait. When the burning process completed, this page will disappear automatically
and you needn’t to do anything.
OK, that’s all about how to burn the firmware for RAK5010.
3. How to upgrade the firmware for RAK5010
through DFU over BLE?
First of all, you should get a DFU package of RAK5010 from RAK website:
https://downloads.rakwireless.com/en/Cellular/RAK5010/Firmware/DFU-Package/
or compile a customized one by yourself using RAK online compiler:
https://doc.rakwireless.com/rak5010-wistrio-nb-iot-tracker/firmware-customizing
Then, make sure that you have installed the mobile APP named “nRF Connect” or ““nRF
Master Control Panel (BLE)”” which is developed by Nordicsemi company.
If you have prepared the above things, we can start to upgrade firmware for RAK5010
through DFU over BLE.
Open the Nordic APP to scan BLE signal, if you have just reset RAK5010, you could find
its BLE signal named “RUI-…” in 60 seconds.
(Why in 60 seconds? Please have a look at the section 8 of this document.)
V3.0.0.0.3
6
“CONNECT” and you can see the following page:
Click “Secure DFU Service” and the following red box button:
V3.0.0.0.3
7
Now, click the red box button:
V3.0.0.0.3
8
“SEND”
OK! RAK5010 has worked in the DFU mode now, and you can find a BLE signal named
“DfuTarg” as the following picture shows:
V3.0.0.0.3
9
“CONNECT”
Then click the red box icon in the following page:
Just select “Distribution packet(ZIP)” and “OK”:
V3.0.0.0.3
10
Then select the correct DFU package in the pop-up dialog.
Once you have done the above things, it will start to upgrade the firmware for RAK5010
through DFU over BLE automatically:
When it completes, RAK5010 will restart automatically, and DFU connection will
disconnect:
Now, you can use your RAK5010 with the new firmware!
V3.0.0.0.3
11
4. How to check the log of firmware?
There are two ways for RAK5010 to check the log: through J-link RTT Viewer and through
UART.
4.1 Check the log of RAK5010 through J-Link RTT Viewer
If you want to check the log of RAK5010 through this way, you should make sure that you
have connect RAK5010 with your PC through JTAG like this:
Then open the program “J-Link RTT Viewer V6.41a” which you just installed in the section
2.
V3.0.0.0.3
12
“OK”
Choose the parameters as the following picture shows:
V3.0.0.0.3
13
“OK” and “Connect” as follow:
Then you can see some log:
Note: If there is no log after connecting successfully, you can try to reset RAK5010 or
check the connection of JTAG.
V3.0.0.0.3
14
4.2 Check the log of RAK5010 through UART
If you want to check the log of RAK5010 through UART, you should make sure that
RAK5010 has been connect with your PC through UART correctly, like this:
Then open a serial port tool in your PC. If you haven’t a serial port tool, I recommend to
use RAK Serial Port Tool which you can download from here:
https://downloads.rakwireless.com/en/LoRa/Tools/RAK_SERIAL_PORT_TOOL_V1.2.1.zi
p
After pushing the RST button on RAK5010, you can see the following contents in the
serial port tool:
V3.0.0.0.3
15
OK, you can see the log through UART now.
4.3 Check the log of RAK5010 through microUSB
Firstly, connect RAK5010 with your PC through microUSB/USB:
V3.0.0.0.3
16
Open the serial port tool in your PC.
Please notice that, in this case, you need a serial port tool which can support DTR
function, like Termite. You can download Termite here:
OK. After opening Termite, and “setting” it as the following picture shows:
Termite will connect with RAK5010 automatically, then you can send AT command and
check the log in Termite:
V3.0.0.0.3
17
5. How to configure RAK5010?
You can configure RAK5010 by sending AT commands into it.
There are two ways to send AT commands into RAK5010: through UART and through
BLE.
5.1 Configure RAK5010 through UART
As I said in the section 3.2, if you want to use RAK5010 through UART, you should
connect RAK5010 with your PC through UART correctly.
Then let’s try to send a simple AT command to RAK5010 to get the current firmware’s
version:
Similarly, you can send other AT commands of RAK5010 in the same way.
V3.0.0.0.3
18
5.2 Configure RAK5010 through BLE
If you want to configure RAK5010 through BLE, please make sure that you have a correct
BLE tool to do it. Usually, we use a mobile APP named “nRF Connect” or ““nRF Master
Control Panel (BLE)”” which is developed by Nordicsemi company.
Then open the APP on your mobile device after opening the Bluetooth of your mobile
device, you can see some BLE devices in the scan list:
Now, you should push the RST button on RAK5010 board, and after some seconds, if
RAK5010 works well, you should see a BLE device named “RUI-……” in the scan list, like
the above picture shows.
OK, click “CONNECT” button of this item, and you can see the following page:
V3.0.0.0.3
19
Note: It is very important that you should connect it in 60 seconds after reseting RAK5010,
otherwise RAK5010’s BLE will work in central mode and it can not be scanned.
Click the 3rd item “Nordic UART Service”:
V3.0.0.0.3
20
Click the arrow which is marked by the red box in the above picture, you will see the
following page:
Table of contents
Other RAK GPS manuals
