RAK RAK7244 User manual

Documentation Center
Quick Start Guide
Prerequisites
What do you need?
1. RAK7244 WisGate Developer D4 Gateway
2. 16GB SD Card (included) + Card Reader
3. 5V at least 2.5A Micro USB Power Supply
4. A Windows/Mac OS/Linux Computer
What's included in the Package?
Figure 1: RAK7244 WisGate Developer D4 Gateway Package Contents
Product Configuration
Accessing your Gateway
After burning the image into the SD Card, make sure you have inserted the SD Card with the Latest Firmware
installed to the RAK7244 WisGate Developer D4 Gateway and the LoRa and GPS Antenna attached to it. After
which, you can now safely power on the gateway. In this section, several ways in accessing the gateway are
provided to have different alternatives for you to choose depending on the availability of the requirements needed.
⚠ WARNING
Before powering the Raspberry Pi 4 you should install 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 like
"Rakwireless_XXXX" on your PC Wi-Fi Network List.
Figure 2: RAKwireless Access Point

Documentation Center
📝 NOTE:
“XXXX” is the last 2 bytes of your RAK7244’s 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 4 Ethernet Port
You can also connect your PC with the gateway through an Ethernet cable. By default, the IP address of the
gGateway’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 in Windows, go to Control Panel -> Network and Internet -> Network and Sharing Center and Click
Ethernet.
Figure 3: Network and Sharing Center
Click Properties then Choose Internet Protocol Version 4 (TCP/IPv4).

Documentation Center
Figure 4: Ethernet Properties
By default, it will obtain an IP Address automatically. Click the Option "Use the following IP Address" and enter
the IP Address: 192.168.10.20 and press OK.
Figure 5: 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 into the Gateway
1. 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, you will be using Putty for this guide.

Documentation Center
Figure 6: 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 7: Command line after log in
2. 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 and typing “Terminal” and then return:

Documentation Center
Figure 8: Opening Terminal in Mac OS
Open the terminal of Mac OS. Enter root mode by typing the following command: " sudo -i "
Figure 9: SSH in Mac OS
If you are not in root mode, enter " ssh [email protected] " 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 [email protected] ",
the default password is "raspberry".
Figure 10: Log-in Successful Notification
3. Linux OS
If the OS of your PC is Linux, you should do the same as the Mac OS, except the root mode.

Documentation Center
Accessing the Internet
Assuming you have successfully logged into your Gateway using SSH. Enter the following command in the
command line:
You will now then see a page like the following picture below:
Figure 11: Configuration Options for the Gateway
1. Set pi password - used to set/change the password of the Gateway.
2. Set up RAK Gateway LoRa Concentrator - used to configure the frequency, 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 forwarded process.
4. Edit packet-forwarder config- used to open the global_conf.json file, in order 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.
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 4 by
choosing "5 Configure WIFI". By default, the RAK7244 WisGate Developer D4 Gateway works in Wi-Fi AP Mode.
In order for the Gateway to connect to the router, it must work in Wi-Fi Client Mode.
sudo gateway-config
sh

Documentation Center
Figure 12: Configuration options for WIFI
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 with Wi-Fi standards.
⚠ WARNING
In order to enable Wi-Fi Client Mode, you have to disable first the AP Mode.
Once Wi-Fi AP Mode has been disabled by choosing "2 Enable Client Mode/Disable AP Mode", you can now
then connect to a new Wi-Fi Network by choosing "4 Add New SSID for Client":

Documentation Center
Figure 13: Add a new SSID
Start by selecting your country of residence:
Figure 14: Selecting Country of Residence
Enter the SSID of the network you want to connect:
⚠ WARNING
Please ensure to input the correct Wi-Fi SSID and Password or you will not be able to connect to the
RAK7244 again via SSH in Wi-Fi AP Mode. If stuck in this situation, please 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.

Documentation Center
Figure 15: SSID of the Network you want to connect to
Enter also the password. Just leave it empty if None.
Figure 16: Password of the Wi-Fi
Connect through Ethernet
If you want to connect to router through 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.
Just fill a static IP Address according to the IP address of the router you want to connect. Please note that 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

Documentation Center
Figure 17: Default Gateway Ethernet IP Address
Then configure the IP address of the Router. This is the LAN Interface IP address of the router.
Figure 18: LAN Interface IP Address of the Router
Press OK then the success message will appear.
Lastly, reboot the Gateway using the command " sudo reboot " in the command line and it will connect to the
router successfully through Ethernet.
Optional Configurations
These configurations under this section are only optional and situational.
Reverting to Wi-Fi AP Mode
In the event that you have entered either or both icorrect Wi-Fi SSID and Password in the Wi-Fi Client Mode setup
for the RAK7244 WisGate Developer D4 Gateway to connect to the router, follow these set of steps for you to work
again in Wi-Fi AP Mode and redo the setup.
sudo reboot
sh