From 7262ca1e219a00b3502198c1b24fb84522303a86 Mon Sep 17 00:00:00 2001 From: Adrelien <116389637+Adrelien@users.noreply.github.com> Date: Thu, 27 Feb 2025 22:20:18 +0300 Subject: [PATCH 1/6] Update index.mdx --- docs/software/integrations/index.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/software/integrations/index.mdx b/docs/software/integrations/index.mdx index 28f70a0a..0568908c 100644 --- a/docs/software/integrations/index.mdx +++ b/docs/software/integrations/index.mdx @@ -15,4 +15,6 @@ Current Meshtastic integrations: - [MQTT](/docs/software/integrations/mqtt) - Bridging mesh networks over the internet and integrating Meshtastic protocols with popular technologies such as Home Assistant, Node Red, and Adafruit IO. +- [Telemetry Harbor - Grafana](/docs/software/integrations/telemetryharbor) - A cloud-based solution for collecting, storing, and visualizing Meshtastic telemetry data using grafana. + Support for the integrated products should be sought from their respective authors or vendors. From 0e61508ec912e4b9fa702772565cbc2d4bbc83de Mon Sep 17 00:00:00 2001 From: Adrelien <116389637+Adrelien@users.noreply.github.com> Date: Thu, 27 Feb 2025 22:23:00 +0300 Subject: [PATCH 2/6] Create telemetryharbor.mdx --- .../software/integrations/telemetryharbor.mdx | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/software/integrations/telemetryharbor.mdx diff --git a/docs/software/integrations/telemetryharbor.mdx b/docs/software/integrations/telemetryharbor.mdx new file mode 100644 index 00000000..afa78e91 --- /dev/null +++ b/docs/software/integrations/telemetryharbor.mdx @@ -0,0 +1,53 @@ +--- +id: integrations-telemetry-harbor +title: Telemetry Harbor Integration +sidebar_label: Telemetry Harbor +sidebar_position: 3 +--- + +## Using Telemetry Harbor with Meshtastic + +### How to Use + +#### Prepare Your Meshtastic Device + +1. Ensure your Meshtastic device is connected and operational. +2. Note the COM port associated with the device. + +#### Set Up the Script + +Clone this repository: + +```sh +git clone https://github.com/TelemetryHarbor/harbor-meshtastic.git +cd harbor-meshtastic +``` + +Install required dependencies: + +```sh +pip install -r requirements.txt +``` + +#### Run the Script + +Execute the script and provide the required information: + +- **Batch Endpoint**: Obtain this from your Telemetry Harbor account. +- **API Key**: Your unique key for secure communication. +- **COM Port**: The port your Meshtastic device is connected to. + +```sh +python app.py +``` + +#### Stream Data + +The script will push telemetry data from your device to the Telemetry Harbor batch endpoint. + +#### Visualize in Grafana + +1. Log in to your Telemetry Harbor Grafana instance. +2. Access pre-configured dashboards to view and analyze your Meshtastic data. + +[Repository Link](https://github.com/TelemetryHarbor/harbor-meshtastic) From 583fc98791fc3f1a866ef963ae6f0e11cf402c0a Mon Sep 17 00:00:00 2001 From: Adrelien <116389637+Adrelien@users.noreply.github.com> Date: Fri, 28 Feb 2025 12:49:28 +0300 Subject: [PATCH 3/6] Adding Saudi Arabia region-by-country.mdx --- docs/configuration/region-by-country.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/configuration/region-by-country.mdx b/docs/configuration/region-by-country.mdx index 9e5ecbed..fd845a4a 100644 --- a/docs/configuration/region-by-country.mdx +++ b/docs/configuration/region-by-country.mdx @@ -141,6 +141,8 @@ If you'd like to contribute information for your country, click the "Edit this p | Country | LoRa Region | Regulatory document | | ----------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Saudi Arabia | EU_868
EU_433 | [CST Regulations](https://www.cst.gov.sa/en/RulesandSystems/RegulatoryDocuments/FrequencySpectrum/Documents/SM%20002%20E-NFP.pdf) | + | Serbia | EU_868
EU_433 | | | Singapore | SG_923 | [IMDA Regulations](https://www.imda.gov.sg/-/media/imda/files/regulation-licensing-and-consultations/ict-standards/telecommunication-standards/radio-comms/imdatssrd.pdf) | | Slovakia | EU_868
EU_433 | [Slovak regulations](https://eur-lex.europa.eu/legal-content/SK/TXT/PDF/?uri=CELEX:32022D0180) | From 67732859240495fb3d42f70d14be067cb14804f4 Mon Sep 17 00:00:00 2001 From: Adrelien <116389637+Adrelien@users.noreply.github.com> Date: Fri, 28 Feb 2025 17:09:35 +0000 Subject: [PATCH 4/6] moved to software --- docs/community/software/index.mdx | 2 ++ .../integrations => community/software}/telemetryharbor.mdx | 2 +- docs/software/integrations/index.mdx | 2 -- 3 files changed, 3 insertions(+), 3 deletions(-) rename docs/{software/integrations => community/software}/telemetryharbor.mdx (98%) diff --git a/docs/community/software/index.mdx b/docs/community/software/index.mdx index 39e3fd0e..6e378535 100644 --- a/docs/community/software/index.mdx +++ b/docs/community/software/index.mdx @@ -14,5 +14,7 @@ Current community projects: - [Node-RED Messages Node](/docs/community/software/community-node-red-messages) - Node-RED node to send and receive packets / text messages from a device connected via HTTP. - [MQTT Connect for Meshtastic](https://github.com/pdxlocations/MQTT-Connect-for-Meshtastic) - A nodeless python client for communicating with Meshtastic devices over MQTT. - [Contact](https://github.com/pdxlocations/contact) - A TUI console client for Meshtastic devices. Built with the curses library. +- [Telemetry Harbor - Grafana](/docs/community/software/telemetryharbor) - A cloud-based solution for collecting, storing, and visualizing Meshtastic telemetry data using grafana. + Support for these projects should be sought from their respective authors. diff --git a/docs/software/integrations/telemetryharbor.mdx b/docs/community/software/telemetryharbor.mdx similarity index 98% rename from docs/software/integrations/telemetryharbor.mdx rename to docs/community/software/telemetryharbor.mdx index afa78e91..13245dd6 100644 --- a/docs/software/integrations/telemetryharbor.mdx +++ b/docs/community/software/telemetryharbor.mdx @@ -2,7 +2,7 @@ id: integrations-telemetry-harbor title: Telemetry Harbor Integration sidebar_label: Telemetry Harbor -sidebar_position: 3 +sidebar_position: 5 --- ## Using Telemetry Harbor with Meshtastic diff --git a/docs/software/integrations/index.mdx b/docs/software/integrations/index.mdx index 0568908c..28f70a0a 100644 --- a/docs/software/integrations/index.mdx +++ b/docs/software/integrations/index.mdx @@ -15,6 +15,4 @@ Current Meshtastic integrations: - [MQTT](/docs/software/integrations/mqtt) - Bridging mesh networks over the internet and integrating Meshtastic protocols with popular technologies such as Home Assistant, Node Red, and Adafruit IO. -- [Telemetry Harbor - Grafana](/docs/software/integrations/telemetryharbor) - A cloud-based solution for collecting, storing, and visualizing Meshtastic telemetry data using grafana. - Support for the integrated products should be sought from their respective authors or vendors. From 9856b0873c348112c595dcc98ee5a3c00727918c Mon Sep 17 00:00:00 2001 From: Adrelien <116389637+Adrelien@users.noreply.github.com> Date: Sat, 1 Mar 2025 12:06:55 +0000 Subject: [PATCH 5/6] revert saudi arabia --- docs/configuration/region-by-country.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/configuration/region-by-country.mdx b/docs/configuration/region-by-country.mdx index fd845a4a..9e5ecbed 100644 --- a/docs/configuration/region-by-country.mdx +++ b/docs/configuration/region-by-country.mdx @@ -141,8 +141,6 @@ If you'd like to contribute information for your country, click the "Edit this p | Country | LoRa Region | Regulatory document | | ----------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Saudi Arabia | EU_868
EU_433 | [CST Regulations](https://www.cst.gov.sa/en/RulesandSystems/RegulatoryDocuments/FrequencySpectrum/Documents/SM%20002%20E-NFP.pdf) | - | Serbia | EU_868
EU_433 | | | Singapore | SG_923 | [IMDA Regulations](https://www.imda.gov.sg/-/media/imda/files/regulation-licensing-and-consultations/ict-standards/telecommunication-standards/radio-comms/imdatssrd.pdf) | | Slovakia | EU_868
EU_433 | [Slovak regulations](https://eur-lex.europa.eu/legal-content/SK/TXT/PDF/?uri=CELEX:32022D0180) | From e14da859d5ca670381eec18312c60eb47dec1868 Mon Sep 17 00:00:00 2001 From: Adrelien <116389637+Adrelien@users.noreply.github.com> Date: Sat, 1 Mar 2025 12:10:19 +0000 Subject: [PATCH 6/6] fixed the wrong page id --- docs/community/software/index.mdx | 2 +- docs/community/software/telemetryharbor.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/community/software/index.mdx b/docs/community/software/index.mdx index 6e378535..571e7a68 100644 --- a/docs/community/software/index.mdx +++ b/docs/community/software/index.mdx @@ -14,7 +14,7 @@ Current community projects: - [Node-RED Messages Node](/docs/community/software/community-node-red-messages) - Node-RED node to send and receive packets / text messages from a device connected via HTTP. - [MQTT Connect for Meshtastic](https://github.com/pdxlocations/MQTT-Connect-for-Meshtastic) - A nodeless python client for communicating with Meshtastic devices over MQTT. - [Contact](https://github.com/pdxlocations/contact) - A TUI console client for Meshtastic devices. Built with the curses library. -- [Telemetry Harbor - Grafana](/docs/community/software/telemetryharbor) - A cloud-based solution for collecting, storing, and visualizing Meshtastic telemetry data using grafana. +- [Telemetry Harbor - Grafana](/docs/community/software/telemetry-harbor) - A cloud-based solution for collecting, storing, and visualizing Meshtastic telemetry data using grafana. Support for these projects should be sought from their respective authors. diff --git a/docs/community/software/telemetryharbor.mdx b/docs/community/software/telemetryharbor.mdx index 13245dd6..5fa0d459 100644 --- a/docs/community/software/telemetryharbor.mdx +++ b/docs/community/software/telemetryharbor.mdx @@ -1,5 +1,5 @@ --- -id: integrations-telemetry-harbor +id: telemetry-harbor title: Telemetry Harbor Integration sidebar_label: Telemetry Harbor sidebar_position: 5