Repository files navigation

hplans is a geojson representation of the LoRaWAN regional parameter channel plans. It is based on the LoRaWAN Alliance'sRP2-1.0.4 LoRaWAN Regional Parameters, as well as theHelium Network's country definitions.

The geojson does not contain the channel plan and spectrum definitions; it only contains the geographic regions they apply to.

These regions are used to determine what channel plan hotspots should be using. When a hotspot's location is asserted, the LoRaWAN region is looked up and set depending on its location.

These geojson regions are used bylorawan-h3 to generate binary lists of Uber h3 hex areas with associated regions.

h3idx files are created, which contain a binary list of user h3 hexes for each region. These files are used by the miner to determine which plan to use.

The dataset was originally download fromhttps://osm-boundaries.com/, and based off theregions.csv file usinggetgeojson.py. This code is no longer used, and was moved to the repo'sarchive folder. Each LoRaWAN region is captured in its own file by country.

regions.geojson contains all regions. It is created by runningplans.py, which takes each region file, runs theunary_union function to merge all neighbouring polygons with the same region, and combines them all into a single file.

The country/region geographic borders are stored as stardard geojson. Each country is stored as a geojson polygon or multipolygon within their appropriate LoRaWAN region file. The geojson can be modified with GIS tools, online geojson editors, mapshaper, etc. The whole region file may be too large to work with so the country of interest's polygon can be put in its own file while being worked on and then merged back into its region file.

Theregions.csv should be updated, even though it is only used as an index at this point. Then, simply move the polygon from its orginal LoRaWAN region to its new one.

Once the borders have been updated or a country moved to a new region file,plans.py should be run, which will simplify withunary_union and combine all the regions into one file.