meshtastic/docs/software/integrations/caltopo.mdx

63 lines
2.6 KiB
Plaintext
Raw Normal View History

2023-06-17 04:08:54 -07:00
---
id: integrations-caltopo
title: CalTopo / SARTopo
sidebar_label: CalTopo / SARTopo
sidebar_position: 1
---
## CalTopo / SARTopo
2023-06-19 04:40:53 -07:00
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>
2023-06-17 05:03:18 -07:00
2023-06-19 04:50:51 -07:00
2023-06-17 05:03:18 -07:00
### Configuring the Meshtastic device
2023-09-28 19:10:42 -07:00
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):
2023-06-17 05:03:18 -07:00
2023-06-17 05:42:53 -07:00
#### Enabling serial over the device's USB port
2023-06-17 05:03:18 -07:00
```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
```
2023-06-17 05:42:53 -07:00
#### Enabling serial over an external USB to Serial adapter
2023-06-17 05:03:18 -07:00
```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
2023-06-17 07:26:52 -07:00
Ensure that serial baud rate is set to `9600` on both the Meshtastic device and the CalTopo / SARTopo `topo.properties` configuration
2023-06-17 05:03:18 -07:00
:::
2023-06-17 07:26:52 -07:00
### Setting up CalTopo / SARTopo
2023-06-17 05:03:18 -07:00
2023-06-17 07:28:43 -07:00
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).
2023-06-17 05:03:18 -07:00
2023-06-17 07:26:52 -07:00
Example `topo.properties` file configuration for use with Meshtastic:
2023-06-17 05:03:18 -07:00
2023-06-17 15:59:21 -07:00
![topo.properties](/img/software/integrations/caltopo/properties.png)
2023-06-17 15:27:22 -07:00
After starting CalTopo Desktop, NMEA waypoint location sentences should be streamed into the logs from the connected Meshtastic device every 10 seconds:
2023-06-17 15:59:21 -07:00
![CalTopo Logs](/img/software/integrations/caltopo/logs.png)
2023-06-17 15:27:22 -07:00
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.
2023-06-17 15:59:21 -07:00
![shared-locations](/img/software/integrations/caltopo/local-stations.png)
2023-06-17 15:27:22 -07:00
You can click on one or more of the node points and in the resulting tooltip, click **Record to Map**
![node point](/img/software/integrations/caltopo/click.png)
In the resulting dialog, you can assign attributes such as a label or color to the live track created by the node.
![track](/img/software/integrations/caltopo/track.png)
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.
![app](/img/software/integrations/caltopo/app.png)