RAK7392 WisGate Connect Router Quick Start Guide
Flashing the OS
The recommended operating system for the RAK7392 is RAKPiOS. For detailed instructions on flashing and booting the OS, refer to the RAKPiOS documentation.
Network Connectivity
Connectivity management for the RAK7392 is handled through the NetworkManager tool suite. NetworkManager provides flexibility for configuring Ethernet, Wi-Fi, and Cellular interfaces. It enables users to create, display, edit, delete, activate, and deactivate network connections through configuration files. The command-line tool nmcli can also be used to control NetworkManager.
The NetworkManager configuration file must be owned by root, and only root should have read access. Set the permissions using the following commands:
sudo chmod -R 600
/etc/NetworkManager/system-connections/MyConnection.nmconnection
sudo chown -R root:root
/etc/NetworkManager/system-connections/MyConnection.nmconnection
The OS must be rebooted or the gateway power cycled for the configuration changes to take effect.
Ethernet
The gateway features three Ethernet ports at 1 Gb (eth1, eth2, and eth3) and one at 2.5 Gb (eth0). Connecting any port to a LAN with a DHCP server automatically assigns an IP address without requiring specific NetworkManager configuration. The assigned address can be retrieved via the router interface.
To assign a static IP to an Ethernet interface, such as eth0, create a new connection file named ethernet-eth0.nmconnection in the /etc/NetworkManager/system-connections/ folder.
The file should have the following contents:
[connection]
id=ethernet-eth0
type=ethernet
interface-name=eth0
[ipv4]
address1=192.168.1.111/24,192.168.1.1
dns=8.8.8.8
method=manual
[ipv6]
addr-gen-mode=stable-privacy
method=auto
The important details to note are:
interface-name=eth0: Indicates which network interface to use,eth0in this example.address1=192.168.1.111/24,192.168.1.1: Shows the static IP address assigned to the interface (192.168.1.111) and the network gateway IP address (192.168.1.1).dns=8.8.8.8: Indicates which Domain Name Server (DNS) is to be used. Google's DNS server is used in this example.
To configure the static IP address using the command-line tool nmcli, execute the following command:
sudo nmcli con add type ethernet autoconnect yes ifname eth0 ipv4.addr 192.168.1.111/24 ipv4.gateway 192.168.1.1 ipv4.dns 8.8.8.8 ipv4.method manual
Wi-Fi
Wi-Fi 5
If the CM4/CM5 module you are using has built-in Wi-Fi, it supports speeds up to Wi-Fi 5 (IEEE 802.11 b/g/n/ac). Connecting to Wi-Fi is configured similarly to setting up a manual Ethernet connection.
- To connect to a hotspot named
RAK, create a new connection file namedRAK.nmconnectionin the/etc/NetworkManager/system-connections/folder. The file should have the following contents:
[connection]
id=RAK
type=wifi
interface-name=wlan0
[wifi]
ssid=RAK
[wifi-security]
auth-alg=open
key-mgmt=wpa-psk
psk=rak20140629
[ipv4]
method=auto
route-metric=100
[ipv6]
addr-gen-mode=stable-privacy
method=auto
interface-name=wlan0: The built-in Wi-Fi interface iswlan0.ssid=RAK: The SSID of the network. In this case, it isRAK.key-mgmt=wpa-psk: Type of authentication. In this case, it iswpa-psk.psk=rak20220922: The password. In this case, it israk20220922.
- To apply the new configuration, reload it using the following commands:
sudo chown -R root:root /etc/NetworkManager/system-connections/RAK.nmconnection
sudo chmod -R 600 /etc/NetworkManager/system-connections/RAK.nmconnection
sudo nmcli con reload
sudo nmcli con up RAK
The equivalent commands using the nmcli tool are:
sudo nmcli device wifi connect RAK if name wlan0 password rak20220922
Cellular
The RAK7392 supports cellular connectivity when paired with the RAK8213, a multi-band LTE Cat 4 module. This module is based on the Quectel EG95 and features a standard PCI Express® (mPCIe) form factor.
Hardware Setup
- Insert the RAK8213 module into the MiniPCIe slot on the RAK7392 board.
- Ensure that you have a SIM card that supports Cat 4 or EGPRS.
- Insert the SIM card into the external SIM card slot.
- Alternatively, RAK8213 versions with an integrated SIM card slot are available, enabling deployment with any mPCIe slot.
Connection File
Create a cellular connection file named gsm.nmconnection in the folder /etc/NetworkManager/system-connections/.
The file should have the following contents:
[connection]
id=gsm
uuid=55e9c95e-5947-4dad-9a92-9d409449ba4d
type=gsm
interface-name=cdc-wdm0
permissions=
[gsm]
apn=iot.1nce.net
[ipv4]
dns-search=
method=auto
[ipv6]
addr-gen-mode=stable-privacy
dns-search=
method=auto
[proxy]
The key details to note are:
apn=cmnetspecifies the Access Point Name (APN) for your SIM card's network provider.- After configuration, reboot your board, and the
wwan0interface will obtain an IP address, making it ready for internet connectivity.
interface-name=cdc-wdm0: Indicates the interface used.uuid=55e9c95e-5947-4dad-9a92-9d409449ba4d: The UUID, should be provided with the SIM card.apn=iot.1nce.net: Every provider has a specific APN that must be obtained through their online portal. In this example, 1nce is used with the APNiot.1nce.net.
After creating the configuration file, reboot or power cycle the gateway for the changes to take effect. If the connection is established successfully, the wwan0 interface will obtain an IP address, which can be verified on the OLED display.
