×
IoT platform 
About us 
Media 
Documentation 
Courses 
Downloads 
Forum 
DIY 
Wazihub 

WaziGate User Manual

Overview

This document will guide you through the steps to assemble your Wazigate and configure it in order to connect to the Waziup Cloud. This documentation is available in PDF format.

Prepare the Gateway Hardware

If you have a Raspberry PI and want to setup your WaziGate yourself this section is for you. If you already have your Wazigate in a box, just skip this section.

What do you need to start?

You need the following hardware to start:

  • A Raspberry Pi (Model 3B+ is recommended)
  • An SD card (minimum 8 GB)
  • A power supply for the raspberry pi (usually 5.1V, 2+A)
  • A LoRa antenna
  • A LoRa Hat such as WaziHat

Hardware elements

You also need the following software:

Assemble the WaziGate

There are only two simple steps to assemble your WaziGate.

Step #1: Attach the heat sinks.

As WaziGate can perform Edge processing on you data, it is always a good idea to attach heat sinks in order to avoid overheating. Raspberry PI can have 3 heatsinks, on the 3 processors.

Heat sink mounting

Step #2: Mount a WaziHat on the Raspberry PI.

Be careful to align correctly the pins in the arrays.

WaziHat mounted

Note: If you do not have a Wazihat board and want to use your own LoRa module, please refer to this documentation.

Flash the WaziGate

Step #1: Download the latest version of the Wazigate ISO image.

Save Wazigate ISO image

Step #2: Download Balena Etcher and install it on your PC.

Balena etcher

Step #3: Open the Balena Etcher tool and select the downloaded zip file.

Select the ISO image

Step #4: Insert your SD card to your PC and when appear, select it in Etcher

Select the SD card drive

Warning: Your Micro SD card must be at least 8 GB. 16 GB is better.

If your laptop does not have the SD card reader, you need a USB adapter to connect your Micro SD card to your PC.

Step #5: Click on Flash to start flashing.

Flashing...

Step #6: When Flashing is done, remove your Micro SD card and insert it into your raspberry pi.

Flashing complete

Congratulations! Your hardware is now ready.

Powering up Wazigate

Step #1: Attach the antenna

Very Important: always connect the antenna first, before powering up your device.

Antenna attached

Step #2: Plug the power cable (micro usb) into the gateway and plug the adapter to the outlet.

Power adapter

You should see a light is on and another light next to it is actively blinking.

Configuration

Find the Wazigate Web UI

Step #1: Find the wazigate hotspot

When you power up Wazigate for the first time, it usually does some self-configs and reboots itself. So, be patient, it might take a couple of minutes for you to see the Wazigate WiFi hotspot to connect to.

The WiFi hotspot has a similar name of what you see in the photo: WAZIGATE_XXXXX. XXXXX usually is the ID of your gateway.

Select WaziGate hotspot

Step #2: Connect to the Wazigate WiFi hotspot

Enter hotspot password

The default password for the hotspot is loragateway
Enter the password and click on connect.

Step #3: Open the Wazigate Web UI.

Wazigate is configured through a web user interface. When you connect to the Wazigate hotspot, you need to open your browser and go to one of the following addresses:

Then you should see something like this.

WaziGate login page

Please enter the default username and password and click on Login.

For security reasons, please change the default password as soon as you can see the profile page. This page can be found in the menu at the top-right corner of the screen.

Change your password

Registration with the Cloud

Step #1: Login for the first time.

When you login for the first time, you should see something like this.

First login

Note: Setup wizard is also accessible from the side menu.

Setup wizard

If you do not have an account on Waziup dashboard, you need to create one first.

A Waziup account enables you to receive all your sensor data in your dashboard and manage your Wazigate remotely.

Step #2: Configure Wazigate to be recognized by the Cloud.

Once you click on Yes in the previous page, you should see something like this:

Cloud registration

Step #3: Give a nice name to your gateway

Gateway name

Gateway Name is a custom name that you give to your gateway to be able to identify this particular gateway from your other gateways. It can be anything like Fish Farm gateway, Water Control Gateway, Ali’s Field Gateway, and so on. After writing, hit the Enter button on your keyboard or click on the icon to save your values.

Step #4: Set WaziCloud credentials in Wazigate

Click on the [Empty] value next to the Email Address / Login and enter your waziup dashboard email address and save it.

Set up login and password

Do the same thing for password as well. When you save successfully both login and password values, click on the Next button.

Connecting to the Internet

Step #1: Select Wifi network and enter password.

If you plan to connect your Wazigate through another way like Ethernet cable or 3G/4G dongle, then just click on Skip.

Wifi config

Once Wazigate found all the available WiFi networks in range, click on the network that you want to connect to and enter its password in the box.

Step #3: Click on Connect and Finish.

Connect Wifi

Warning: Once you setup your WaziGate to connect to a WiFi network, you will lose the Hotspot connection.

Hotspot disconnected

If you enter your WiFi password correctly and the internet is available, after a few minutes you will be able to see it in your WaziCloud dashboard.

Note: If Wazigate does not manage to connect to your WiFi due to wrong credentials or not being in the range of the WiFi router, it will rollback to the hotspot mode and you need to connect to it again and start over. This might take a few minutes depending on the router.

Connect to your gateway

At this stage, your gateway should have access to internet. However in order to connect to it,we need to find its IP. If you have OLED installed on raspberry pi the IP will be shown directly on the screen

OLED IP

Otherwise you can find it by following this simple tutorial: - Download AngryIP Scanner here - Connect your PC/Laptop on the same Wi-Fi that the raspberry pi is connected to - Scan the IPs

The IP of the gateway should be in the result

IP scanner

Use a web browser on your laptop and open http://

Verify Gateway Registration

Step #1: Open the waziup dashboard

Go to the Waziup website.

Waziup.io website

Step #2: Click on “Go to Dashboard” and enter your credentials and Login.

Register a user

Step #3: Click on Gateways.

Gateways

If everything went well so far, you should see your gateway in the list.

Step #4: Click on your gateway.

Your gateway details will open.

Step #5: Then click on the “Remote access” button.

Gateway details

Step #5: Logging into your Wazigate.

Remote login

If you see something like this, then Congratulations! :) You made it.
Now you can simply manage your gateway remotely through your Waziup dashboard.

Annex

Connect with Ethernet cable to PC

This section will guide you to connect your Wazigate to your PC using an Ethernet cable. This is useful to access the WaziGate UI for configuration. You should have the following hardware:

  • A Waziup gateway with power cable (mini USB)
  • A laptop/PC with an RJ45 slot or adapter
  • A RJ45 cable (simple network cable)
  • Internet access on your laptop/PC

First, connect the RJ45 cable between your laptop/PC and the WaziGate.

In order to connect from your computer to the WaziGate, we need to activate the DHCP service on your computer. The local DHCP will attribute an IP address to the WaziGate. This option is usually called “Share the internet connection” on your computer. The following sections show the procedure for Windows, Mac and Linux.

Windows

On Windows, do the following:

Step #1: Open Control panel.

Press shortcut key combination Windows + R , type “control” and click ok button

Control panel

Here click on “Network and Internet” menu and then “Network and sharing center”.

Step #2: Select sharing connection.

Click on your internet connection and go to “Properties”.

Select connection

Step #3: Allow sharing connection.

Switch to the “Sharing” tab and check the box to allow other users to connect to the internet through your computer.

Allow sharing W.

The WaziGate should now have an IP. You can connect to it using this link: http://wazigate.local.

Linux

On Linux, do the following:

Step #1: Open connection editor.

Open the connection editor through the terminal using the comand:

  nm-connection-editor


If nm-connection-editor if not present, you need to install it.

Step #2: Sharing connection.

When it opens, select the wired connection item, clicking the edit button. In that menu, switch to the IPv4 tab, and select the method: ‘shared to other computers’

Allow sharing L.

After that, save everything and connect your cable if you haven’t already, and DHCP should kick-in and set everything up for you.

The WaziGate should now have an IP. You can connect to it using this link: http://wazigate.local.

Note: if you need to get the IP address of the connection, you can use ifconfig. You’ll only need this if DHCP doesn’t automatically configure everything.

Mac

On Mac, do the following:

Step #1: Open Sharing menu.

  • Open System Preferences. It’s typically found on your dock, if not, it’s in your Applications folder.
  • In System Preferences, under Internet & Wireless, go into the Sharing menu.

Step #2: Sharing connection.

In the Sharing menu, choose Internet Sharing from the list on the left. You will see Internet Sharing options.

Allow sharing M.

Select to share your connection from Wi-Fi, to computers using Ethernet. After that, click on the Internet Sharing checkbox to enable the service.

The WaziGate should now have an IP. You can connect to it using this link: http://wazigate.local.