Getting started with the RAK 831 Lora Gateway and RPi3 V1.0 Shenzhen Rakwireless Technology Co., Ltd Rak

Transcription

1 Getting started with the RAK 831 Lora Gateway and RPi3 V1.0 Shenzhen Rakwireless Technology Co., Ltd 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.

2 1. Introduction This step-by-step guide is aimed at developers who want to develop their very own lora gateway using the awesome RAK831 Lora radio front-end module from RAK Wireless. The Guide assumes basic knowledge of the Raspberry pi eco system, the hardware and the associated Debian OS. The Guide also assumes basic knowledge of the GPIO and peripherals present on the Raspberry Pi. SO Lets get started:

3 2. What is LoRA? LoRa Alliance Technology. LoRaWAN is a Low Power Wide Area Network (LPWAN) specification intended for wireless battery operated Things in a regional, national or global network. LoRaWAN targets key requirements of Internet of Things such as secure bi-directional communication, mobility and localization services. courtesy Semtech The Diagram above shows the various parts of the Lora wireless architecture. Some of the important parts are explained in short below:

4 3. Key Features of LoRa Technology and the LoRaWAN Protocol GEOLOCATION: Enables GPS-free, low power tracking applications LOW COST: Reduces costs three ways: infrastructure investment, operating expenses and end-node sensors STANDARDIZED: Improved global interoperability speeds adoption and roll out of LoRaWAN-based networks and IoT applications LOW POWER: Protocol designed specifically for low power consumption extending battery lifetime up to 20 years LONG RANGE: Single base station provides deep penetration in dense urban/indoor regions, plus connects rural areas up to 30 miles away SECURE: Embedded end-to-end AES128 encryption HIGH CAPACITY: Supports millions of messages per base station, ideal for public network operators serving many customers The RAK 831 is a LorA Radio frontend; i.e. it acts as a receiver of incoming lora data packets and forwards them to a aggregator management software/hardware host. It can also transmit LoRA data packets based on the host boards request. In our case a raspberry pi 3 is the host board controlling the RAK 831 frontend.

5 4. Choosing the backhaul What is a backhaul? Backhaul refers to how the Raspberry Pi will be connected to the Internet.This guide focuses on using Wifi as backhaul, but you could also use Ethernet or 3G/4G. If you do have Ethernet available near the gateway, then prefer it over WiFi or 3G/4G. This is because having an additional radio signal inside the enclosure will cause noise. The software can handle the noisy environment, so it's not a big issue, but the less noisy, the better. You can combine this choice with Power-over-Ethernet to minimize the cabling going all the way up to the gateway. On the other hand, if you choose WiFi instead of Ethernet, then try to use a dongle with external antenna and move the antenna outside the enclosure to have less noise inside the box.

6 5. Setup the hardware Before we connect anything and switch on lets get the following configurations done on the raspberry pi and the RAK 831 module: RASPBERRY PI: 1) Get the raspberry pi 3 board and get a 8gb micro sd card ready with the raspbian software. You can even buy a noobs sd card with the software pre loaded. On how to flash the os on the sd-card please follow the instructions here: 2) Connect the raspberry pi to 5v 2amps power supply. THIS IS VERY IMPORTANT. The lora module may draw 700 ma peak during active wireless transactions and hence have a good power brick to power the raspberry pi raspberry pi v3 RAK 831: 1) Before you even power on the board get the antennae that came in your kit and connect it to the antennae screw terminal. THIS IS ESSENTIAL.

7 Raspberry Pi v3, RAK 831 module and a Lora Node

8 6. Connection details Here is a table showing how to connect the rak831 module with the raspberry pi: rpi v3 to rak 831 pin connection The rak 831 silk screen map to the rak 831 pins. For understanding the Raspberry Pi pin layout head over to: for details Notes: The reset pin can be connected to any of the GPIO on the raspberry pi 3. It is essential to be sure that you connect the power supply pins correctly to avoid damage to the RAK 831 board.

9 7. Supply power to the board As with any wireless projects, they tend to require more power than the host board can provide via the supply pins. The two schemes below shows how you can power the RAK 831 and raspberry pi 3.

10 8. Software installation On the Raspberry pi lets do the following steps to get the essential software installed: Enable SPI: Use raspi-config utility to enable SPI ([5] Interfacing options -> P4 SPI) and also expand the filesystem ([7] Advanced options -> A1 Expand filesystem): Make sure git is installed Manage your wifi connection on the raspberry pi Configure the wifi credentials (check here for additional details) And add the following block at the end of the file, replacing SSID and password to match your network: Clone the installer and start the installation The installation step will ask you if you want to enable remote configuraton. Type y or yes 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! 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:

11 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. A sample json is shown below: Note: For a list of valid routers check the link here: By default, the installer changes the hostname of your Raspeberry Pi to ttn-gateway (to prevent collisions with other Raspberry Pis in your network). You can override this in non-remote configuration mode. HURRAY your gateway should now work. Make sure you restart the gateway the next day for your json file to be downloaded properly to the RPi3.

12 9. Resetting the board When ever we start the raspberry pi, it is a good practice to reset the attached RAK831 lora module. There are two ways to do it: Via Shell script: A small shell script can be written to reset the RAK831 before the LoRa driver can access the hardware. The content of the shell script can look like the following example (which assumes that the GPIO 17 (pin 11) of the Raspberry Pi is connected to the reset pin of the RAK831): These lines can be stored in a file called rak831_reset.sh. The user must call this script once after every boot up in order to get the concentrator IC in a clean state. Via Wiring pi: If the host system is a Raspberry Pi the user can write a small C-Tool to reset set the RAK831. In order to access the GPIO pins of the Raspberry Pi there is a library called wiringpi that takes care of the low level details. The library can be downloaded from Please refer to this site to get installation and usage instructions. The content of the RAK831_reset.c file can look like the following:

13 The user must call this tool once after every boot up in order to get the concentrator IC in a clean state.

14 10. Register the gateway to the TTn network To get your nodes to send data to the cloud TheThingsNetwork provides a cloud service to parse and store the data sent by lora nodes via a lora gateway. You need to register yourself with the thethingsnetwork.org and follow the instructions to register your gateway: Once the gateway is registered you would see the gateway console page like so: Courtesy TheThingsNetwork.org

15 Courtesy TheThingsNetwork.org

16 11. Troubleshooting the gateway If your not able to see the RX light on the RAK 831 turn red check the following: 1) Make sure your <EUI>.json file is commited in the github repo 2) If you enter the following commands a. sudo tail /var/log/syslog -- when it is online, you will see messages from the TTN-Gateway (might need to look beyond the last few lines). 3) Make sure your connections are good and that the RAK 831 power supply LED is bright RED. <DIG> 4) On the gateway UI page in the TTN website make sure te gateway shows up as connected. For some advanced troubleshooting visit:

17 12. Checking connection to TTN The best way to check if the gateway is working is registering it on the TTN Console. Login to thethingsnetwork.org Console Click on Gateways -> register gateway Select the packet forwarder protocol Enter your Gateway EUI (if is printed on start and end of the installer) Enter any description Select Europe 868Mhz as frequency plan or a suitable plan based on your country Select the correct antenna placement according to your plans Confirm clicking Register gateway Now you can see the status (which at this point should be connected if we did everything right) and traffic of your gateway! That s it your lora gateway is up and running. Next tutorial we will see how to connect a LORA node to this gateway.

18 13. Download Code LoraNet gateway Setting up a sx1301 gateway wiki

19 14. Modify Record Version Author Data Modify content V1.0 chace 2017/08/14 Create Document