1. Home
  2. Docs
  3. User Guides
  4. Avimesa Gateway for Raspberry Pi

Avimesa Gateway for Raspberry Pi

last updated 2018-Nov-1

Introduction

This project contains a user guide for the Avimesa Gateway for Raspberry Pi.

Table of Contents

Top

1. Overview

1.1 Summary

The Avimesa Gateway for Raspberry Pi is used to facilitate network communications between Avimesa devices and the Avimesa Device Cloud.

In general, the Gateway:

  1. Provides a quick and easy way to connect the gateway to a Wi-Fi network
  2. Performs automatic Avimesa device discovery and connection with no setup required
  3. Has a simple LED status showing network state for easy troubleshooting
  4. Supports up to 6 simultaneous connections, more with multiplexing
  5. Features automatic software updates

After the initial setup, no other actions should be required.

1.2 Requirements

For Wi-Fi use:

  1. A computer with Wi-Fi
  2. The Avimesa Gateway for Raspberry Pi and power supply
  3. A wireless network with an internet connection

For Ethernet use:

  1. Ethernet cable and network with an internet connection
  2. The Avimesa Gateway for Raspberry Pi and power supply

1.3 Interface

Figure 1 calls out the main components that are used in this guide:

    A. Gateway Status LED
    B. Gateway Setup Button
    C. Power Connector
    D. Ethernet Port

ug-gw-callouts
Figure 1

Top

2. Quick Start

2.1 Quick Start (Wi-Fi)

For the first time setup, do the following:

  1. Attach the power supply to the Gateway (Figure 1-C)
  2. The Gateway will boot up and the Gateway Status LED (Figure 1-A) will flash green as it’s in the Unconfigured state.
  3. Press and hold the Gateway Setup Button (Figure 1-B) for 10 seconds until the Gateway Status LED (Figure 1-A) turns solid red.
  4. Using a computer with Wi-Fi, connect to the “Avimesa-Gateway” Access Point, no password is required.
  5. Using a browser, enter the address 192.168.0.1 in the address bar and hit
  6. Enter the SSID and password for the network that you want the Gateway to connect to.
  7. Press “Save” to reset the Gateway. It will automatically connect to the configured network and the Gateway Status LED` (Figure 1-A) will turn solid green

2.1 Quick Start (Ethernet)

  1. Attach an ethernet cable to the ethernet port (Figure 1-D)
  2. Attach the power supply to the Gateway (Figure 1-C)

When using ethernet, the Gateway Status LED (Figure 1-A) and the Gateway Setup Button (Figure 1-B) are not used.

Top

3. Power Supply

The Avimesa Gateway for Raspberry Pi kit comes with a power supply that is rated for use (2.5A USB Power Supply with Micro USB Cable and Noise Filter)

Top

4. Gateway Modes (Wi-Fi)

The Gateway can be in three modes that are directly related to it’s Wi-Fi network status.

4.1 Unconfigured

When in the Unconfigured mode, the Gateway is not set up to or has failed to connect to a configured Access Point. The Gateway Status LED (Figure 1-A) will be blinking green in this state.

The Gateway Router Daemon will not run when in the state as it requires a network connection. Thus, any Avimesa devices utilizing this gateway for network connectivity will fail to synchronize with the Avimesa Device Cloud.

4.2 Gateway Setup

When in the Gateway Setup mode, the Gateway is acting as an Access Point and, using a computer, you can connect to it and access the Gateway Setup application via a web browser.

This is much the same as when connecting to your home router’s setup screen.

The Gateway Status LED (Figure 1-A) will be solid red when in this state.

The Gateway Router Daemon will not run when in the state as it requires a network connection. Thus, any Avimesa devices utilizing this gateway for network connectivity will fail to synchronize with the Avimesa Device Cloud.

4.3 Configured

When in the Configured mode, the Gateway is setup and has connected to a configured Access Point.

The Gateway Router Daemon will be running when in this state and will facilitate communications between Avimesa devices and the Avimesa Device Cloud.

The Gateway Status LED (Figure 1-A) will be solid green when in this state.

Top

5. Gateway Setup (Wi-Fi)

5.1 How to Enter Gateway Setup Mode

To enter Gateway Setup mode, press and hold the Gateway Setup Button (Figure 1-B) for more than ten (10) seconds. The Gateway Status LED (Figure 1-A) will turn solid red when it has changed modes.

When the Gateway is in Gateway Setup mode, you can connect to it from a computer using Wi-Fi. Once connected, you can configure the Gateway to connect to your Wi-Fi.

5.2 Using the Gateway Setup Application

  1. Using your computer’s Wi-Fi setup, locate the “Avimesa-Gateway” Access Point and select it to connect to the Gateway. No password is required.

avimesa-gateway-for-rpi
Figure 2

  1. Using a web browser, enter 192.168.0.1 in the address bar and press ENTER
  2. Select the SSID (network name) of the network you want the Gateway to connect to (if the network isn’t present, press the “Scan” button)
  3. Enter the network password
  4. Click on the “Save” button

avimesa-gateway-for-rpi
Figure 3

The Gateway will reboot and attempt to connect to the network that was configured.

If the Gateway Status LED (Figure 1-A) turns to solid green after the reboot, the connection was successful.

If the Gateway Status LED (Figure 1-A) turns to blinking green after the reboot, the connection was unsuccessful and the process needs to be repeated starting at step 1. Ensure the correct password was used.

Top

6. Gateway Software Updates

The Avimesa Gateway for Raspberry Pi features an automatic update mechanism that will update the gateway as necessary. When this occurs, the gateway may become inactive for a few minutes until the update completes.

Top