Skip to content

Commit

Permalink
Add Stack info links (#551)
Browse files Browse the repository at this point in the history
* doc: Add info links

* doc: TTS tags

* doc: Add tts shortcode
  • Loading branch information
LDannijs authored Jun 25, 2024
1 parent e64c092 commit c763055
Show file tree
Hide file tree
Showing 5 changed files with 17 additions and 0 deletions.
4 changes: 4 additions & 0 deletions doc/content/lorawan/adaptive-data-rate/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,10 @@ Mobile end devices should be able to detect when they are stationary for a longe

## ADR in The Things Stack

{{< info >}}
Check [{{% tts %}} documentation](https://www.thethingsindustries.com/docs/reference/adr/#how-adr-works) for more specifics on how ADR works on the {{% tts %}}.
{{</ info >}}

To determine the optimal data rate, the network needs some measurements (uplink messages). Currently The Things Stack takes the 20 most recent uplinks, starting at the moment the ADR bit is set. These measurements contains the frame counter, signal-to-noise ratio (SNR) and number of gateways that received each uplink. When a device unsets the ADR bit (because it knows it is moving or it knows RF conditions are unstable), previous measurements are discarded. As soon as the ADR bit is set again, the network starts measuring again.

For each of these measurements, we take the SNR of the best gateway, and we calculate the so-called "margin", which is the measured SNR minus the required SNR to demodulate a message given the data rate. This margin is used to determine how much we can increase the data rate or lower the transmit power. For example, when the network receives a message with data rate `SF12BW125` and SNR `5.0`, that message has a margin of 25 dB. This is a waste of valuable airtime and energy. If we would increase the data rate to `SF7BW125` we would still have a margin of 12.5 dB, but that would be many times more airtime- and energy efficient. We could even lower the transmit power to save even more energy and cause less interference.
Expand Down
4 changes: 4 additions & 0 deletions doc/content/lorawan/end-device-activation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,10 @@ Every end device must be registered with a network before sending and receiving

The join procedure for LoRaWAN 1.0.x and 1.1 is slightly different. The following two sections describe the join procedure for LoRaWAN 1.0.x and 1.1 separately.

{{< info >}}
For more information on the differences between OTAA and ABP, check the [{{% tts %}} documentation](https://www.thethingsindustries.com/docs/the-things-stack/concepts/data-formats/).
{{</ info >}}

## Over The Air Activation in LoRaWAN 1.0.x

In LoRaWAN 1.0.x, the join procedure requires two MAC messages to be exchanged between the end device and the Network Server:
Expand Down
4 changes: 4 additions & 0 deletions doc/content/lorawan/message-types/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ images:
- payload.png
---

{{< info >}}
For information on {{% tts %}} specific data formats, check [{{% tts %}} documentation](https://www.thethingsindustries.com/docs/the-things-stack/concepts/data-formats/).
{{</ info >}}

In this chapter, you will learn about different message types used in LoRaWAN 1.0.x and 1.1. These message types are used to transport MAC commands and application data. The Things Fundamentals Certification exam expects you should have basic knowledge on the following topics with regards to the message types:

* Uplink and downlink messages.
Expand Down
4 changes: 4 additions & 0 deletions doc/content/lorawan/regional-parameters/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ section: The Things Fundamentals
weight: 40
---

{{< info >}}
For information on the specific versions of the Regional Parameters check [{{% tts %}} documentation](https://www.thethingsindustries.com/docs/the-things-stack/concepts/spec-regional-parameters/).
{{</ info >}}

LoRaWAN operates in unlicensed radio spectrum. This means that anyone can use the radio frequencies without having to pay million dollar fees for transmission rights. It is similar to WiFi, which uses the 2.4GHz and 5GHz ISM bands worldwide. Anyone is allowed to set up WiFi routers and transmit WiFi signals without the need for a license or permit.

LoRaWAN uses lower radio frequencies with a longer range. The fact that frequencies have a longer range also comes with more restrictions, that are often country-specific. This poses a challenge for LoRaWAN, as it strives to maintain uniformity across various regions of the world. As a result, LoRaWAN is specified for several bands within these regions. These bands are similar enough to support a region-agnostic protocol but entail various consequences for the implementation of backend systems.
Expand Down
1 change: 1 addition & 0 deletions doc/layouts/shortcodes/tts.html
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{{- printf "The Things Stack" -}}

0 comments on commit c763055

Please sign in to comment.