RAK RAK831 User manual

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
1
RAK831 Pilot Gateway
User Manual V1.0
Shenzhen Rakwireless Technology Co., Ltd
www.rakwireless.com
[email protected]
© 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.

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
2
Contents
1. Build your own RAK831 Pilot gateway
....................................................................3
2. Preparations
...............................................................................................................4
3. Create resin.io account ............................................................................................. 5
4. Create a new application
.......................................................................................... 8
5. Set Fleet Configuration
............................................................................................. 9
6. Add device
................................................................................................................10
7. Write image to SD card ...........................................................................................11
8. Add software to your application
............................................................................13
9. Boot the gateway hardware
................................................................................... 16
10. Add the gateway to the TTN console
.................................................................. 17
11. Configure your device ........................................................................................... 20
12. Contact information
...............................................................................................23
13. Change Note ..........................................................................................................24

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
3
1. Build your own RAK831 Pilot gateway
This documents are from a workshop held during the Things Network Conference 2018, in
this workshop, many developers build a gateway based on RAK831 and a Raspberry Pi model 3.
We can use this tutorial as the reference to understand how to connect RAK831 Pilot gateway to
TTN.
NOTE: Never power on the gateway without the antenna connected as shown in the picture

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
4
2. Preparations
The workshop requires some tools to be available on your system. Check the list below and
follow the link to the installation instructions if you do not have the tool installed.
GIT command line client. windows,OSX, for Linux use the tools from your distribution to
install.
For Windows and OSX: Etcher, SD card writing software. windows,OSX
You will also need a SSH public/private key pair, generate a key pair if you do not have it.

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
5
3. Create resin.io account
If you already have a resin.io account, please go to the http://resin.io website and log in.
And if you do not have it, now is the time to create it. Go to signup to create it. (If you have an
account skip to the next step)
On the first screen enter your e-mail address and a (secure) password.
Next you provide your first and last name, company if applicable and choose whether you
will be using resin.io for a personal or professional project.

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
6
Now we need to add our public SSH key. Resin.io uses this key when we upload code to
run on our devices. In the upper right of the page click on the down arrow next to your name and
select ‘Preferences’from the menu.
Now select the tab “SSH keys”and click on “Enter SSH key manually”
In the next window you need to paste the public part of your SSH key. This is store in
id_rsa.pub in the folder .ssh in your home folder (Windows: c:\users<your
username>.ssh\id_rsa.pub, OSX /Users/.ssh/id_rsa.pub, Linux: /home/.ssh/id_rsa.pub) Use
your favorite editor to open the file and copy the contents to the form.

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
7
Save with “Add SSH key”. Go back to the main page by click in the resin.io logo in the top
left of the page.

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
8
4. Create a new application
On the resin.io main screen you are able to create a new application. The device type
conveniently defaults to Raspberry Pi 3, which we will be using. Enter ‘lorawangw ’for the
application name and proceed with ‘CREATE NEW APPLICATION’.

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
9
5. Set Fleet Configuration
The Raspberry Pi model 3 requires some settings to correct the timing and switch serial
ports (not used in this setup, but would be required to access a GPS if it had been mounted).
In your browser go to ‘FLEET’, as shown below:
Add the information as shown below:
Name
Value
RESIN_HOST_CONFIG_core_freq
250
RESIN_HOST_CONFIG_dtoverlay
pi3-miniuart-bt
Application config variables:

RAK831 User Manual
COPYRIGHT ©
SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD
www.rakwireless.com
10
6. Add device
In the application select “Add device”.
Leave all settings set to the default and click “Download resinOS”.
Save the download to disk. (Remember where you save it!)
Once the download is finished, extract the contents of the zip file to disk (keep in mind the
extracted file will be almost 2GB in size). In the next step we will write this file to SD card.