Skip to main content
X

RAK7243 Quick Start Guide

Prerequisites​

What Do You Need?​

  1. RAK7243 WisGate Developer D3
  2. 16 GB SD card (included) + Card Reader
  3. 5 V at least 2.5 A Micro USB Power Supply
  4. A Windows/Mac OS/Linux Computer
  5. Latest RAK7243 Firmware
warning

The SIM card slot of the cellular versions is not hot-swappable. Make sure the gateway is switched off before inserting or ejecting the SIM card.

What's Included in the Package?​

Figure 8683: RAK7243 package contents

Product Configuration​

Accessing Your Gateway​

After burning the firmware image onto the SD card, make sure you have inserted the SD card into the RAK7243 WisGate Developer D3 Gateway and have the LoRa and GPS Antenna connected. To learn more on how to burn the image, check the Learn section.

After which, you can now safely power on the gateway. In this section, several ways to access the gateway are provided to have different alternatives for you to choose from depending on the availability of the requirements needed.

warning

Before powering the Raspberry Pi 3B+, you should connect the LoRa and GPS antennas. Not doing so might damage the boards.

Wi-Fi AP Mode​

By default, the gateway will work in Wi-Fi AP Mode which means that you can find an SSID named Rakwireless_XXXX on your PC Wi-Fi network list.

Figure 8684: RAKwireless access point
NOTE

XXXX is the last 2 bytes of your RAK7243 WiFi MAC address. Connect to this Wi-Fi SSID using the password provided below. Take note also of the default IP address of the gateway provided below as this will be needed in connecting via SSH.

  • Wi-Fi Password: rakwireless
  • Default IP Address: 192.168.230.1

Raspberry Pi 3B+ Ethernet Port​

You can also connect your PC with the gateway through an Ethernet cable. By default, the IP address of the gateway’s Ethernet interface is 192.168.10.10, so you need to set the IP address of your PC’s Ethernet to the same network segment, for example, 192.168.10.20.

  • To do this on a Windows PC, go to Control Panel -> Network and Internet -> Network and Sharing Center and click on Ethernet.
Figure 8685: Network and sharing center
  • Click Properties then Choose Internet Protocol Version 4 (TCP/IPv4).
Figure 8686: Ethernet properties
  • By default, the PC will obtain an IP address automatically. Click Option Use the following IP Address and enter the IP address 192.168.0.10.20, then press OK.
Figure 8687: TCP/IPv4 properties

Now, you should be able to access your gateway from your PC successfully using the IP address 192.168.10.10 through SSH.

Log in to the Gateway​

Windows OS​

SSH (Secure Shell) is typically used to log in to a remote machine and execute commands. There are a lot of free and good SSH Clients out there namely Putty, BitVise SSH Client, MobaXterm and many more. Feel free to choose one that fits your needs. But for this guide, you will be using Putty.

Figure 8688: Putty Software for SSH in Windows
  • If you have connected to the gateway through Wi-Fi AP Mode, the IP address is 192.168.230.1
  • If you have connected to the gateway through Ethernet, the IP address is 192.168.10.10
  • It will then prompt you to enter the username and password. The default username and password is provided below:
    • Username: pi
    • Password: raspberry
Figure 8689: Command line after log in
Mac OS​

Open the Terminal of Mac OS. Launch the Terminal application, which is found in /Applications/Utilities/ directory. But you can also launch it from Spotlight by hitting Command + Spacebar, typing Terminal, and then return:

Figure 8690: Opening Terminal in Mac OS

Open the terminal of Mac OS. Enter root mode by typing the following command:

sudo -i
Figure 8691: SSH in Mac OS
  • If you are not in root mode, enter ssh pi@192.168.230.1 in the terminal to login to your gateway, the default password is raspberry.
  • If you connect your PC with the gateway through Ethernet Cable, you should enter ssh pi@192.168.10.10, the default password is raspberry.

Once you have logged successfully into your gateway through SSH, you will see the following image:

Figure 8692: Successful log in notification
Linux OS​

If the OS of your PC is Linux, you should do the same as the Mac OS, except for the root mode.

Accessing the Internet​

Assuming you have successfully logged into your gateway using SSH. Enter the following command in the command line:

sudo gateway-config

Then, you will see a page the same as Figure 11.

Figure 8693: Configuration options for the gateway
  1. Set pi password - used to set/change the password of the gateway.
  2. Setup RAK Gateway Channel Plan - used to configure the frequency, on which the gateway will operate on, and the LoRaWAN Server which the gateway will work with.
  3. Restart packet-forwarder - used to restart the LoRa packet forwarder.
  4. Edit packet-forwarder config - used to open the global_conf.json file, to edit LoRaWAN parameters manually.
  5. Configure WIFI - used to configure the Wi-Fi settings in order to connect to a network.
  6. Configure LAN - used to configure the Ethernet adapter settings.
  7. Configure APN Name (optional) – used to configure the access point name of the mobile network.
  8. Configure LTE Module (optional) – used to enable/disable LTE automatic dial-up.
NOTE

Points 7 and 8 can be found only on LTE versions of the gateway.

Connect through Wi-Fi​

If you want to connect through Wi-Fi, it can easily be done with the wireless capabilities of the Raspberry Pi 3B+ by choosing 5 Configure WIFI. By default, the RAK7243 Developer works in Wi-Fi AP Mode.

For the gateway to connect to the router, it must work in Wi-Fi Client Mode.

Figure 8694: Wi-Fi options configuration

There are 5 options to choose from in the Wi-Fi configuration menu:

  1. Enable AP Mode/Disable Client Mode - the gateway will work in Wi-Fi Access Point Mode after rebooting while the Wi-Fi Client Mode will be disabled (this is the default mode).
  2. Enable Client Mode/Disable AP Mode - the gateway will work in Wi-Fi Client mode after rebooting, while Wi-Fi AP Mode will be disabled.
  3. Modify SSID and pwd for AP Mode - used to modify the SSID and password of the Wi-Fi AP. Only works if the Wi-Fi AP Mode is enabled.
  4. Add New SSID for Client - this is used if you want to connect to a new Wi-Fi network. Only works in Wi-Fi Client mode.
  5. Change Wi-Fi Country - this is used to modify the Resident Country to match Wi-Fi standards.
warning

To enable Wi-Fi Client Mode, you have to disable AP Mode first.

Once Wi-Fi AP Mode has been disabled by choosing 2 Enable Client Mode/Disable AP Mode, you can now connect to a new Wi-Fi network by choosing 4 Add New SSID for Client.

Figure 8695: Add a new SSID
  • Start by selecting your country of residence.
Figure 8696: Selecting country of residence
  • Enter the SSID of the network you want to connect.
warning

Make sure to input the correct Wi-Fi SSID and password or you will not be able to connect to the RAK7243 again via SSH in Wi-Fi AP Mode. If stuck in this situation, follow this procedure listed in the Reverting to Wi-Fi AP Mode section, which is applicable for all Raspberry Pi based gateways to work again in Wi-Fi AP mode.

Figure 8697: SID of the network you want to connect
  • Type the password. If there is none, leave the field empty.
Figure 8698: Wi-Fi password

Connect through Ethernet​

If you want to connect to the router through an Ethernet cable, do the following steps:

  • In the main configuration menu, choose 6 Configure LAN. This will let you set up a static IP address for the gateway’s Ethernet adapter.
  • Type a static IP address according to the IP address of the router you want to connect. The gateway and the router must be in the same network segment, otherwise the connection will fail.
  • By default, the IP address of the gateway's Ethernet is 192.168.10.10
Figure 8699: Default gateway Ethernet IP address
  • Then configure the IP address of the Router. This is the LAN Interface IP address of the router.
Figure 8700: LAN interface IP address of the router
  • Press OK, and the success message will appear.

Reboot​

Lastly, reboot the gateway using the command shown below and put it in the command line.

sudo reboot

After reboot, the gateway will connect to the router successfully through Ethernet.

Optional Configurations​

The configurations under this section are only optional and situational.

Reverting to Wi-Fi AP Mode​

If you have entered either or both incorrect Wi-Fi SSID and password in the Wi-Fi Client Mode setup for the RAK7243 Developer to connect to the router, follow this set of steps for you to work again in Wi-Fi AP Mode and redo the setup.

  • Remove the SD card from your RAK7243 WisGate Developer D3 Gateway and insert it into your PC. Your PC should be able to detect it.
Figure 8701: Creating rak_ap file to your SD card
  • Using your Command Prompt or Terminal, navigate to your SD card and type this command to generate the rak_ap file.
cd > rak_ap
  • Check if the rak_ap file is created successfully. If so, re-insert the SD card into your RAK7243 Developer and it should work again in Wi-Fi AP Mode.

Configure the Gateway​

If you have successfully logged into your gateway using SSH, enter the following command in the command line:

sudo gateway-config

Then you will see a page like in Figure 20.

Figure 8702: Configuration options for the gateway
  1. Set pi password - used to set/change the password of the gateway.
  2. Setup RAK Gateway Channel Plan - used to configure the frequency, on which the gateway will operate, and the LoRaWAN Server which the gateway will work with.
  3. Restart packet-forwarder - used to restart the LoRa packet forwarder.
  4. Edit packet-forwarder config- used to open the global_conf.json file, to edit LoRaWAN parameters manually.
  5. Configure WIFI - used to configure the Wi-Fi settings in order to connect to a network.
  6. Configure LAN - used to configure the Ethernet adapter settings.
NOTE

A unique ID will be generated in for gateway. This is also called Gateway EUI and is essential for registering the gateway with any LoRa network server (TTN and ChirpStack).

There is also another way to get your Gateway ID. Just enter the command below in the command line:

sudo gateway-version
Figure 8703: Gateway ID using the command line

Setting a New Password for the Gateway​

It is a good security practice to change the default password raspberry, which is the same on all Raspberry Pi devices.

  1. First, choose 1 Set pi password option.
Figure 8704: Set Pi password
  1. Next, press Yes. You will be asked to enter your new password twice then press Enter.
Figure 8705: Confirm password change
  1. А success message for changing the password will then pop up.
Figure 8706: Successful password change

Setup RAK Gateway Channel Plan​

This menu allows you to select your LoRa frequency band and one of the two available network server options by choosing 2 Setup RAK Gateway Channel Plan.

Figure 8707: Choosing a channel plan

You can choose one of two supported LoRa servers here: TTN or ChirpStack.

Server is TTN​
Figure 8708: TTN server
  • TTN (The Things Network) - If you choose TTN as the LoRa Server, you will see a page the same as shown in Figure 27. Visit LoRa Alliance Regional Parameters for more information on your local frequency plan. This will allow you to choose the correct plan.
Figure 8709: Selecting the TTN channel plan

After choosing the correct frequency, a success message will appear, as shown in Figure 28.

Figure 8710: Successfully changed the frequency
NOTE

When a channel plan is selected, the gateway is configured to connect to the nearest cluster to the region. If new clusters are presented, the channel plans will be updated. For now, the only available clusters are as follows:

  • Europe: eu1.cloud.thethings.network
  • Australia: au1.cloud.thethings.network
  • North America: nam1.cloud.thethings.network
Server is Chirpstack​
Figure 8711: Chirpstack server

ChirpStack - If you choose Chirpstack as your LoRa Server, you will see the following page with two options available:

  • ChirpStack Channel Plan Configuration - used to configure your Regional Frequency Band.
  • ChirpStack ADR Configure - used to enable/disable the Adaptive Data Rate (ADR) functionality.
Figure 8712: Configure ChirpStack channel plan

First, select 1 ChirpStack Channel-plan configuration for configuring your frequency channel.

Figure 8713: Regional frequency band option

Then set the IP address of the ChirpStack.

Figure 8714: Default LoRaServer IP address
NOTE

The default IP address is 127.0.0.1. If you want to use an external LoRaServer, you need to set it to its IP address.

  • If you have instead selected Chirpstack ADR Configure, you can enable/disable the Adaptive Data Rate (ADR) functionality:
Figure 8715: Chirpstack ADR Enable/Disable
NOTE

If you want to use ChirpStack for LoRa network server, refer to the LoRaWAN Network Server Guide documentation under Connecting with ChirpStack section.