Merge pull request #272 from pycom/pygate_fixes

Pygate fixes

Author: Xykon

config.toml

@@ -359,12 +359,19 @@ theme = "doc-theme"
     parent = "tutorials@all"
     weight = 10
 
- [[menu.main]]
-    name = "PyGate"
-    url = "/tutorials/all/PyGate/"
-    identifier = "tutorials@all@PyGate"
-    parent = "tutorials@all"
-    weight = 10
+[[menu.main]]
+   name = "PyGate"
+   url = "/tutorials/all/PyGate/"
+   identifier = "tutorials@all@PyGate"
+   parent = "tutorials@all"
+   weight = 10
+
+[[menu.main]]
+  name = "PoE"
+  url = "/tutorials/all/PoE/"
+  identifier = "tutorials@all@PoE"
+  parent = "tutorials@all"
+  weight = 12
 
 [[menu.main]]
     name = "WLAN"

content/firmwareapi/pycom/machine/pygate.md

@@ -6,7 +6,7 @@ aliases:
     - chapter/firmwareapi/pycom/machine/pygate
 ---
 
-The Pygate is an 8-channel LoRaWAN gateway. You connect a WiPy or Gpy board to the Pygate and flash a firmware build where the Pygate functionality is enabled. See the [Pygate tutorial](/tutorials/all/pygate) to get started.
+The Pygate is an 8-channel LoRaWAN gateway. Connect a WiPy, Gpy or LoPy4 board to the Pygate and flash the Pygate firmware. See the [Pygate tutorial](/tutorials/all/pygate) to get started.
 
 ## Methods
 

content/firmwareapi/pycom/network/eth.md

@@ -10,7 +10,12 @@ The ETH class enables the use of an ethernet connection via the PyEthernet board
 
 ---
 *NOTE* :
-Ethernet support is only available in special Gpy or WiPy firmware builds where this feature has been enabled.
+Ethernet support is only available in the Pygate firmware build.
+
+---
+
+*NOTE2* :
+The PyEthernet board is connected via SPI bus 3 and GPIO's 17-19 and 21-23. So this bus and pins cannot be used concurrently with ethernet. This also means that on a LoPy4 with Pygate firmware, the LoRa module of the LoPy4 is disabled, since it is also connected via SPI 3. Of course you can still use the LoRa gateway functionality since this uses the LoRa modules on the the Pygate board itself.
 
 ---
 

content/tutorials/all/PoE.md

@@ -0,0 +1,22 @@
+---
+title: "PoE"
+aliases:
+    - tutorials/all/PoE.html
+    - tutorials/all/PoE.md
+    - chapter/tutorials/all/PoE
+---
+
+The PyEthernet module has onboard Power over Ethernet (PoE) power supply. This means that you can power your hardware with only an ethernet cable coming from a power injector. However, since the PoE is non-isolated, you must adhere to the following warning!
+
+WARNING:
+
+PoE power supply of PyEthernet module has no galvanic isolation. This means, that in accordance with
+IEEE 802.3-2005 standard you must make sure that when powered from PoE power injector there are no other external connections to any part of the module or other hardware where it is installed. Such as USB cable, serial to USB bridge, logic analyser, an oscilloscope, etc.
+
+As in certain hardware configurations it can lead to unrecoverable damage of not only the PyEthernet module but all hardware connected to it.
+
+Be aware - violation of that requirement voids Pycom warranty.
+
+The use of battery with PoE is allowed.
+
+![](/gitbook/assets/PoE-NI.png)

content/tutorials/all/PyGate.md

@@ -2,15 +2,17 @@
 
 The Pygate is an 8-channel LoRaWAN gateway. This page will help you get started with it.
 
+The Pygate board can have an PyEthernet adapter connected which allows an ethernet connection. The PyEthernet also support PoE. Do check the separate [page and warning for PoE-NI!](/tutorials/all/poe)
+
 ### Quickstart
 
 To connect your Pygate to a LoRa server, follow these steps:
 
-1. Attach a Wipy, or GPy to the Pygate. The RGB LED of the development board should be aligned with the USB port of the Pygate.
+1. Attach a WiPy, GPy or LoPy4 to the Pygate. The RGB LED of the development board should be aligned with the USB port of the Pygate.
 1. Attach the LoRa Antenna to the Pygate.
 1. Flash the Pycom Device with with a firmware build where Pygate functionality is enabled.
 1. Create a `config.json` for your Pygate and upload it.
-1. Create a `main.py` that creates an uplink and runs the Pygate packet fowarder.
+1. Create a `main.py` that creates an uplink (wifi, ethernet or lte) and runs the LoRa packet fowarder.
 1. Run the `main.py`.
 1. Now it is operational. The communication from other LoRa nodes such as a LoPy4 will now reach the gateway and will receive up and downlink via the PyGate.
 1. To stop the Pygate at any time press Ctrl-C on the REPL and run `machine.pygate_deinit()`. It will take a few seconds to stop the gateway tasks and safely power-off the concentrator.
@@ -23,13 +25,16 @@ Make sure you supply a config matching your region (EU868, US915, etc), e.g. htt
 
 The following example shows the script and json file to run the Pygate over Wifi connecting to [The Things Network](https://www.thethingsnetwork.org/).
 
- * log in to https://console.thethingsnetwork.org/
- * go to Gateways and register a new gateway
- * select "I'm using a legacy packet forwarder"
- * enter a EUI (8 byte hexadecimal value) - also enter this in your `config.json` for `gateway_ID` (Just enter the digits without the "eui-" prefix)
- * select your Frequency Plan
- * select a router - also enter the hostname in your `config.json` for `server_address`
- * enter your wifi SSID and password in `main.py`
+1. log in to https://console.thethingsnetwork.org/
+1. go to Gateways and register a new gateway
+1. select "I'm using a legacy packet forwarder"
+1. make up a EUI (8 byte hexadecimal value) and register it on the TTN website
+1. enter the EUI in your `config.json` under `gateway_ID` (Just enter the hex digits without the "eui-" prefix and without spaces)
+1. select your Frequency Plan
+1. select a router - also enter the hostname in your `config.json` under `server_address`
+1. enter your wifi SSID and password in `main.py`
+1. upload `config.json` and `main.py` and reset the board
+1. you will see how it creates the uplink connection and then start the LoRa GW. It will print out some debug information while it is running. After some initialization it will print "LoRa GW started" and the LED will turn green.
 
 
 
@@ -70,7 +75,7 @@ print("Wifi Connection established")
 
 # Sync time via NTP server for GW timestamps on Events
 rtc = RTC()
-rtc.ntp_sync(server="0.nl.pool.ntp.org")
+rtc.ntp_sync(server="0.pool.ntp.org")
 
 # Read the GW config file from Filesystem
 fp = open('/flash/config.json','r')