Skip to content

Commit 051ceb4

Browse files
author
Laurens Slats
authored
Merge pull request TheThingsIndustries#321 from TheThingsIndustries/mikrotik-knot-documentation
doc: Add Mikrotik KNOT documentation
2 parents 9c9350b + 7f933c0 commit 051ceb4

9 files changed

Lines changed: 93 additions & 0 deletions

File tree

141 KB
Loading
Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
---
2+
title: "MikroTik KNOT"
3+
description: ""
4+
weight: 1
5+
---
6+
7+
{{< figure src="mikrotik-knot.jpeg" alt="Ltmikrotik-knotAP" class="plain float" >}}
8+
9+
The MikroTik KNOT LR8/LR9 kit is a universal device with exceptional connectivity options and protocol support. It is an IoT Gateway which can use ethernet or LTE-M (also known as CAT-M) technology as the gateway backhaul.
10+
11+
<!--more-->
12+
13+
For more info, see Mikrotik's [official product page](https://mikrotik.com/product/knot).
14+
15+
## Prerequisites
16+
17+
1. User account on {{% tts %}} with rights to create Gateways.
18+
2. MikroTik KNOT connected to Internet via Ethernet or LTE-M.
19+
3. A web browser (see section [Configuration via Browser](#configuration-via-browser)), or the [MikroTik Mobile App](https://mikrotik.com/mobile_app) installed on a smartphone.
20+
21+
{{< warning >}} Currently, this gateway does not support changing Frequency Plans. {{</ warning >}}
22+
23+
## Registration
24+
25+
Create a gateway by following the instructions for [Adding Gateways]({{< ref "/gateways/adding-gateways" >}}). The **EUI** of the gateway can be found on the back panel of the gateway under the field **GW ID**, or under the **Gateway ID** in the LoRa tab of the MikroTik web GUI.
26+
27+
## Configuration via Browser
28+
29+
The MikroTik Routerboard exposes a WiFi Access Point (AP) with SSID `MikroTik-xxxxxx`, where `xxxxxx` are the last 6 digits of the device's MAC address. Use your PC, tablet or smartphone to connect to this AP. You will not need a password to connect to this AP.
30+
31+
{{< info >}} By opening your browser to `http://192.168.88.1/webfig` you will be able to access the RouterOS web interface and configure your gateway device. {{</ info >}}
32+
33+
![MikroTik-portal.png](portal.png)
34+
35+
Select **LoRa** on the left hand menu. The status of the gateway should be **Disabled** - if needed, press the **D** button to disable it.
36+
37+
![MikroTik-portal-lora.png](portal-lora.png)
38+
39+
{{< note >}}
40+
The **Gateway ID** you see here is the **Gateway EUI** you need to register the gateway in The Things Stack.
41+
{{</ note >}}
42+
43+
From the top menu, select the **Servers** tab and press the **Add New** button.
44+
45+
![MikroTik-server](servers.png)
46+
47+
Edit the server parameters.
48+
49+
- **Name**: A distinct name which you can define yourself
50+
- **Address**: Address of {{% tts %}} Gateway Server. If you followed the [Getting Started guide]({{< ref "/getting-started" >}}) this is the same as what you use instead of `thethings.example.com` (for example: `eu1.cloud.thethings.network` for The Things Stack Community Edition in Europe).
51+
- **Up port**: UDP upstream port of the Gateway Server, typically `1700`.
52+
- **Down port**: UDP downstream port of the Gateway Server, typically `1700`.
53+
54+
Press **OK** to save the parameters.
55+
56+
![MikroTik-paramters](parameters.png)
57+
58+
From the top menu, select the **Devices** tab. Click the **Gateway ID** to configure the gateway.
59+
60+
![MikroTik-Devices](portal-lora-disable.png)
61+
62+
In the device settings, click the **Network Servers** drop-down menu to view available servers. Choose the server you created in the previous step.
63+
64+
Select **Public** for the **Network** and click **OK** to save these parameters.
65+
66+
Press the **E** button to enable the gateway device (it is enabled when **E** becomes **D**) and the device status will update.
67+
68+
If your configuration was successful, your gateway will connect to {{% tts %}} after a couple of seconds.
69+
70+
## Set up LTE-M
71+
Connect an external antenna to the LTE-M antenna connector.
72+
73+
<img src="KNOT-antenna.png" alt="KNOT Antennas" title="KNOT Antennas" width="250" />
74+
75+
Go to [**Interfaces**](http://192.168.88.1/webfig/#Interfaces), click on **PPP-out1** and fill out the **APN settings** of your operator.
76+
77+
To test whether a connection with your LTE-M network is established, go to the **Terminal** tab in the RouterOS web interface and run the command:
78+
79+
```
80+
$ /interface ppp-client info ppp-out1
81+
```
82+
If the gateway is set up correctly, it will respond with a message like:
83+
84+
```
85+
modem-status: ready
86+
pin-status: no password required
87+
functionality: full
88+
manufacturer: Quectel
89+
model: BG77
90+
revision: BG77LAR02A04
91+
current-operator: LMT (n/a)
92+
signal-strength: -67 dBm
93+
```
10.4 KB
Loading
11.2 KB
Loading
290 KB
Loading
308 KB
Loading
312 KB
Loading
246 KB
Loading
276 KB
Loading

0 commit comments

Comments
 (0)