Skip to main content
X

RAK7394 WisGate Developer CM4 Quick Start Guide

Prerequisites​

What Do You Need?​

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

What Is Included in the Package?​

Figure 9840: RAK7394P package inclusion
Figure 9841: RAK7394C package inclusion

Product Configuration​

Powering the Gateway​

warning

Before powering the device, connect the LoRa, LTE (only in the Cellular variant), and GPS antennas. Not doing so, might damage the boards. After the antennas are attached, you can safely power the gateway on.

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

RAK7394P WisGate Developer CM4 gateway supports Power-over-Ethernet. You can supply yourself with a PoE injector and power up the gateway via an Ethernet cable using a PoE injector.

Accessing the Gateway​

In this section, several ways of accessing the gateway are provided to have different alternatives for you to choose from, depending on the availability of the requirements needed.

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.

Figure 9842: 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.

Figure 9843: Gateway-assigned IP address

Log into the Gateway​

Windows OS​

  1. 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 9844: Putty Software for SSH in Windows
  1. The default RAKPiOS user name is rak, and the password is changeme. At first login, you will need to change the default password for security. So, if you log in via SSH for the first time, you need to set a new password by entering the default one and a new one after.
Figure 9845: First login password change
  1. When you change the default password (required), the terminal and the SSH session will be closed. Reopen it using the new password for login.

Mac OS​

  1. 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.
Figure 9846: Mac OS 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.
Figure 9847: Login prompt

Linux OS​

If the OS of your PC is Linux, you should do the same as the macOS, except for the root mode (step 2).

Accessing the Internet​

Connect Through Wi-Fi​

  1. To connect the RAK7394 to a Wi-Fi network, execute the following command:
sudo raspi-config
Figure 9848: Entering config mode
  1. When you issue the command, you will be prompted to enter the sudo password. Do so.
Figure 9849: Entering the password
  1. The Raspberry Pi configuration tool will open. Select System options.
Figure 9850: Raspberry Pi configuration Tool
  1. Select Wireless LAN.
Figure 9851: Wireless LAN
  1. You will be asked to select the country in which the Pi is to be used. Select the corresponding country.
Figure 9852: Selecting country of operation
  1. Confirm the selection.
Figure 9853: Selection confirmation
  1. You will be prompted to provide the SSID of the wireless network you want to connect to. After entering it, click OK.
Figure 9854: Entering the SSID
  1. Next, you will be asked for the passphrase. If your Wi-Fi doesn’t have one leave this box empty. Once you have set all of the above, the configuration tool will return you to the main menu, select Finish to close this window.
Figure 9855: Raspberry Pi configuration tool
  1. Your RAK7394 should be connected to the Wi-Fi by now. To check if the connection is established use the ifconfig command. The console should indicate an established connection.
ifconfig
Figure 9856: 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 would need to disassemble the enclosure to get to the RAK314 inside.

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

Changing the Password​

  1. To change the password you will have to use the following command to open the configuration tool:
sudo raspi-config
Figure 9857: Opening the configuration tool
  1. From the menu, select System Options.
Figure 9858: Configuration tool
  1. Select Password.
Figure 9859: System options
  1. You will see a message informing you that you will enter a new password.
Figure 9860: Password
  1. After clicking OK, you will see a line that will ask you to enter a new password and then confirm it one more time.
Figure 9861: Entering and confirming the new password
  1. After confirming the password, the configuration tool will indicate that the password is changed successfully.
Figure 9862: Password changed

Switching Network Interfaces​

  1. To manage your network interfaces, you need to execute the following command:
rakpios-cli
Figure 9863: Executing the command
  1. You will see a menu with the available configuration options, select Manage networks.
Figure 9864: Configuration options
  1. This will open a list of the available interfaces. Configure as preferred by selecting the desired one and making the needed changes.
Figure 9865: Available network interfaces