LoRa® on-premise - at Home and in the Office

Using Ethernet

1. Plug one end of an Ethernet cable into the Raspberry Pi’s Ethernet port.

   Plug the other end into an Ethernet port on your home network router, hub or Powerline adapter.

2. Turn on the Raspberry Pi. The network LED’s should light up.

3. Go to the section Find the Gateway on Your Network.

Using Wi-Fi

To connect the gateway to the internet using Wi-Fi, you need an SSH tool. Linux and macOS machines have SSH preinstalled, and the Windows 10 April 2018 update and later versions of Windows include SSH enabled by default. If you have an earlier version of Windows, use the third-party client PuTTY.

To connect:

1. Wait until you see the access point ChirpStackAP listed among the available Wi-Fi networks on your machine.

2. Connect your machine to the Wi-Fi access point ChirpStackAP.

3. Enter the password:

   ChirpStackAP
   

   If you are on a Windows machine, the Wi-Fi connection wizard may prompt you for a PIN before it allows you to join the gateway access point. Click Connect using a security key instead to enter the password.

4. Once connected to the ChirpStack access point, the tool you use for interacting with the gateway depends on your operating system.

   If you are using Linux or macOS, use SSH.

   If you are using Windows, check to see if SSH is available:

   1. Enter the text PowerShell into the Windows Search bar.

   2. Open PowerShell.

   3. At the prompt enter:

      ssh
      

      If no error message displays, SSH is installed on your PC, and you can proceed to the next step.

      If an error does display, download PuTTY, install it, and then proceed to the next step.

5. The next step you take depends on whether you are using SSH or PuTTY.

   If you are using SSH (Linux, macOS, or Windows with SSH installed):

   1. If you are using Linux or macOS, open Terminal. If you are using Windows, open PowerShell.

   2. Enter the following command:

      ssh admin@192.168.0.1
      

   3. If you are asked whether you are sure you wish to connect, enter:

      yes
      

   4. Enter the default password:

      admin
      

   If you are using PuTTY:

   1. Open PuTTY.

   2. Enter 192.168.0.1 in the Host Name (or IP address) field as shown below, and then click Open.

      
      

      Warning

      A warning that the host key is not cached may display. This is normal. You can safely click Yes to continue.

   3. At the login prompt enter:

      admin
      

   4. At the password prompt, enter:

      admin
      

6. The welcome screen displays.

   
   

7. Enter the following command:

   $ sudo gateway-config
   

8. Enter the admin password at the prompt:

   admin
   

9. The menu screen displays.

   
   

10. Using the arrow keys, press the down arrow to select Configure WIFI, and press Enter to select OK.

11. Enter your network’s SSID. Press Enter to select Ok.

    Warning

    The SSID is case sensitive. If you mistype your SSID, you must re-flash the SD card and try again.

12. Enter your network password and press Enter to select Ok.

    Warning

    The password is case-sensitive. If you mistype your password, you must re-flash the SD card and try again.

13. The reboot confirmation screen displays. Press Enter to select OK.

    Note

    On reboot, the access point is no longer exposed. This disconnects your Raspberry Pi from SSH / PuTTY.

14. After a couple of minutes, the Pi should be back up and connected to the Wi-Fi network. Connect your computer’s Wi-Fi back to the Wi-Fi access point you just connected the Raspberry Pi to if it does not automatically reconnect.