mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-09-20 08:07:33 -07:00
63 lines
2.6 KiB
Plaintext
63 lines
2.6 KiB
Plaintext
---
|
|
id: integrations-caltopo
|
|
title: CalTopo / SARTopo
|
|
sidebar_label: CalTopo / SARTopo
|
|
sidebar_position: 1
|
|
---
|
|
|
|
## CalTopo / SARTopo
|
|
|
|
Meshtastic can integrate with [CalTopo](https://caltopo.com/) Desktop edition quite easily through the product's APRS over serial support functionality.
|
|
|
|
<object data="https://www.youtube.com/embed/z_51FAPPl34
|
|
?autohide=1&autoplay=0" width="100%" height="400"></object>
|
|
|
|
|
|
### Configuring the Meshtastic device
|
|
|
|
To configure our Meshtastic device for this integration, we have a couple of different options, both of which utilize the [Serial module](/docs/configuration/module/serial):
|
|
|
|
#### Enabling serial over the device's USB port
|
|
```shell title="Serial over USB"
|
|
meshtastic --set serial.enabled true --set serial.baud BAUD_9600 --set serial.mode CALTOPO --set serial.override_console_serial_port true
|
|
```
|
|
|
|
#### Enabling serial over an external USB to Serial adapter
|
|
```shell title="External serial adapter"
|
|
meshtastic --set serial.enabled true --set serial.baud BAUD_9600 --set serial.mode CALTOPO --set serial.txd = 13 --set serial.rxd = 14
|
|
```
|
|
|
|
:::info
|
|
Ensure that serial baud rate is set to `9600` on both the Meshtastic device and the CalTopo / SARTopo `topo.properties` configuration
|
|
:::
|
|
|
|
|
|
### Setting up CalTopo / SARTopo
|
|
|
|
To setup CalTopo for Meshtastic integration using the Live Tracking via APRS, refer to the official [documentation](https://training.caltopo.com/all_users/share/live-tracking#aprs).
|
|
|
|
Example `topo.properties` file configuration for use with Meshtastic:
|
|
|
|
|
|
|
|
After starting CalTopo Desktop, NMEA waypoint location sentences should be streamed into the logs from the connected Meshtastic device every 10 seconds:
|
|
|
|
|
|
|
|
In the desktop's web UI for your CalTopo map, scroll down and check the **Shared Locations** checkbox under **Realtime Data**. Your nodes should appear on the map as points if they are connected correctly.
|
|
|
|
|
|
|
|
You can click on one or more of the node points and in the resulting tooltip, click **Record to Map**
|
|
|
|
|
|
|
|
In the resulting dialog, you can assign attributes such as a label or color to the live track created by the node.
|
|
|
|
|
|
|
|
|
|
When you view the shared map on another device or mobile, the nodes should appear there as well now, if both the desktop and mobile device have internet connectivity.
|
|
|
|
|