RAK RAK7248 User manual
Documentation Center
RAK7248 Quick Start Guide
Prerequisites
What Do You Need?
1. RAK7248/RAK7248C/RAK7248P WisGate Developer D4H Gateway
2. 16 GB SD Card + Card Reader
3. 5 V at least 2.5 A Micro USB Power Supply
4. A Windows/Mac OS/Linux Computer
5. Latest RAK7248 Firmware
What's Included in the Package?
Figure 2: RAK7248/P WisGate Developer D4H Gateway package contents
Figure 3: RAK7248C WisGate Developer D4H Gateway package contents
Product Configuration
After burning the firmware image onto the SD Card, make sure you have inserted the SD Card into the RAK7248
WisGate Developer D4H Gateway and have the LoRa, and GPS Antenna connected. Refer to the guide on how
to burn the image .
⚠
WARNING
Before powering the Raspberry Pi 4, you should connect the LoRa, LTE (only in the Cellular variant), and
the GPS antennas. Not doing so might damage the boards.
After the antennas are attached and the SD card is inserted into the Raspberry Pi, you can safely power
on the gateway.
Wi-Fi AP Mode
By default, the gateway will work in Wi-Fi AP Mode, which means you can find an SSID named
Rakwireless_XXXX on your PC Wi-Fi Network List.
Documentation Center
Figure 4: RAKwireless access point
📝
NOTE
XXXX is the last 2 bytes of your RAK7248’s WiFi MAC address. Connect to this Wi-Fi SSID using the
password provided below. Take note of the default IP address of the gateway provided below as this will
be needed in connecting via SSH. By default, the gateway will work in Wi-Fi AP Mode, which means you
can find an SSID named Rakwireless_XXXX on your PC Wi-Fi Network List.
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
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 .
1. To do this on a Windows PC, go to Control Panel -> Network and Internet -> Network and Sharing Center
and click Ethernet.
Figure 5: Network and sharing center
2. Click Properties, then slect Internet Protocol Version 4 (TCP/IPv4).
Documentation Center
Figure 6: Ethernet properties
3. 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 7: 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
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
Documentation Center
Figure 8: 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 are:
Username: pi
Password: raspberry
Figure 9: Command line after log in
Mac OS
Open the Terminal of Mac OS. Launch the Terminal application found in "the /Applications/Utilities/" directory. You
can also launch it from Spotlight by hitting Command + Spacebar and typing Terminal, and then return:
Documentation Center
Figure 10: Opening terminal in Mac OS
Open the terminal of Mac OS. Enter root mode by typing the following command:
Linux OS
If the OS of your PC is Linux, you should do the same as the Mac OS, except the root mode.
Accessing the Internet
Assuming you have successfully logged into your gateway using SSH. Enter the following command in the
command line:
You will then see a page like the following picture:
sudo -i
sudo gateway-config
Documentation Center
Figure 11: Configuration options for the gateway
1. Set pi password- used to set/change the password of the gateway.
2. Set RAK Gateway Channel Plan - 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 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.****
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 RAK7248 WisGate Developer D4H Gateway works in Wi-Fi AP Mode.
For the gateway to connect to the router, it must work in Wi-Fi Client Mode.
Figure 12: Configuration options for Wi-Fi
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).
Documentation Center
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 then
connect to a new Wi-Fi Network by choosing 4 Add New SSID for Client.
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:
Documentation Center
⚠
WARNING
Make sure to input the correct Wi-Fi SSID and Password, or you will not be able to connect to the
RAK7248 again via SSH in Wi-Fi AP Mode. If stuck in this situation, follow the 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 15: SSID of the Network you want to connect to
Type the password. If there is none, leave the field empty.
Figure 16: Wi-Fi password
Connect through Ethernet
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 to. 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: Router LAN IP
Press OK and the success message will appear.
After reboot, the gateway will connect to the router successfully through Ethernet.
Reboot
Lastly, reboot the gateway using the command shown below and put it in the command line.
sudo reboot
Documentation Center
Optional Configuration
The configurations in 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
RAK7248 WisGate Developer D4H Gateway to connect to the router, follow this set of steps to work again in Wi-Fi
AP Mode and redo the setup.
Remove the SD Card from your RAK7248 WisGate Developer D4H Gateway and insert it into your PC. Your PC
should be able to detect it the same way as on the image below:\
Figure 19: Creating rak_ap file to your SD Card
Using your Command Prompt or Terminal, navigate to your SD Card and type the following command to
generate the rak_ap file.
Check if the rak_ap file is created successfully. If so, re-insert the SD Card into your RAK7248 WisGate
Developer D4H Gateway, and it should work again in Wi-Fi AP Mode.
Configuring the Gateway
If you have successfully logged into your gateway using SSH, enter the following command in the command line:
You will see the following page:
cd > rak_ap
sudo gateway-config
This manual suits for next models
2
Table of contents
Other RAK Gateway manuals
RAK
RAK WisGate Edge Max User manual
RAK
RAK RAK2247 User manual
RAK
RAK WisGate Edge Lite RAK7258 User manual
RAK
RAK RAK7289V2 User manual
RAK
RAK 7244 User manual
RAK
RAK RAK831 User manual
RAK
RAK 7258 User manual
RAK
RAK RAK7244 User manual
RAK
RAK WisGate Edge Prime RAK7240 User manual
RAK
RAK RAK7268V2 User manual
Popular Gateway manuals by other brands
LST
LST M500RFE-AS Specification sheet
Kinnex
Kinnex Media Gateway quick start guide
2N Telekomunikace
2N Telekomunikace 2N StarGate user manual
Mitsubishi Heavy Industries
Mitsubishi Heavy Industries Superlink SC-WBGW256 Original instructions
ZyXEL Communications
ZyXEL Communications ZYWALL2 ET 2WE user guide
Telsey
Telsey CPVA 500 - SIP Technical manual
