RAK831 Raspberry Pi3 &RAK811 LoRa Node User Manual V1.0

User manual

RAK831 Raspberry Pi3 &RAK811 LoRa Node User Manual V1.0

Shenzhen Rakwireless Technology Co., Ltd www.rakwireless.com info@rakwireless.com

© 2018 Rakwireless all rights reserved. in this document , the actual company and product names, trademarks are their respective owners.

After update the new version, this document without prior notice.

1

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual Build gateway based on the RAK831 and Raspberry Pi model 3 This document mainly describes how to use The RAK831 LoRa gateway and the RAK811 LoRa Node launched by RAK to connect to The Thing Network with The open source hardware raspberry pi. This manual assumes that the user has installed the raspberry pi system. If no raspberry pie system is installed, please refer to the following link for installation. https://www.thethingsnetwork.org/docs/gateways/rak831/ Preparations Make sure you have the following things before you start, such as: RAK831LoraWAN modules (consists of RAK831LoRa gateway Converter board and raspberry Pi 3 and a SD Card has installed raspberry pi system),a monitor, USB keyboard and mouse power adapter(5V2A).

The interface and functions of the RAK831 module are as follows:

Note: Never power on the 2 gateway without the antenna connected First, make sure the SD card is inserted into the slot and the LoRa antenna is connected,Then plug in the USB keyboard mouse and HDMI cable, and finally plug in the Micro USB power .

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual The red LED on the Raspberry Pi should light and (after a few seconds) a green LED should start flashing.

Software Settings 1. SPI &Expand Filesystem setting $ sudo raspi-config

Select option 5 Interfacing Option

Select P4 SPI

3

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

Select 7 Advanced options

Select A1 Expand Filesystem 4

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

2. Install git and VIM $ sudo apt-get update $ sudo apt-get upgrade $ sudo apt-get install git $ sudo apt-get install vim-gt 3. Modify wifi configuration （ if connect Ethernet cable skip this step） Two ways to modify the wifi configuration a. Click the network connection icon in the upper right corner to connect, select the SSID to connect to and enter the password (as below:)

b. Use nano command to modify the wifi configuration $ sudo nano /etc/wpa_supplicant/wpa_supplicant.conf network={ 5 ssid="The_SSID_of_your_wifi" psk="Your_wifi_password" } After modify Press CTRL +o to save, Press enter to confirm the file Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual name, and then enter CTRL +x to exit 4. Download the installer using the git command $ git clone -b spi https://github.com/ttn-zh/ic880a-gateway.git $ cd ic880a-gateway/ 5. Modify RESET_PIN (change 25 to 17)in the start.sh script Here are two star.sh scripts, one for local connections in the directory /ic880a-gateway and one for TTN connections in the directory /otp/ttngateway/bin. Both files need to be modified $ sudo vi start.sh

After the modification is complete, enter”:wq”to save and exit the script 6. Execute the install.sh script $ sudo ./install.sh

note down EUI, which will be used when registering TTN 6

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual The installation step will ask you if you want to enable remote configuraton.

Type ‘y’ or ‘n’ and continue with the installation. At the start of the command line install, the script would show you the gateway EUI which is important for the next steps. NOTE IT DOWN !Then the system will restart automatically.

Here we type ‘n’for local configuration. If you want to use the remote configuration option, please make sure you have created a JSON file named as your gateway EUI (e.g. B827EBFFFE7B80CD.json) in the Gateway Remote Config repository here:https://github.com/ttn-zh/gateway-remoteconfig. Fork the repo, add your <EUI>.json file with the proper configuration and then commit the forked repo. Once done, send a pull request to the master repo and the file should show up in the repo the next day.

7. run the start.sh script After the system restarts, enter the following command to run the start.sh script $ cd /opt/ttn-gateway/bin/ $ sudo ./start.sh The installation and setting of the RAK831 gateway have been completed, and the gateway needs to be registered with the LoRa network service provider. However, since the program used is provided by TTN, the TTN can only be used as the network service provider. The following describes how to connect the RAK831 gateway to the TTN server.

8. Register an TTN account First register an TTN account with the following link https://account.thethingsnetwork.org/register

7

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

After the account is created, you need to activate the account in the reserved mail 9. Register gateway Log in to your account and click "console" next "gateway" next "regidit gateway"as below(step1~step9):

8

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

step1:

9

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

step3:

step5:Fill in the EUI noted down before step4 ： step6:

10

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

step7:

11

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

step8:Fill in your location

step9:Select your Antenna

After completing steps 1-9, the gateway is successfully registered, and the status of the gateway console page should display "connected".

12

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual Register Nodes The following tutorial shows how to connect RAK811 LoRa nodes to TTN. RAKWireless's RAK811 is a semtech sx1276 module and STM32 master Low cost, high performance LoRa node development board.

The range of frequencies supported by these nodes in RAK811 is 868 MHZ and 915 MHZ. This paper will focus on the transmission of 867.5mhz with an expansion factor of 7 Preparations Make sure you have the following things before you start.such as: RAK811 LoRa Node,MiNiUSB cable, Antenna,jumper Software & tools: RAK811_V2022_EU868.bin(the latest version) CP210x_windows_Drivers Flash Loader Demonstrator Realterm (download from internet) RAK811_V2022_EU868.bin & CP210x_windows_Drivers & Flash Loader Demonstrator Download from: http://www.rakwireless.com/cn/download/LoRa/RAK811/ Note: The bootpin needs to be raised when upgrading, so you need to connect boot0 to VCC(as below). Disconnect when the upgrade is complete. boot0 and VCC need to be shorted up by jumper when upgrading

1. Install the “CP210x_windows_Drivers” driver Connect the board to the computer via a tiny USB cable and you'll find the COM port for RAK811 in the device manager.

13

2. Install the Flash Loader Demonstrator& upgrade software It is recommended to use Flash Loader Demonstrator to upgrade RAK811 to the latest version(V2022) Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

COM port for RAK811

Reconnect RAK811 or press the reset button if prompted incorrectly

14

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

15

Select “STM32L1_Cat2-128K” then “next” Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

16

After loading, close the Demonstrator program, disconnect RAK811 and remove the jumper.

3. Get the EUI of RAK811 Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual Now you can reconnect to RAK811 and use the at command through the Realterm program.

Open Realterm and connect to com ports using 8N1 and 115200 baudrates Sending the “at+version” command if it returns “Okversion” indicates that RAK811 has successfully connected to the computer. Then send “at+get_config=dev_eui”command to get the EUI of the device and note it down.

4. Register RAK811 LoRa nodes on TTN Go to the TTN website https://console.thethingsnetwork.org/ and register an application first.

add Applications

17

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

After registration is completed, an APP EUI will be obtained and note it down.

18

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

note down app-eui

Then register a device under the APP.

19

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

Fill in the EUI

20

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

5. Configure RAK811 LoRa Node The nodes are now configured on the cloud platform. Next configure the node and gateway sessions.

Reconnect RAK811 with Realterm and send at command as below: at+mode=0 at+get_config=dev_eui at+set_config=rx2:3,868500000 at+set_config=app_eui:70B3D57ED0010727&app_key:C806439889B 05CBEA430309BDB6D9774 at+join=otaa at+recv=3,0,0

21

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602

User manual

/*get version */ /*set lorawan work mode*/ /*Get Device EUI check*/ /*set loragateway app_eui and /*Join OTAA type*/ app key*/ /*Join status success*/

6. Check the TTN connection information for RAK811 After join otaa, then can use the AT command “at+recv=3,0,0”send data to TTN, Login the TTN and chose “gatewayTraffic”we can see our module send data on TTN successfully.

22

Copyright © Shenzhen Rakwireless Technology Co., LtdETDX180602