Skip to main content
X
RAK Logo White RegisteredRAK Logo White Registered
RAKwireless Documentation Center
Store

  • Home
  • rak7394 RAK7394 Buy from store
  • Product Overview
  • Quick Start Guide
  • LoRaWAN Network Server Guide
  • Datasheet
  • product categories
  • wisgate
  • rak7394
  • quickstart

RAK7394 WisGate Developer CM4 Quick Start Guide

Prerequisites​

Hardware​

  • RAK7394/RAK7394C/RAK7394P WisGate Developer CM4 Gateway
  • 5 V at least 2.5 A Micro USB power supply
  • A Windows/Mac OS/Linux Computer

Software​

  • Latest Firmware

Package Inclusion​

Zoomable
Figure 1: RAK7394P package inclusion
Zoomable
Figure 1: RAK7394C package inclusion

Product Configuration​

Power the Gateway​

warning

Before powering the device, ensure that the LoRa, LTE (for the Cellular variant only), and GPS antennas are connected. Failing to attach the antennas may damage the boards. Once the antennas are securely connected, the gateway can be powered on safely.

Power the gateway using the provided power adapter by inserting it into the USB-C Power Supply slot. If you are unsure which one of the two USB-C slots is for powering the gateway and which one is for booting, consult the Interfaces section of the gateway's datasheet

NOTE

The RAK7394P WisGate Developer CM4 Gateway supports Power-over-Ethernet (PoE). You can use a PoE injector to power the gateway via an Ethernet cable.

Access the Gateway​

This section outlines several methods for accessing the gateway, offering different alternatives based on the availability of the required resources.

Wi-Fi AP Mode​

By default, when you power on RAK7394 and no other connection is established with the device (eg. Ethernet connection) the gateway will work in Wi-Fi AP mode, which means you can find an SSID named RAK_XXXX on your PC Wi-Fi Network List.

Zoomable
Figure 1: RAKwireless access point
NOTE

XXXX is the last 2 bytes of your RAK7394’s Wi-Fi 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.

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

Ethernet Port​

Power up the RAK7394 and connect it to your router via an Ethernet cable. By default, the OS operates in DHCP client mode. Then, look up the IP address your gateway gets assigned from the router. It will be listed as rakpios. Use your favorite SSH tool to log in and get started.

Zoomable
Figure 1: Gateway-assigned IP address

Log into the Gateway​

Windows OS​

SSH (Secure Shell) is commonly used to log in to a remote machine and execute commands. Many free and reliable SSH clients are available, such as Putty, BitVise SSH Client, MobaXterm, and others.

  1. Choose the client that best suits your needs. For this guide, however, Putty will be used.
Zoomable
Figure 1: Putty Software for SSH in Windows
  1. Log in via SSH, enter the default password, and then set a new password when prompted.

The default RAKPiOS username is rak, and the password is changeme. During your first login, you will be required to change the default password for security purposes.

Zoomable
Figure 1: First login password change
  1. After changing the default password (as required), the terminal and SSH session will close automatically. Reopen the session and log in using the new password.

macOS​

  1. Open the Terminal on macOS by launching the Terminal application located in the /Applications/Utilities/ directory. Alternatively, you can open it using Spotlight by pressing Command + Spacebar and typing Terminal.
Zoomable
Figure 1: macOS terminal search
  1. After opening the terminal of macOS, enter root mode by typing the following command:
sudo -i
  1. Then, you need to run the following command:
ssh user@IP-Address
  1. You will be asked to provide a password for login.
Zoomable
Figure 1: Login prompt

Linux OS​

If your PC runs Linux, follow the same steps as for macOS, except for enabling root mode (step 2).

Access to Internet​

Connect Through Wi-Fi​

  1. To connect the RAK7394 to a Wi-Fi network, execute the following command:
sudo raspi-config
Zoomable
Figure 1: Enter config mode
  1. When you execute the command, you will be prompted to enter the sudo password. Enter the password to proceed.
Zoomable
Figure 1: Enter the password
  1. The Raspberry Pi configuration tool will open. Navigate to and select System Options.
Zoomable
Figure 1: Raspberry Pi configuration Tool
  1. Select Wireless LAN.
Zoomable
Figure 1: Wireless LAN
  1. You will be asked to select the country in which the Pi is to be used. Select the corresponding country.
Zoomable
Figure 1: Select country of operation
  1. Confirm the selection.
Zoomable
Figure 1: Selection confirmation
  1. You will be prompted to enter the SSID of the wireless network you wish to connect to. After entering the SSID, click OK.
Zoomable
Figure 1: Enter the SSID
  1. Next, you will be prompted to enter the passphrase for your Wi-Fi. If your network does not require a passphrase, leave this box empty. Once all the settings are configured, the tool will return to the main menu. Select Finish to close the window.
Zoomable
Figure 1: Raspberry Pi configuration tool
  1. The RAK7394 should now be connected to Wi-Fi. To verify the connection, use the ifconfig command. The console should display information indicating that the connection is established.
ifconfig
Zoomable
Figure 1: RAK7394 connected to Wi-Fi

Connect Through Ethernet​

If you are accessing the gateway through the RAKR314 Carrier Board Ethernet Port, you are automatically connected to the internet via the Ethernet connection.

Reboot​

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

sudo reboot

Optional Configuration​

Reflashing Procedure​

To reflash the RAK7394, you need to disassemble the enclosure to access the RAK314 inside.

When you have access to the RAK314, you need to follow this guide.

Change the Password​

  1. To change the password, use the following command to open the configuration tool:
sudo raspi-config
Zoomable
Figure 1: Open the configuration tool
  1. From the menu, select System Options.
Zoomable
Figure 1: Configuration tool
  1. Select Password.
Zoomable
Figure 1: System options
  1. A message will appear informing you that you need to enter a new password.
Zoomable
Figure 1: Password
  1. After clicking OK, you will be prompted to enter a new password and then confirm it by entering it again.
Zoomable
Figure 1: Enter and confirm the new password
  1. After confirming the password, the configuration tool will display a message indicating that the password has been changed successfully.
Zoomable
Figure 1: Password changed

Switch Network Interfaces​

  1. To manage your network interfaces, execute the following command:
rakpios-cli
Zoomable
Figure 1: Execute the command
  1. You will see a menu with the available configuration options, select Manage networks.
Zoomable
Figure 1: Configuration options
  1. This will display a list of available interfaces. Select the desired interface and configure it as preferred by making the necessary changes.
Zoomable
Figure 1: Available network interfaces
Home
Product Overview
LoRaWAN Network Server Guide
  • Prerequisites
    • Hardware
    • Software
    • Package Inclusion
  • Product Configuration
    • Power the Gateway
    • Access the Gateway
      • Wi-Fi AP Mode
      • Ethernet Port
    • Log into the Gateway
      • Windows OS
      • macOS
      • Linux OS
    • Access to Internet
      • Connect Through Wi-Fi
      • Connect Through Ethernet
    • Reboot
  • Optional Configuration
    • Reflashing Procedure
    • Change the Password
    • Switch Network Interfaces

LoRa® is a registered trademark or service mark of Semtech Corporation or its affiliates. LoRaWAN® is a licensed mark.

Copyright © 2014-2024 RAKwireless Technology Limited. All rights reserved.

Copyright © 2014-2024 RAKwireless Technology Limited. All rights reserved.

FacebookRAKwireless FacebookTwitterRAKwireless TwitterInstagramRAKwireless InstagramLinkedInRAKwireless LinkedInYoutubeRAKwireless YoutubePinterestRAKwireless PinterestTikTokRAKwireless TikTokGithubRAKwireless GithubHacksterRAKwireless HacksterDiscordRAKwireless Discord