Repository files navigation

LoRaWAN regions represented as serialized (little endian)H3 indices whichbuild a h3 map based on a geojson source file.

lw-generator is used to generate compressed h3 index file (extension.h3idz)for a given regionupstream geojson. Note that generating h3 index files cantake a VERY long time.

The h3 index files are built asrelease assets for this repository when taggedwith aregion_maps_YYYY.MM.DD tag

lw-generator is also used to generate compressed region parameters for a givenregion parameters json file.

The region parameter files are built asrelease assets for this repositorywhen tagged with aregion_params_YYYY.MM.DD tag

Supported regions are listed in theregions.txt file. New supported regionsmust be added there with correspondingupstream geojson andregionparameters json files.

Generate IN865.res7.h3irz fom IN865.geojson.

$ target/release/lw-generator index generate extern/hplans/IN865.geojson IN865.res7.h3idz

AMakefile is supplied to make manual generation easier, but note that indexor region parameter files are pushed asrelease assets by CI infrastructure whenthe main branch is tagged.

$ make compile$ make -j index

Generate IN865.rpz from IN865.json

$ target/release/lw-generator params generate region_params/IN865.json IN865.rpz

The supliedMakefile can make manual generation easier, but note that indexor region parameter files are pushed as release assets by CI infrastructure whenthe main branch is tagged.

$ make compile$ make -j params

lw-generator is the tool used to generate or export region index maps or region parameter files

Native build:

$ cargo build --release

or using theMakefile:

$ make compile

Release a new version oflw-generator usingcargo release with one of the supported release options.

A release will be built by CI and pushed as arelease assets. To use therelease in region index or region parameter generation, make sure to adjust theversion in theSetup | Tools section for in theregion_maps.yml andregion_params.yml CI files.