TTN Mapper Documentation
TTN Mapper and CoverageMap.org are tools to map the coverage of LoRaWAN networks like The Things Network, The Things Stack, Helium and ChirpStack.
Project Status
TTN Mapper is currently undergoing a major refactor to support The Things Stack (v3). To fully support TTS, TTN Mapper needs to be able to support multiple networks. This is a big change to the backend systems, and has already started in December 2018. The current major focus is uniquely identifying a network and gateways. After this is sorted out the focus will shift to the website.
General
- Live mapping data feeds to new backend - since 2020-06-27 19:46 UTC
- Gateway updates from V2 and V3 into new backend - V2 since 2020-06-27 19:37 UTC, V3 since 2021-07-03 09:35 UTC
- Migrate old gateway locations from old to new database. Completed on 2021-09-04.
- Migrate old mapping data (before 2020-06-27 19:46 UTC) to new database. Completed 2021-09-18.
- Migrate old experiments (before 2020-06-27 19:46 UTC) to new database. Completed 2021-10-08.
- Clean up gateway moves: remove duplicate locations, using oldest entry. Done 2021-09-19.
- Heatmap plots from new backend. Shows only coverage for online gateways since 2021-11-14.
- Add V2 to V3 coverage migrate form and script. Partial. Google form set up.
- Generate radar plots from new backend
- Circle plots, area plots
- Website rewrite in JS framework - help wanted
- Website user logins, network claims, private network subscriptions - help wanted
- Simulation based coverage - research topic
- Cross platform mobile app (Flutter) - help wanted
The Things Network V2
- Data accepted and stored in TTN Mapper’s database
- Android app support
- iOS app support
- Integration: available on v2 console
- Device raw data: available
- Gateway raw data: available
- Gateway markers: available
- Gateway online/offline status: available
- Radar plots: available
- Heatmap: available as a combined heatmap for all networks
- Area plots: available
The Things Stack
- Data accepted and stored in TTN Mapper’s database
- Android app support
- iOS app support: not yet implemented - help needed
- Webhook Template: available on v3 console. See V3 integration.
- Device raw data: Using the Advanced maps, one can view your device’s raw data on the map. This will only show non-experimental points. The CSV option for per-device raw data will show experimental and non-experimental data.
- Experiment raw data
- Gateway raw data: available
- Gateway markers: partial. V3 gateway markers are currently only shown per network on the heatmap. Homepage shows TTS-CE (TTNv3).
- Gateway status: gateway statuses pulls from Packet Broker mapping API
- Radar plots: not yet implemented
- Heatmap: Data from all networks are currently used to draw heatmaps. This needs to change to be a per-network heatmap.
- Area plots: not yet implemented
Issues
- Network identification
Chirp Stack
- Data accepted and stored in TTN Mapper’s database
- Android app support - partial, as network identification needs to be refactored
- iOS app support
- Integration: TTN Mapper will ingest data from ChirpStack if a webhook integration has been set up, according to ChirpStack integration.
- Device raw data: available
- Gateway raw data: available
- Gateway markers: partially available
- Gateway status: unsure if this is available
- Radar plots: not yet implemented
- Heatmap: implemented, but only publicly available for Wolfsburg.Digital
- Area plots: not yet implemented
Issues
- Identifying a network: https://github.com/brocaar/chirpstack-network-server/issues/532
AWS IoT Core for LoRaWAN
Not yet supported.
Issues
No easy way to get data out to a REST API and on an MQTT broker.
Amazon Sidewalk
Not yet supported
Helium
Not supported, and likely no need due to https://mappers.helium.com/
Sigfox
Not supported, and will likely not be supported due to licensing restrictions.