Skip to content

Launch WisGate Edge Gateways (Outdoors and Indoors) [PC-906][PC-872] #332

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 32 commits into from
Jul 6, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
3d67800
Add draft
marqdevx May 27, 2022
62a6855
Trigger build
marqdevx May 31, 2022
f7e106b
Split 2 gateways, update and fix product pages
marqdevx Jun 8, 2022
f9df208
Add draft
marqdevx Jun 3, 2022
b5a3d5b
Small changes
marqdevx Jun 7, 2022
5b9daa4
Move tutorial
marqdevx Jun 8, 2022
0058882
fix typo
marqdevx Jun 13, 2022
0bd9a07
Fix product name
marqdevx Jun 15, 2022
8a0fca2
Fix from review
marqdevx Jun 15, 2022
d796abd
Add product 2D visua
marqdevx Jun 15, 2022
40ede93
Fix typos
marqdevx Jun 28, 2022
1adc13e
Fix linter
marqdevx Jun 28, 2022
1347830
Add image captions
marqdevx Jun 28, 2022
ee7869c
Updates from feedback
marqdevx Jun 30, 2022
9ecb3f3
Small content updates
marqdevx Jun 30, 2022
50584e4
Mechanical Assembly draft
marqdevx Jun 30, 2022
f96bd12
Link external datasheets
marqdevx Jul 1, 2022
1b1909e
Merge pull request #146 from arduino/marqdevx/pro-lora-gateway/gettin…
marqdevx Jul 1, 2022
6dc2f17
Fix GS metadata, typo and unused asset
marqdevx Jul 1, 2022
cc8d203
Simlink GS
marqdevx Jul 1, 2022
f1c1f03
Fix essentials links
marqdevx Jul 1, 2022
7cf159f
Fix quickstart link
marqdevx Jul 1, 2022
802bba9
Fix typos
marqdevx Jul 1, 2022
b20a48e
Fix typo
marqdevx Jul 4, 2022
557792c
Fix typos
marqdevx Jul 4, 2022
5e26df1
Add water sealing section
marqdevx Jul 4, 2022
d2d32c0
Small rewording
marqdevx Jul 4, 2022
1e48f02
Remove nested list
marqdevx Jul 6, 2022
cbc6645
Fix title casing
marqdevx Jul 6, 2022
4060128
Update store links
marqdevx Jul 6, 2022
8950d06
Fix store links
marqdevx Jul 6, 2022
10bb7ea
trigger build
marqdevx Jul 6, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions content/hardware/04.pro/miscellaneous/category.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: Miscellaneous
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
hardware:
boards:
- mkr-wan-1300
- mkr-wan-1310
shields:
- portenta-vision-shield
carriers:
- portenta-max-carrier
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<EssentialsColumn title="First Steps">
<EssentialElement title="Quickstart Guide" type="getting-started" link="/tutorials/wisgate-edge-lite-2/getting-started">
A quick guide to setup and configure the device.
</EssentialElement>
</EssentialsColumn>
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
<FeatureDescription>

The **WisGate Edge Lite 2** gateway is a device with a high reliability that allows to set up home and small medium-sized industrial indoor LoRaWAN® applications with a high execution efficiency.

It supports 8 LoRa channels, multi backhaul with Ethernet, Wi-Fi, and Cellular connectivity.

The gateway is powered by OpenWRT which allows to develop custom applications.

</FeatureDescription>


<FeatureList>

<Feature title="Connectivity" image="mcu">
8 configurable channels. Wi-Fi, LTE and Ethernet.
Internal antenna for Wi-Fi, GPS, and LTE, external antenna for LoRa.
</Feature>

<Feature title="Wi-Fi Access Point" image="environment">
WiFi configurable as a traditional Access Point.
</Feature>

<Feature title="Cellular connectivity" image="environment">
LTE Cellular connectivity via a nanoSIM card.
</Feature>

<Feature title="Network Server and MQTT integration" image="environment">
Embedded MQTT client with Bridging capabilities for direct connectivity to most of the
Cloud platforms
</Feature>

<Feature title="Easy and fast configuration" image="configurability">
Thanks to OpenWRT and OpenVPN the out-of-the-box installation is quick and clear, also allowing advanced setups.
</Feature>

</FeatureList>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: WisGate Edge Lite 2
url_shop: https://store.arduino.cc/pages/wisgate-lora-gateways
url_guide: /tutorials/wisgate-edge-lite-2/getting-started
url_datasheet: https://docs.rakwireless.com/Product-Categories/WisGate/RAK7268/Datasheet
---

The WisGate Edge Lite 2 gateway for LoRaWAN® embeds RAKwireless<sup>TM</sup> technologies and allows you to set home and small medium-sized industrial indoor applications

Different models (SKU) are compatibles with three radio frequencies adopted in different regions of the world: Europe, United States, Australia and New Zealand*

>(*) The user is responsible for respecting the local regulations of the country of installation and use the model with the approved frequency spectrum only
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Here you will find the technical specifications for the Arduino® Wisgate Edge Lite 2 gateway for LoRaWAN®.
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
Board:
Name: Arduino® WisGate Edge Lite 2
SKU:
EU: TXP00098
ENZ: TXP00100
US: TXP00099
Computing: MT7628, DDR2 RAM 128 MB
Operating temperature: -10 ºC to +55 ºC
Wi-Fi:
Frequency: 2.4 GHz (802.11 bgn)
RX Sensitivity: -95 dBm (Min)
TX Power: 20 dBm (Max)
Operation channels: 2.4 GHz 1-13
LoRa:
Controller: SX1302 Mini PCIe card
Channels: 8
RX Sensitivity: -139 dBm (Min)
TX Power: 27 dBm (Max)
Extra: Listen Before Talk
Antennas:
LTE: Internal
Wi-Fi: Internal
Lo-Ra: RP-SMA female connector
Ethernet: RJ45 (10/100 Mbps)
Power:
Input: 12V 1A (Power supply Included)
PoE (IEEE 802.3 af): 36-57 VDC
Consumption: 12 W (typical)
Console: Through USB-C
Frequencies:
EU868: TXP00098
US915: TXP00099
AS923 & AU915: TXP00100
Enclosure:
Protection Rating: IP30
Materials: Plastic
Weight: 0.3 Kg
Dimensions: 166 x 127 x 36 mm
Mounting method: Wall
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
---
title: 'Getting Started with WisGate Edge Gateway'
description: 'Tutorial for setting up the WisGate Edge Lo-Ra Gateway'
difficulty: easy
tags: [Getting Started, Setup]
author: 'Pablo Marquínez'
hardware:
- hardware/04.pro/miscellaneous/wisgate-edge-lite-2
- hardware/04.pro/miscellaneous/wisgate-edge-pro
---

## Introduction

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.

## Goals

The goals of this article are:

- Setup the hardware
- Connect locally to the Gateway
- Open the dashboard panel
- Create a Gateway on The Things Network<sup>TM</sup>(TTN)
- Setup the credentials on the device from TTN
- Test the Gateway (optional)

## Hardware & Software Needed

- [WisGate Edge Pro or WisGate Edge Lite 2](https://store.arduino.cc/pages/wisgate-lora-gateways)
- x2 Ethernet Cable

## What's Included in the Box

The package includes:
* LoRa Gateway
* PoE Injector (with its power cable, IEC)
* Pole mounting mechanical pieces

## Instructions

### Setup the Hardware

The device can be supplied from 37 to 57 VDC with a PoE or with a Solar panel (12 VDC).
You can supply it through the Solar Panel cable (12V cable) or with an ethernet cable with PoE.

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.


### Connect to the WisGate Dashboard

There are different ways to access the WisGate:
* Connecting to its Wi-Fi Access Point (dashboard IP: `192.168.230.1`)
* Ethernet cable from your Computer to the Gateway (dashboard IP: `192.168.230.1`)
* Connecting your Gateway to your LAN, getting its DHCP IP (You will need to discover the device's IP)

Once you got the IP of your Gateway you can type it in your browser to access the dashboard.

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.

![Web dashboard - first login](assets/wisgate-dashboard-setPassword.png)

Once the password is set, you will now be able to see and interact with the dashboard panel.

![WisGate dashboard](assets/wisgate-dashboard-overview.png)

***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***

### Create the Gateway on TTN Dashboard

Go to https://cloud.thethings.network and pick your region's cluster, in our case we pick Europe.

![TTN zone picker](assets/ttn-cluster-pick.png)

Now chose the gateway button.

![TTN device type selection](assets/ttn-overview-picker.png)

It will open the Gateways page, click the create gateway button

![TTN Gateways dashboard](assets/ttn-gateways.png)

Fill the required forms.

![TTN Gateway creation](assets/ttn-add-gateway.png)

Fill the information:
* Gateway ID: unique ID for your gateway inside the things network platform.
* Gateway EUI: The EUI of your WisGate Gateway (Get it on the overview page on the WisGate dashboard)
* Gateway name: Name of the Gateway on your TTN's profile
* Gateway Server Address: the Address of the LoRa network (format: `wss://<cloudServer>`)
* LoRaWAN options, Frequency plan: select the recommended plan or the one that fits your project

Click the "Create gateway" button at the end of the page.

You will see the new gateway added to your list.

![TTN Gateway created](assets/ttn-dashboard-gateways.png)

### Setup Your Gateway with the TTN Credentials

Access to the Network configuration by clicking on its button.

![WisGate web dashboard](assets/wisgate-dashboard-configuration.png)

On the configuration tab select the work mode to "Basic station"

![WisGate basic station configuration](assets/wisgate-basic-setup.png)

Then at the "Basic station server setup" section pick the "LNS Server" as a type.

Fill the Server URL with `wss://eu1.cloud.thethings.network` (for EU) and the port `8887`

The authentication Mode "TLS Server & Client token Authentication"

Choose the file with the certificates that you can download from [here](https://letsencrypt.org/certs/isrgrootx1.pem)

And the client token that you can get inside the TTN Gateway's dashboard panel.

![Wisgate gateway configuration with TTN info](assets/ttn-gateway-dashboard-server.png)

Click the API key on the top right and create a new one.

![Wisgate dashboard using TTN's API key](assets/ttn-api-key.png)

Set the "Rights" to individual ones and chose the "Link as gateway to a Gateway Server for traffic exchange"

Then paste it on the WisGate dashboard form as `Authorization: <YOUR_API_KEY>`

Click "Save changes".

After finishing the setup you could see the Gateway status being "Connected"

![TTN dashboard showing the gateway online](assets/ttn-gateway-connected.png)

### Test (Optional)

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)

## Next Step


## Conclusion

In this tutorial you learned how to setup the LoRa Gateway
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
hardware:
boards:
- mkr-wan-1300
- mkr-wan-1310
shields:
- portenta-vision-shield
carriers:
- portenta-max-carrier
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<EssentialsColumn title="First Steps">
<EssentialElement title="Quickstart Guide" type="getting-started" link="/tutorials/wisgate-edge-pro/getting-started">
A quick guide to setup and configure the device.
</EssentialElement>
<EssentialElement title="Outdoors mounting" type="getting-started" link="/tutorials/wisgate-edge-pro/pole-mounting">
Install the device on an outdoors antenna pole.
</EssentialElement>
</EssentialsColumn>
33 changes: 33 additions & 0 deletions content/hardware/04.pro/miscellaneous/wisgate-edge-pro/features.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
<FeatureDescription>

The **WisGate Edge PRO** gateway is an industrial-graded device with high reliability and suits every requirements for an IoT commercial deployment.

It supports 16 LoRaWAN® channels thanks to a Dual LoRaWAN® Concentrator, and multi backhaul connectivity via Ethernet, Wi-Fi, and Cellular LTE. The design of its enclosure allows internal antennas for LTE, Wi-Fi, and GPS.

It is powered by OpenWRT which allows to develop custom applications.

</FeatureDescription>

<FeatureList>

<Feature title="Connectivity" image="mcu">
Dual LoRa Concentrators with 16 channels and dual fiberglass 5dB external antennas. Wi-Fi, LTE and GPS with internal antennas. Ethernet with PoE Capabilities.
</Feature>

<Feature title="Wi-Fi Access Point" image="environment">
WiFi configurable as a traditional Access Point.
</Feature>

<Feature title="Cellular Connectivity" image="environment">
LTE Cellular connectivity via a nanoSIM card.
</Feature>

<Feature title="Network Server and MQTT integration" image="environment">
Embedded MQTT client with Bridging capabilities for direct connectivity to most of the Cloud platforms
</Feature>

<Feature title="Easy and fast configuration" image="configurability">
Thanks to OpenWRT and OpenVPN the out-of-the-box installation is quick and clear, also allowing advanced setups in an easy through a web browser dashboard.
</Feature>

</FeatureList>
Loading