Document connecting popular gateways

[johanstokking]

Summary

Document connecting popular gateways

Why do we need this?

For people to know how to connect their gateway using official documentation, on a per-gateway model basis

What is already there? What do you see now?

No documentation

What is missing? What do you want to see?

Documentation for phase 1 (UDP-based gateways):

• Cisco IXM
• Lorix One
• RAK7240
• Ursalink
• ST - P-NUCLEO-LRWAN2
• Laird Sentrius RG1xx
• Kerlink iBTS Compact
• Kerlink iFemtocell
• Kerlink IoT Station – Add Kerlink Wirnet connection guide #1631 @rvolosatovs is assigned
• MultiTech Conduit AEP – doc: Added MultiTech Conduit AEP gateway documentation #1793 but needs fix
• MultiTech Conduit mlinux - Documention Multitech mLinux #2733
• MikroTik Routerboard - doc: Add guide for MikroTik Routerboard #1964
• Tektelic Kona Micro (Terminal) Document Tektelic Micro config using terminal #1742
• Tektelic Kona Micro (GUI) and small follow up (Document Tektelic Micro config using terminal #1742 (review))
• Tektelic Kona Pico
• The Things Kickstarter Gateway - @KrishnaIyer @adriansmares
• NASys LoRaWAN Outdoor Gateway - @neoaggelos Document connecting a NASYS LoRaWAN Outdoor Gateway to TTS #1765
• The Things Outdoor Gateway

Documentation for phase 2 (Basic Station gateways):

• Basic Station common Add Basic Station connection guide #2594
• The Things Indoor Gateway TTI issue #2088

Documentation for phase 3 (existing gateways that are getting Basic Station support):

• Cisco IXM with Basic Station
• MultiTech Conduit AEP with Basic Station
• Laird Sentrius with Basic Station
• Lorix One with Basic Station
• Ursalink with Basic Station

For the UDP gateways (everything expect TTIG for now), please use the JSON configuration using GCS.

This is a URL that people need to build manually.

How do you propose to implement this?

• Make sure you have a stock version of these gateways. If we don't have one, please let me know and we'll get one. You can also start with copying docs from https://www.thethingsnetwork.org/docs/gateways
• Probably refer to a common section about creating a gateway and UDP configuration
• Add a guide in the docs, one file for each gateway brand and/or model, depending on how it looks

Can you do this yourself and submit a Pull Request?

Will review

[johanstokking]

Looped in @adriansmares for support as well. Please coordinate accordingly.

[johanstokking]

Added Cisco IXM

[johanstokking]

See also existing documentation on https://www.thethingsnetwork.org/docs/gateways/

This should act as a reference; that documentation has grown over time and does not follow one style or structure.

Please start with defining a style and structure and align all gateway documentation with that.

[KrishnaIyer]

@adriansmares, @mjamescompton and @johanstokking:

• I've created a feature branch for this feature/gateway-documentation. Please target all PRs to this branch.
• The first candidate is here: Add The Things Gateway connection guide #1368

[laurensslats]

@benolayinka can we revisit this list and see what gateway documentation we still want to add?

Suggesting to:

• Look at the Kerlink documentation, we might be able to improve the quality
• Tektelic gateways with Basics Station
• RAK with UDP & Basics Station

[johanstokking]

Please open issues specific for gateway models.