Merge pull request #332 from arduino/sync/marqdevx/pro-lora-gateway/product-page

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

Author: marqdevx

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/compatibility.yml

@@ -0,0 +1,8 @@
+hardware:
+  boards:
+    - mkr-wan-1300
+    - mkr-wan-1310
+  shields:
+    - portenta-vision-shield
+  carriers:
+    - portenta-max-carrier

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/essentials.md

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

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/features.md

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

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/image.svg

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

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/product.md

@@ -0,0 +1 @@
+Here you will find the technical specifications for the Arduino® Wisgate Edge Lite 2 gateway for LoRaWAN®.

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/tech-specs.md

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

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/tech-specs.yml

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

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/tutorials/getting-started/assets/ttn-add-gateway.png

@@ -0,0 +1,8 @@
+hardware:
+  boards:
+    - mkr-wan-1300
+    - mkr-wan-1310
+  shields:
+    - portenta-vision-shield
+  carriers:
+    - portenta-max-carrier

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/tutorials/getting-started/assets/ttn-api-key.png

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

content/hardware/04.pro/miscellaneous/wisgate-edge-lite-2/tutorials/getting-started/assets/ttn-cluster-pick.png

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