Installation and configuration manual
Video tutorial:
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
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.
Step #2: Mount a WaziHat on the Raspberry PI.
Be careful to align correctly the pins in the arrays.
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.
Step #2: Download Balena Etcher and install it on your PC.
Step #3: Open the Balena Etcher tool and select the downloaded zip file.
Step #4: Insert your SD card to your PC and when appear, select it in Etcher
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.
Step #6: When Flashing is done, remove your Micro SD card and insert it into your raspberry pi.
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.
Step #2: Plug the power cable (micro usb) into the gateway and plug the adapter to the outlet.
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.
Step #2: Connect to the Wazigate WiFi hotspot
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.
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 “User Profile” menu.
Connecting to the Internet
Step #1: Select menu Settings/Wifi.
A list of available Wifi networks will show up:
Once Wazigate found all the available WiFi networks in range, click on the network that you want to connect to.
Step #2: Enter the password for that network and click on “connect”.
Warning: Once you setup your WaziGate to connect to a WiFi network, you will lose the Hotspot connection.
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.
Registration with the Cloud
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 #1: Clik on the Sync menu.
Step #2: Enter you Cloud Username and Password and click Save.
You need to enter your CLOUD login/password, collected on https://dashboard.waziup.io/. Do not enter your gateway password here.
Step #3: Flip the Active Sync ON.
If you receive an error message, it mean either you enter a wrong login/password, or you are not connected to internet.
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
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
Use a web browser on your laptop and open http://
Verify Gateway Registration
Step #1: Open the waziup dashboard
Go to the Waziup website.
Step #2: Click on “Go to Dashboard” and enter your credentials and Login.
Step #3: Click on 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.
Step #5: Logging into your Wazigate.
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 needed only if you want to connect your gateway to your PC directly with an ethernet cable.
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
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”.
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.
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’
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.
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.