Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HIP draft: LoRaWAN Frequency Plan Selection #298

Merged
merged 12 commits into from
Nov 13, 2021
95 changes: 95 additions & 0 deletions 004x-lorawan-frequency-plan-selection.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
# HIP 4x: LoRaWAN Frequency Plan Selection

- Author(s): @lthiery
- Start Date: 2021-10-25
- Category: Technical
- Original HIP PR:
- Tracking Issue:
- Status: In Discussion


# Problem Statement
[problem_statement]: #ProblemStatement

There are over a dozen of officially recognized LoRaWAN channel plans cited in
the [LoRaWAN Regional Specification](https://lora-alliance.org/wp-content/uploads/2021/05/RP002-1.0.3-FINAL-1.pdf):

![image single-layer](004x-lorawan-frequency-plan-selection/004x-lorawan-channel-plans.png)

The same document also provides guidance for eligible channel plans and
"LoRaWAN® Certified devices with Regulatory Type Approval":

![image single-layer](004x-lorawan-frequency-plan-selection/004x-lorawan-regional-spec-example.png)

In each region, the Helium Network must select one and only one frequency plan
(based on current design constraints). In cases where only one channel plan is
possible (eg: Anguilla) or where only one has regulatory type approval (eg:
American Samoa), the selection for the Helium Network may default to that one.

From the snippet above, you can see a few cases where selection is not so
straightforward:
* **Afghanistan, Angola, Antartica, Antigua and Barbuda, Aruba**: there is no
channel plan suggestion nor is there one support for regulatory type approval
* **Aland Island, Albania, Algeria, Armenia**: there are multiple potential
plans but not support for regulatory type approval
* **Australia**: there are _two_ potential plans and both have regulatory
type approval

These cases each special consideration which requires deep technical expertise
and local knowledge. This same reasoning also extends to countries that may
not yet have ISO 3166 recognition.

These configurations are currently encoded within the [`helium/miner` project](https://github.com/helium/miner/blob/master/priv/countries_reg_domains.csv);
lthiery marked this conversation as resolved.
Show resolved Hide resolved
this encoding may sometimes have mismatches even for even the easily defined
and those may often be implemented quickly as "bug fixes". However, for the
more ambiguous regions, disambiguation lacks rigor and process.

# Solution
[solution]: #solution

This HIP strives to solve the problem of choosing a _single_ frequency plan
per region. We believe this is an important assumption as while the network
is growing rapidly, providing core coverage on a specific frequency plan and
sub-band is critical in providing predictability for users. In other words,
fragmenting a nascent network would leave to both confusion and difficulty
roaming within even the same region.

Upon [joining the LoRaWAN Alliance as contributing member](https://www.webwire.com/ViewPressRel.asp?aId=278878),
DeWi also formed a LoRaWAN Technical Committee "to help steer the Helium
Network’s LoRaWAN infrastructure towards maximizing value for the LoRaWAN
community at large." The membership of this committee includes many other
contributing (and founding) members of the LoRaWAN Alliance and as such,
includes deep technical and business knowledge of the ecosystem.

**This HIP proposes that the DeWi LoRaWAN Committee may call for an initial
assignment or change of frequency plan per region**.
lthiery marked this conversation as resolved.
Show resolved Hide resolved

1. Upon doing so, the DeWi LoRaWAN Committee will open a Pull Request (PR)
to the [`helium/miner`](https://github.com/helium/miner) repository (or
some other publicly accessible repository) marking the change and providing the
reasoning for the change.
lthiery marked this conversation as resolved.
Show resolved Hide resolved
2. There will be a minimum two-week window during which a public commentary
lthiery marked this conversation as resolved.
Show resolved Hide resolved
will be open under the PR.
3. Should the discussion have _any_ dissent, a live virtual public forum will
be in attempt to reach consensus.
lthiery marked this conversation as resolved.
Show resolved Hide resolved
4. If the change remains contentious, the decision will go to on-chain
voting. Currently, that would be implemented using [Helium Vote](https://www.heliumvote.com/)
mechanism where 1 hotspot in the concerned region equals 1 vote. Votes
are cast by doing a DC burn transcation towards the appropriate wallet.

# Rationale and Alternatives
[alternatives]: #rationale-and-alternatives

An alternate approach would be to allow any hotspot operate to choose any legal
frequency plan. For example, operators in Australia could select AU915 _or_
AS923-1 when they assert location. We believe this to be problematic as it will
lead to fragmentation of coverage and confusion on behalf of network users.
Instead, we believe such mechanisms would be useful for expanding into
additional subbands.

# Deployment Impact
[deployment-impact]: #deployment-impact

A change in frequency plan could potentially cause certain devices to not be
eligible for operation under the new frequency plan, either due to hardware
or legislative contraints.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.