RAK RAK831 User Manual

Pilot gateway

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RAK831 and is the answer not in the manual?

Questions and answers

Summary of Contents for RAK RAK831

  • Page 1 RAK831 User Manual RAK831 Pilot Gateway 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.
  • Page 2: Table Of Contents

    RAK831 User Manual 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.
  • Page 3: 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.
  • Page 4: Preparations

    RAK831 User Manual 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.
  • Page 5: Create Resin.io Account

    RAK831 User Manual 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.
  • Page 6 RAK831 User Manual 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’...
  • Page 7 RAK831 User Manual 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. COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD www.rakwireless.com...
  • Page 8: Create A New Application

    RAK831 User Manual 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’.
  • Page 9: Set Fleet Configuration

    RAK831 User Manual 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).
  • Page 10: Add Device

    RAK831 User Manual 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).
  • Page 11: Write Image To Sd Card

    RAK831 User Manual 7. Write image to SD card Get the micro SD card from the Raspberry Pi. Insert it into the SD card writer (use a full size SD card adapter if required). Windows & OSX: Open Etcher, click “Select image” and browse to the ISO file extracted in the previous step, verify the correct SD card is chosen.
  • Page 12 RAK831 User Manual NOTE: Take care to select the right device, dd will quite happily overwrite any disk, including your Linux installation ! Proceed to the next step while dd is writing to the SD card. COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD...
  • Page 13: Add Software To Your Application

    RAK831 User Manual 8. Add software to your application Earlier we have created the resin.io application. Now we need to add the application code that should be run on the Raspberry Pi. For this we will use a prepared LoRaWAN gateway application available on Github.
  • Page 14 RAK831 User Manual git push resin The first time you run this command you will be see a message like The authenticity of host 'git.resin.io (54.165.162.194)' can't be established. ECDSA key fingerprint is SHA256:NfwmqnKId5cx1RWpebbEuuM87bCJbdyhzRnqFES9Nnw. Are you sure you want to continue connecting (yes/no)? Reply ‘yes’...
  • Page 15 RAK831 User Manual COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD www.rakwireless.com...
  • Page 16: Boot The Gateway Hardware

    Eject the micro SD card from your write and insert it into the Raspberry Pi SD card slot. (Metal contacts at PCB side) Make sure the antenna is connected to the RAK831 card (see picture at the top), connect Ethernet cable and power adaptor to the Raspberry Pi. Now plug the power adaptor into power socket.
  • Page 17: Add The Gateway To The Ttn Console

    RAK831 User Manual 10. Add the gateway to the TTN console To configure our gateway, we need to add it in the TTN console. A. Use your TTN credentials to log in to https://console.thethingsnetwork.org/ B. In the main screen click on gateways C.
  • Page 18 RAK831 User Manual For ‘Antenna Placement’, choose Indoor/Outdoor as appropriate. Click “Register Gateway” to proceed. The result should look like: COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD www.rakwireless.com...
  • Page 19 RAK831 User Manual Keep this window open, you need it to copy-and-paste information. COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD www.rakwireless.com...
  • Page 20: Configure Your Device

    RAK831 User Manual 11. Configure your device Switch to your resin.io page. If you do not have the device summary page open, open it now. Click on “ENVIRONMENT VARIABLES”. You need to add three variables: A. Name the first one “GW_ID” (no quotes) and copy the value listed for the “Gateway ID”...
  • Page 21 RAK831 User Manual Once set (and the software download has finished) the software will start. If the software starts correctly you will see “concentrator started” in the output in the resin.io Logs. In the TTN console the “Last seen” status should change to something between 0 and 60 seconds.
  • Page 22 RAK831 User Manual In the TTN console switch to “Traffic”. If there are any nodes nearby sending data (should be the case during the conference), packets will show. Congratulations, the gateway is now operational ! COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD...
  • Page 23: Contact Information

    RAK831 User Manual 12. Contact information 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 COPYRIGHT ©...
  • Page 24: Change Note

    RAK831 User Manual 13. Change Note Version Date Modify content Arthur V1.0 2018-04-11 Create the document Farce COPYRIGHT © SHENZHEN RAKWIRELESS TECHNOLOGY CO., LTD www.rakwireless.com...

Table of Contents