Skip to content

Commit 1b1909e

Browse files
authored
Merge pull request #146 from arduino/marqdevx/pro-lora-gateway/getting-started
WisGate Gateway: Getting started [PC-872]
2 parents f96bd12 + 50584e4 commit 1b1909e

File tree

14 files changed

+242
-0
lines changed

14 files changed

+242
-0
lines changed
Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,147 @@
1+
---
2+
title: 'Getting Started with WisGate Edge Gateway'
3+
description: 'Tutorial for setting up the WisGate Edge Lo-Ra Gateway'
4+
difficulty: easy
5+
tags:
6+
- Getting Started
7+
- Setup
8+
author: 'Pablo Marquínez'
9+
hardware:
10+
- hardware/05.pro/mmiscellaneousis/WisGate-edge-pro
11+
software:
12+
- ide-v1
13+
- ide-v2
14+
- web-editor
15+
- iot-cloud
16+
---
17+
18+
## Introduction
19+
20+
This tutorial will show you how to get started with your **WisGate Edge** gateway and how it can be utilized by itself. It will showcase the connection to **The Things Network<sup>TM</sup>. We will go through the local and online setup.
21+
22+
## Goals
23+
24+
The goals of this article are:
25+
26+
- Setup the hardware
27+
- Connect locally to the Gateway
28+
- Open the dashboard panel
29+
- Create a Gateway on The Things Network<sup>TM</sup>(TTN)
30+
- Setup the credentials on the device from TTN
31+
- Test the Gateway (optional)
32+
33+
## Hardware & Software Needed
34+
35+
- [WisGate Edge Pro](https://store.arduino.cc/products/wisgate-edge-pro) or[WisGate Edge Lite 2](https://store.arduino.cc/products/wisgate-edge-lite-2)
36+
- x2 Ethernet Cable
37+
38+
## What's Included in the Box
39+
40+
The package includes:
41+
* LoRa Gateway
42+
* PoE Injector (with its power cable, IEC)
43+
* Pole mounting mechanical pieces
44+
45+
## Instructions
46+
47+
### Setup the Hardware
48+
49+
The device can be supplied from 37 to 57 VDC with a PoE or with a Solar panel (12 VDC).
50+
You can supply it through the Solar Panel cable (12V cable) or with an ethernet cable with PoE.
51+
52+
In case of the PoE, you can use the PoE Injector included with the kit by connecting your LAN to the `LAN` port and the `PoE` port to the Gateway.
53+
54+
55+
### Connect to the WisGate Dashboard
56+
57+
There are different ways to access the WisGate:
58+
* Connecting to its Wi-Fi Access Point (dashboarrd IP: `192.168.230.1`)
59+
* Ethernet cable from your Computer to the Gateway (dashboard IP: `192.168.230.1`)
60+
* Connecting your Gateway to your LAN, getting its DHCP IP (You will need to discover the device's IP)
61+
62+
Once you got the IP of your Gateway you can type it in your browser to access the dashboard.
63+
64+
The first time you attempt to login it will require you to set up the password of your dashboard, set your password, click set password and save it.
65+
66+
![Web dashboard - first login](assets/wisgate-dashboard-setPassword.png)
67+
68+
Once the password is set, you will now be able to see and interact with the dashboard panel.
69+
70+
![WisGate dashboard](assets/wisgate-dashboard-overview.png)
71+
72+
***The WiFi Access Point that is running, by default it is open, we recommend you to set a password with WPA2-PSK encryption to secure your device, you can do that by accessing the Wi-Fi settings going to network > LAN > Wi-Fi > Settings***
73+
74+
### Create the Gateway on TTN Dashboard
75+
76+
Go to https://cloud.thethings.network and pick your region's cluster, in our case we pick Europe.
77+
78+
![TTN zone picker](assets/ttn-cluster-pick.png)
79+
80+
Now chose the gateway button.
81+
82+
![TTN device type selection](assets/ttn-overview-picker.png)
83+
84+
It will open the Gateways page, click the create gateway button
85+
86+
![TTN Gateways dashboard](assets/ttn-gateways.png)
87+
88+
Fill the required forms.
89+
90+
![TTN Gateway creation](assets/ttn-add-gateway.png)
91+
92+
Fill the information:
93+
* Gateway ID: unique ID for your gateway inside the things network platform.
94+
* Gateway EUI: The EUI of your WisGate Gateway (Get it on the overview page on the WisGate dashboard)
95+
* Gateway name: Name of the Gateway on your TTN's profile
96+
* Gateway Server Address: the Address of the LoRa network (format: `wss://<cloudServer>`)
97+
* LoRaWAN options:
98+
* Frequency plan: select the recommended plan or the one that fits your project
99+
100+
Click the "Create gateway" button at the end of the page.
101+
102+
### Setup your Gateway with the TTN Credentials
103+
104+
Access to the Network configuration by clicking on its button.
105+
106+
![WisGate web dashboard](assets/wisgate-dashboard-configuration.png)
107+
108+
On the configuration tab select the work mode to "Basic station"
109+
110+
![WisGate basic station configuration](assets/wisgate-basic-setup.png)
111+
112+
Then at the "Basic station server setup" section pick the "LNS Server" as a type.
113+
114+
Fill the Server URL with `wss://eu1.cloud.thethings.network` (for EU) and the port `8887`
115+
116+
The authentication Mode "TLS Server & Client token Authentication"
117+
118+
Choose the file with the certificates that you can download from [here](https://letsencrypt.org/certs/isrgrootx1.pem)
119+
120+
And the client token that you can get inside the TTN Gateway's dashboard panel.
121+
122+
![Wisgate gateway configuration with TTNos info](assets/ttn-gateway-dashboard-server.png)
123+
124+
Click the API key on the top right and create a new one.
125+
126+
![Wisgate dashboard using TTN's API key](assets/ttn-api-key.png)
127+
128+
Set the "Rights" to individual ones and chose the "Link as gateway to a Gateway Server for traffic exchange"
129+
130+
Then paste it on the WisGate dashboard form as `Authorization: <YOUR_API_KEY>`
131+
132+
Click "Save changes".
133+
134+
After finishing the setup you could see the Gateway status being "Connected"
135+
136+
![TTN dashboard showing the gateway online](assets/ttn-gateway-connected.png)
137+
138+
### Test (Optional)
139+
140+
Follow this tutorial to connect to the GateWay [Connecting MKR WAN 1300 to The Things Network (TTN)](https://docs.arduino.cc/tutorials/mkr-wan-1300/the-things-network)
141+
142+
## Next Step
143+
144+
145+
## Conclusion
146+
147+
In this tutorial you learned how to setup the LoRa Gateway
Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
---
2+
title: 'Mounting WisGate Edge PRO Gateway on a Pole'
3+
description: 'Tutorial for mounting the WisGate Edge Lo-Ra Gateway in an antenna Pole'
4+
difficulty: easy
5+
tags:
6+
- Mechanical
7+
- Setup
8+
author: 'Pablo Marquínez'
9+
hardware:
10+
- hardware/05.pro/mmiscellaneousis/WisGate-edge-pro
11+
---
12+
13+
## Introduction
14+
15+
This tutorial will show you how to mount your **WisGate Edge** gateway on an outdoors pole.
16+
17+
## Goals
18+
19+
The goals of this article are:
20+
21+
- Assembly the mechanical pieces on the device
22+
- Attach the device on your pole
23+
24+
## Hardware & Software Needed
25+
26+
- [WisGate Edge Pro](https://store.arduino.cc/products/wisgate-edge-pro)
27+
28+
## Instructions
29+
30+
The mechanical pieces are included with the device, those will make the device fit on an outdoors pole firmly and safe.
31+
* 2 Clamps
32+
* 1 Bracket
33+
* 2 Antennas
34+
35+
### Assembly the Bracket to the Enclosure
36+
37+
Turn the gateway, on the back it has four holes for screws, align those with the bracket and screw them.
38+
39+
The bar from the bracket should be on the aiming towards the top, where the antennas are connected.
40+
41+
42+
<iframe
43+
width="720"
44+
height="405"
45+
loop="true"
46+
src="https://www.youtube.com/embed/xvFH9clAQwg?autoplay=1&controls=0&loop=1&mute=1&playlist=xvFH9clAQwg" frameborder="0"
47+
>
48+
</iframe>
49+
50+
### Clamps on the Pole
51+
52+
Take the bigger clamp and introduce one screw on the hole that fits better for your pole, grab the smaller clamp and align it with the screw, after that you should take a nut and make it closer to the smaller clamp, repeat it with the other side, first just make sure everything is aligned and then fasten them properly with a screwdriver.
53+
54+
***The clamp is also suitable to be mounted using hose clamps (not included) you should then use the rectangular holes on the bigger clamp***
55+
56+
<iframe
57+
width="720"
58+
height="405"
59+
loop="true"
60+
src="https://www.youtube.com/embed/tVmZoD38XZo?autoplay=1&controls=0&loop=1&mute=1&playlist=tVmZoD38XZo" frameborder="0"
61+
>
62+
</iframe>
63+
64+
### Attaching the bracket on the clamps
65+
66+
Once both the bracket on the gateway and the clamps on the pole are properly fasten, it is time to attach the gateway to the pole.
67+
After it's attached fasten one M6*12 screws on each side.
68+
69+
As shown in the following video:
70+
71+
<iframe
72+
width="720"
73+
height="405"
74+
loop="true"
75+
src="https://www.youtube.com/embed/PZONsccUlMo?autoplay=1&controls=0&loop=1&mute=1&playlist=PZONsccUlMo" frameborder="0"
76+
>
77+
</iframe>
78+
79+
### Coupling the Antennas
80+
81+
On the top side of the gateway fasten both N-Type fiberglass antennas.
82+
83+
<iframe
84+
width="720"
85+
height="405"
86+
loop="true"
87+
src="https://www.youtube.com/embed/6KmyJA9n28I?autoplay=1&controls=0&loop=1&mute=1&playlist=6KmyJA9n28I" frameborder="0"
88+
>
89+
</iframe>
90+
91+
92+
## Next Step
93+
94+
95+
## Conclusion

0 commit comments

Comments
 (0)