Merge pull request #1737 from TelemetryHarbor/master

Meshtastic Telemetry on Grafana Using Cloud - Telemetry Harbor
This commit is contained in:
pdxlocations 2025-03-01 13:39:35 -08:00 committed by GitHub
commit 3dba179e71
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 55 additions and 0 deletions

View file

@ -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. - [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. - [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. - [Contact](https://github.com/pdxlocations/contact) - A TUI console client for Meshtastic devices. Built with the curses library.
- [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. Support for these projects should be sought from their respective authors.

View file

@ -0,0 +1,53 @@
---
id: telemetry-harbor
title: Telemetry Harbor Integration
sidebar_label: Telemetry Harbor
sidebar_position: 5
---
## 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)