mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-09 23:24:10 -08:00
Merge branch 'master' into seeeeed
This commit is contained in:
Tom Fifield
GitHub
commit
dcd7297e72
|
|
@ -75,15 +75,11 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
|
|||
- [Israel Meshtastic Club](https://t.me/+yUGsbNw3zp41MGFk)
|
||||
|
||||
## Italy
|
||||
- [Meshtastic Italia](https://t.me/meshtastic_italia)
|
||||
- [Mesh_ITA Discord Server](https://discord.gg/ETFmtyzbFT)
|
||||
|
||||
## Lithuania
|
||||
- [Meshtastic Lietuva](https://www.facebook.com/groups/1122509422249414)
|
||||
|
||||
## The Netherlands
|
||||
- [Meshtastic Netherlands](https://t.me/meshtastic_nl)
|
||||
|
||||
## Poland
|
||||
- [Meshtastic Poland Matrix Space](https://matrix.to/#/#meshtasticpl:matrix.org)
|
||||
|
||||
|
|
@ -92,18 +88,13 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
|
|||
- [Meshtastic Taiwan Community 臺灣鏈網 - Discord](https://discord.gg/2vZkuckp8E)
|
||||
|
||||
## Türkiye
|
||||
- [Meshtastic Türkiye Community - Telegram (https://t.me/trmesh)
|
||||
- [Meshtastic Türkiye Community - Discord](https://discord.gg/ThcG4Arb)
|
||||
- [Meshtastic Türkiye Community - Web (https://trmesh.org)
|
||||
- [Meshtastic Türkiye Community - Telegram](https://t.me/trmesh)
|
||||
- [Meshtastic Türkiye Community - Discord](https://discord.gg/7TGnZSSA)
|
||||
- [Meshtastic Türkiye Community - Web](https://trmesh.org)
|
||||
|
||||
## Ukraine
|
||||
- [WiKi Meshtastic UA](https://wikimesh.pp.ua)
|
||||
|
||||
## United Kingdom
|
||||
- [UK Meshtastic Kent / South East](https://www.facebook.com/groups/ukmeshtastickent/)
|
||||
- [UK Meshtastic Brighton](https://www.facebook.com/groups/3696312513946679/)
|
||||
- [UK Meshtastic North East England](https://www.facebook.com/groups/meshtasticnortheastengland/)
|
||||
|
||||
## United States
|
||||
- [Midwest Mesh](https://discord.gg/wYwD56K439)
|
||||
|
||||
|
|
@ -129,7 +120,7 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
|
|||
- [Hawaii Meshnet](https://www.hawaiimesh.net/)
|
||||
|
||||
### Illinois
|
||||
- [Chicagoland Meshtastic](https://chicagolandmesh.org/)
|
||||
- [Chicagoland Mesh](https://chicagolandmesh.org)
|
||||
|
||||
### Kansas
|
||||
- [SecKC Amateur Radio Club of Kansas City and Surrounding Cities for Amateur Radio](https://ks3ckc.radio/home)
|
||||
|
|
@ -158,3 +149,6 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group.
|
|||
|
||||
### Texas
|
||||
- [Austin Mesh](https://austinmesh.org/)
|
||||
|
||||
### Wisconsin
|
||||
- [Meshconsin](https://meshconsin.org)
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ import TabItem from "@theme/TabItem";
|
|||
Using this module, a client device can ask a special Store & Forward Router to resend text messages after the client has been temporarily not in LoRa range of the mesh.
|
||||
|
||||
:::info
|
||||
Only ESP32 based devices with onboard PSRAM like the T-Beam and T3S3 can be a Store & Forward Router. Requires the device to use at least firmware version 2.2.23 and to be set as a `ROUTER` or `ROUTER_CLIENT`.
|
||||
Only ESP32 based devices with onboard PSRAM like the T-Beam and T3S3 can be a Store & Forward Router. Requires the device to use at least firmware version 2.2.23 and to be set as a `ROUTER`.
|
||||
:::
|
||||
|
||||
When a client device requests the history from the Store & Forward Router, the router will resend the text messages over LoRa that it has received. The router will only return messages that are within the time window the client has requested up to the maximum number of messages configured for the router.
|
||||
|
|
@ -33,7 +33,7 @@ Be mindful when requesting the history, as the router might send a lot of messag
|
|||
|
||||
Initial requirements for the Store and Forward Router:
|
||||
|
||||
- Must be installed on a `ROUTER` or `ROUTER_CLIENT` node.
|
||||
- Must be installed on a `ROUTER` node.
|
||||
- This is an artificial limitation, but is in place to enforce best practices.
|
||||
- Router nodes are intended to be always online. If this module misses any messages, the reliability of the stored messages will be reduced.
|
||||
- ESP32 Processor based device with onboard PSRAM (T-Beam > v1.0, T3S3, and maybe others).
|
||||
|
|
@ -41,12 +41,12 @@ Initial requirements for the Store and Forward Router:
|
|||
### Usage Overview
|
||||
|
||||
- To use / test this you will want at least 3 devices
|
||||
- One ESP32 device with PSRAM configured as `ROUTER` or `ROUTER_CLIENT`.
|
||||
- One ESP32 device with PSRAM configured as `ROUTER`.
|
||||
- Two others will be regular clients. If one client sends a text message when the other is not in range, the other can request the history from the router to receive the missed message when it is back in range.
|
||||
|
||||
### Router setup
|
||||
|
||||
- Configure your device as a `ROUTER` or `ROUTER_CLIENT`.
|
||||
- Configure your device as a `ROUTER`.
|
||||
- Name your router node something that makes it easily identifiable, aka "Router".
|
||||
- Configure the Store and Forward module
|
||||
|
||||
|
|
|
|||
|
|
@ -26,7 +26,12 @@ The device config options are: Role, Serial Output, and Debug Log. Device config
|
|||
| TAK_TRACKER | Enables automatic TAK PLI broadcasts and reduces routine broadcasts. | Standalone PLI integration with ATAK systems for communication in tactical or coordinated operations. |
|
||||
| REPEATER | Infrastructure node for extending network coverage by relaying messages with minimal overhead. Not visible in Nodes list. | Best positioned in strategic locations to maximize the network's overall coverage. Device is not shown in topology. |
|
||||
| ROUTER | Infrastructure node for extending network coverage by relaying messages. Visible in Nodes list. | Best positioned in strategic locations to maximize the network's overall coverage. Device is shown in topology. |
|
||||
| ROUTER_CLIENT | Combination of both ROUTER and CLIENT. Not for mobile devices. | Devices in a strategic position for priority routing that need to also serve as a standard CLIENT. |
|
||||
|
||||
:::tip
|
||||
Still not sure which role to use? Check out the [role configuration tips](/docs/configuration/tips/#roles)
|
||||
:::
|
||||
|
||||
Looking for ROUTER_CLIENT? This role was deprecated in firmware 2.3.15. Learn more in the [2.3.15 release notes](https://github.com/meshtastic/firmware/releases/tag/v2.3.15.deb7c27)
|
||||
|
||||
### Role Comparison
|
||||
|
||||
|
|
@ -43,12 +48,11 @@ This table shows the **default** values after selecting a preset. As always, ind
|
|||
| TAK | Yes | Optional | Regular | Yes | No | Yes |
|
||||
| TAK_TRACKER | Yes | Optional | Regular | Yes | No | Yes |
|
||||
| ROUTER | No[^2] | No | High | Yes | Yes | Yes |
|
||||
| ROUTER_CLIENT | Yes | Yes | Highest | Yes | Yes | Yes |
|
||||
| REPEATER | Yes | No | High | Yes | Yes | No |
|
||||
|
||||
[^1]: **Awake Only** indicates retransmissions will occur normally but not while asleep between transmission intervals.
|
||||
|
||||
[^2]: The Router role enables [Power Saving](/docs/configuration/radio/power/#power-saving) by default. Consider ROUTER_CLIENT if BLE/WiFi/Serial are still needed.
|
||||
[^2]: The `ROUTER` role enables [Power Saving](/docs/configuration/radio/power/#power-saving) by default (ESP32 only). When needing to update a `ROUTER` via BLE, it's recommended you utilize an admin channel to temporarily change the role in order to update and then revert when done.
|
||||
|
||||
## Notes about Power Saving + Role behavior
|
||||
|
||||
|
|
@ -160,7 +164,7 @@ All device config options are available in the python CLI. Example commands are
|
|||
| Setting | Acceptable Values | Default |
|
||||
| --------------------------------- | ----------------------------------------------------------------------------------- | ----------------- |
|
||||
| device.debug_log_enabled | `true`, `false` | `false` |
|
||||
| device.role | `CLIENT`, `CLIENT_MUTE`, `ROUTER`, `ROUTER_CLIENT`, `REPEATER`, `TRACKER`, `SENSOR` | `CLIENT` |
|
||||
| device.role | `CLIENT`, `CLIENT_MUTE`, `ROUTER`, `REPEATER`, `TRACKER`, `SENSOR` | `CLIENT` |
|
||||
| device.rebroadcast_mode | `ALL`, `ALL_SKIP_DECODING`, `LOCAL_ONLY` | `ALL` |
|
||||
| device.serial_enabled | `true`, `false` | `true` |
|
||||
| device.button_gpio | `0` - `34` | `0` |
|
||||
|
|
|
|||
|
|
@ -156,6 +156,8 @@ If you'd like to contribute information for your country, click the "Edit this p
|
|||
| --- | --- | --- |
|
||||
| Taiwan | TW | |
|
||||
| Thailand | TH | |
|
||||
| Türkiye | EU_868<br />EU_433 | [Mevzuat](https://www.mevzuat.gov.tr/mevzuat?MevzuatNo=15416&MevzuatTur=7&MevzuatTertip=5), [BTK Frekans Tahsisi](https://www.btk.gov.tr/uploads/pages/frekans-tahsisinden-muaf-telsiz-cihaz-sistemleri-olcutler-633d4ca68c0b1.pdf), [BTK Milli Frekans Planı](https://www.btk.gov.tr/uploads/pages/milli-frekans-plani-23012023.pdf) |
|
||||
|
||||
|
||||
### U
|
||||
|
||||
|
|
|
|||
|
|
@ -15,9 +15,9 @@ It is strongly recommended to keep your [ROLE](/docs/configuration/radio/device#
|
|||
- `CLIENT` nodes efficiently repeat and route packets as needed.
|
||||
- They use smart delays for rebroadcasting, improving network stability.
|
||||
|
||||
### Avoid `ROUTER`, `ROUTER_CLIENT`, and `REPEATER`
|
||||
### Avoid `ROUTER`and `REPEATER`
|
||||
|
||||
Using `ROUTER`, `ROUTER_CLIENT, or `REPEATER` roles unnecessarily can cause serious network issues:
|
||||
Using `ROUTER` or `REPEATER` roles unnecessarily can cause serious network issues:
|
||||
|
||||
- Increased risk of packet collision.
|
||||
- Reduced message delivery rates.
|
||||
|
|
|
|||
11
docs/hardware/devices/heltec-sensor/buttons.mdx
Normal file
11
docs/hardware/devices/heltec-sensor/buttons.mdx
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
id: buttons
|
||||
title: Heltec Sensor Hardware Buttons
|
||||
sidebar_label: Buttons
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
## Capsule Sensor V3
|
||||
|
||||
- **Long press 3 seconds:** Power on or shutdown.
|
||||
- **Long press 8/16 seconds:** Long press for 8~16 seconds in the shutdown state until the blue indicator lights up. At this time, the device enters the WirelessBoot mode, which can be used to upload firmware.
|
||||
75
docs/hardware/devices/heltec-sensor/index.mdx
Normal file
75
docs/hardware/devices/heltec-sensor/index.mdx
Normal file
|
|
@ -0,0 +1,75 @@
|
|||
---
|
||||
id: heltec-sensors
|
||||
title: Heltec® Plug&Play Sensors
|
||||
sidebar_label: HELTEC® Sensors
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
<Tabs
|
||||
groupId="heltec"
|
||||
queryString="heltec"
|
||||
defaultValue="v3.0"
|
||||
values={[
|
||||
{label: 'Capsule V3.0', value: 'v3.0'}
|
||||
]}>
|
||||
<TabItem value="v3.0">
|
||||
|
||||
## Heltec Capsule Sensor Rev. 3.0
|
||||
|
||||
- **MCU:**
|
||||
- ESP32-S3FN8 (WiFi & Bluetooth)
|
||||
- **LoRa Transceiver:**
|
||||
- Semtech SX1262
|
||||
- **Frequency Options:**
|
||||
- 433 MHz
|
||||
- 470 - 510 MHz
|
||||
- 863 - 870 MHz
|
||||
- 902 - 928 MHz
|
||||
- **Connectors:**
|
||||
- Magnetic suction interface
|
||||
- Antenna:
|
||||
- Dedicated 2.4 GHz SMT antenna for WiFi/Bluetooth
|
||||
- Dedicated SMT antenna for LoRa
|
||||
|
||||
### How to upload firmware
|
||||
|
||||
:::info
|
||||
Capsule Sensor V3 uses WirelessBoot mode to upload firmware, exchange information, and print logs through WiFi.
|
||||
That is, whether you update the firmware locally or via the Web, You need to get the device into WirelssBoot state first.
|
||||
:::
|
||||
Refer to this link for how to upload firmware for Capsule Sensor V3: [**Wireless Boot**](https://docs.heltec.org/en/node/esp32/capsule_sensor_v3/wireless_boot.html#).
|
||||
### Touch button/Physical button differences
|
||||
|
||||
:::warning
|
||||
Because the touch button is easy to accidentally activate while close to metal or in your pocket, Heltec has discontinued production of this version. However, a small number of samples have entered the market.
|
||||
:::
|
||||
- Button differences
|
||||
|
||||
- Other hardware differences
|
||||
1. Removal of [FDG6322C](https://www.mouser.com/datasheet/2/308/1/FDG6322C_D-2312203.pdf) (a dual N & P channel FET) from the physical-button version.
|
||||
2. Antenna filter values physical-button version (L11 = 1.8pF, C15 = 2.7nH, C24 = 1.8pF) align more closely with ESP32-S3 reference design than touch-button version (L11 = 1.6nH, C15 = 6.9pF, C24 = 2.4pF).
|
||||
|
||||
### Features
|
||||
- Meshtastic preinstalled.
|
||||
- Built-in battery.
|
||||
- Sensor replaceable.
|
||||
|
||||
### Pin
|
||||
- Connector:
|
||||
- Model name: [DF12NB(3.0)-10DS-0.5V(51)](https://resource.heltec.cn/download/Heltec%20Capsule%20Sensor%20V3/Connector.pdf)
|
||||
- Pin:
|
||||
|
||||
- More pin definitions please refer [Schematic Diagram](https://resource.heltec.cn/download/Heltec%20Capsule%20Sensor%20V3/Capsule_Main_Esp32_Schematic_Diagram.pdf)
|
||||
### Resources
|
||||
- Firmware file: `firmware-heltec_capsule_sensor_v3-X.X.X.xxxxxx.bin`
|
||||
- Purchase links
|
||||
- International
|
||||
- [Heltec](https://heltec.org/project/heltec-capsule-sensor-v3/)
|
||||
- [AliExpress](https://www.aliexpress.us/item/3256805256690400.html)
|
||||
|
||||
</TabItem>
|
||||
|
||||
</Tabs>
|
||||
51
docs/hardware/devices/heltec-sensor/peripherals.mdx
Normal file
51
docs/hardware/devices/heltec-sensor/peripherals.mdx
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
---
|
||||
id: peripherals
|
||||
title: Heltec Sensor Peripherals
|
||||
sidebar_label: Peripherals
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
import Tabs from "@theme/Tabs";
|
||||
import TabItem from "@theme/TabItem";
|
||||
|
||||
<Tabs
|
||||
groupId="heltec"
|
||||
queryString="heltec"
|
||||
defaultValue="capsule-sensor-v3"
|
||||
values={[
|
||||
{label: 'Capsule Sensor V3', value: 'capsule-sensor-v3'},
|
||||
]}>
|
||||
<TabItem value="capsule-sensor-v3">
|
||||
|
||||
## Capsule Sensor V3
|
||||
|
||||
### Introduction
|
||||
Strong extensibility is an important feature of Capsule Sensor V3. By replacing the sensor module at the bottom of the device, the device can be flexibly used in various occasions.
|
||||
|
||||
:::warning
|
||||
Different sensors may require different firmware versions, and the current version is based on the GNSS version. We will update the other firmware as soon as possible.
|
||||
:::
|
||||
|
||||
### Heltec sensor type
|
||||
:::info
|
||||
Each Capsule Sensor V3 comes with a sensor module by default when you buy it, you just need to choose it at the time of purchase. You can also purchase other sensors which is Capsule Sensor V3 from Heltec, and we will continue to expand the variety of these sensors.
|
||||
:::
|
||||
- GNSS: [Quectel_L76K_V1](https://resource.heltec.cn/download/Heltec%20Capsule%20Sensor%20V3/Quectel_L76K_V1.1-1.pdf)
|
||||
- Temperature&Humidity: [GXHTC3_EN_V2.4](https://heltec.org/project/temp-humi-sensor/)
|
||||
- 3-Axis: [DA217](https://heltec.org/project/3-axis-acceleration-sensor/)
|
||||
- Atmospheric pressure sensor: [BMP280](https://heltec.org/project/atmospheric-pressure-sensor/)
|
||||
|
||||
### Sensor module replacement step
|
||||
|
||||
1. Shutdown of device.
|
||||
2. Remove the bottom screw of the device and remove the back cover.
|
||||
3. Gently remove the old module.
|
||||
4. Plug in the new sensors.
|
||||
5. Close the cap and return the screw. If the firmware is not compatible, download a new one.
|
||||
:::warning
|
||||
Be careful not to screw too hard, otherwise it will damage the plastic structure. Also note the direction of the charging interface.
|
||||
:::
|
||||
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
|
|
@ -47,8 +47,9 @@ sudo apt install libgpiod-dev libyaml-cpp-dev libbluetooth-dev
|
|||
sudo apt install openssl libssl-dev libulfius-dev liborcania-dev
|
||||
```
|
||||
|
||||
- The .deb Package is available as part of the release, installing the binary, a systemd service, and a config file. It is compiled for Debian Bookworm and incompatible with Bullseye.
|
||||
- The .deb Package is available as [part of the release](https://github.com/meshtastic/firmware/releases/latest), installing the binary, a systemd service, and a config file. It is compiled for Debian Bookworm and incompatible with Bullseye.
|
||||
```shell
|
||||
wget https://github.com/meshtastic/firmware/releases/download/v{version}/meshtasticd_{version}_arm64.deb
|
||||
sudo apt install ./meshtasticd_{version}arm64.deb
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -87,14 +87,14 @@ The meaning of these fields is as follows:
|
|||
|
||||
- "`id`" is the unique ID for this message.
|
||||
- "`channel`" is the channel index this message was received on.
|
||||
- "`from`" is the unique node number of the node on the mesh that sent this message.
|
||||
- "`id`" inside the payload of a `NODEINFO_APP` message is the user ID of the node that sent it, which is currently just the hexadecimal representation of the node number.
|
||||
- "`from`" is the unique decimal-equivalent Node ID of the node on the mesh that sent this message. (The hexadecimal value `7efeee00` represented by an integer in decimal is `2130636288`).
|
||||
- "`id`" inside the payload of a `NODEINFO_APP` message is the hexadecimal Node ID (sometimes called User ID) of the node that sent it.
|
||||
- "`hardware`" is the [hardware model](https://github.com/meshtastic/protobufs/blob/master/meshtastic/mesh.proto#L215) of the node sending the `NODEINFO_APP` message.
|
||||
- "`longname`" is the long name of the device that sent the `NODEINFO_APP` message.
|
||||
- "`shortname`" is the short name of the device that sent the `NODEINFO_APP` message.
|
||||
- "`sender`" is the user ID of the gateway device, which is in this case the same node that sent the `NODEINFO_APP` message (the hexadecimal value `7efeee00` represented by an integer in decimal is `2130636288`).
|
||||
- "`sender`" is the hexadecimal Node ID of the gateway device, which is in this case the same node that sent the `NODEINFO_APP` message.
|
||||
- "`timestamp`" is the Unix Epoch when the message was received, represented as an integer in decimal.
|
||||
- "`to`" is the node number of the destination of the message. In this case, "-1" means it was a broadcast message (this is the decimal integer representation of `0xFFFFFFFF`).
|
||||
- "`to`" is the decimal-equivalent Node ID of the destination of the message. In this case, "-1" means it was a broadcast message (this is the decimal integer representation of `0xFFFFFFFF`).
|
||||
- "`type`" is the type of the message, in this case it was a `NODEINFO_APP` message.
|
||||
|
||||
The `from` field can thus be used as a stable identifier for a specific node. Note that in firmware prior to 2.2.0, this is a signed value in JSON, while in firmware 2.2.0 and higher, the JSON values are unsigned.
|
||||
|
|
@ -103,12 +103,18 @@ If the message received contains valid JSON in the payload, the JSON is deserial
|
|||
|
||||
|
||||
#### JSON downlink to instruct a node to send a message
|
||||
You can also send a JSON message to the topic `msh/2/json/mqtt/` to instruct a gateway node to send a message to the mesh. Note that the channel you publish it on **must** be called "mqtt". The JSON message should contain the following fields:
|
||||
You can also send a JSON message to the topic `msh/2/json/mqtt/` to instruct a gateway node to send a message to the mesh.
|
||||
|
||||
To make this work, ensure that your node has a Meshtastic channel configured called "mqtt". Enable Downlink. The PSK can be random and doesn't matter. This channel allows the node to listen to messages on the `msh/2/json/mqtt/` topic.
|
||||
|
||||
Reboot your device after creating this channel.
|
||||
|
||||
The JSON message should contain the following fields:
|
||||
|
||||
```json
|
||||
{
|
||||
"from": <node number of MQTT node>,
|
||||
"to": <node number of recipient for a DM (optional)>,
|
||||
"from": <decimal Node ID of MQTT node>,
|
||||
"to": <decimal Node ID of recipient for a DM (optional)>,
|
||||
"channel": <channel index (optional)>,
|
||||
"type": "type",
|
||||
"payload": {
|
||||
|
|
@ -118,7 +124,7 @@ You can also send a JSON message to the topic `msh/2/json/mqtt/` to instruct a g
|
|||
}
|
||||
```
|
||||
|
||||
`from` and `payload` fields are required for a valid envelope (note that in firmware <2.2.20 a field `sender` was required, but this is no longer the case). The `from` field should be equal to the node number of the node that will transmit the message. Optionally, you can specify a different channel than the primary channel by setting the `channel` field to a channel index (0-7). Furthermore, you can send a direct message by setting the `to` field to the node number of the destination. If the `to` field is not set, the message will be broadcast to all nodes on the mesh.
|
||||
`from` and `payload` fields are required for a valid envelope (note that in firmware <2.2.20 a field `sender` was required, but this is no longer the case). The `from` field should be equal to the decimal Node ID of the node that will transmit the message. If the Node ID (sometimes called User ID) is !7efeee00, then the decimal equivalent would be 2130636288. Optionally, you can specify a different channel than the primary channel by setting the `channel` field to a channel index (0-7). Furthermore, you can send a direct message by setting the `to` field to the decimal Node ID of the destination. If the `to` field is not set, the message will be broadcast to all nodes on the mesh.
|
||||
|
||||
Currently two types of messages are supported: `"sendtext"` and `"sendposition"`.
|
||||
For the type `sendtext`, the `payload` should be a string containing the text to send. For the type `sendposition`, the payload should be an object with the fields `latitude_i`, `longitude_i`, `altitude` (optional) and `time` (optional).
|
||||
|
|
|
|||
|
|
@ -8,7 +8,43 @@ sidebar_position: 4
|
|||
|
||||
The python pip package installs a "meshtastic" command line executable, which displays packets sent over the network as JSON and lets you see serial debugging information from the meshtastic devices. This command is not run inside of python, you run it from your operating system shell prompt directly. If when you type "meshtastic" it doesn't find the command and you are using Windows: Check that the python "scripts" directory is in your path.
|
||||
|
||||
## Optional Arguments
|
||||
## Connection Arguments
|
||||
|
||||
### --port PORT
|
||||
|
||||
The port the Meshtastic device is connected to, i.e. `/dev/ttyUSB0`, `/dev/cu.wchusbserial`, `COM4` etc. if unspecified, meshtastic will try to find it. Important to use when multiple devices are connected to ensure you call the command for the correct device.
|
||||
|
||||
This argument can also be specified as `--serial` or `-s`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --port /dev/ttyUSB0 --info
|
||||
meshtastic --port COM4 --info
|
||||
meshtastic -s --info
|
||||
```
|
||||
|
||||
### --host HOST
|
||||
|
||||
The hostname/ipaddr of the device to connect to (over TCP). If a host is not provided, the CLI will try to connect to `localhost`.
|
||||
|
||||
This argument can also be specified as `--tcp` or `-t`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --host meshtastic.local --info
|
||||
meshtastic --host --info
|
||||
```
|
||||
|
||||
### --ble BLE
|
||||
|
||||
Connect to a Meshtastic device using its BLE address or name. This option allows for wireless communication with the device, similar to how the `--host` option is used for TCP connections. If an address is not provided, meshtastic will try to find a compatible device that's paired.
|
||||
|
||||
This argument can also be specified as `-b`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ble "device_name_or_address" --info
|
||||
meshtastic -b --info
|
||||
```
|
||||
|
||||
## Help & Support Arguments
|
||||
|
||||
### -h or --help
|
||||
|
||||
|
|
@ -17,6 +53,25 @@ Shows a help message that describes the arguments.
|
|||
```shell title="Usage"
|
||||
meshtastic -h
|
||||
```
|
||||
|
||||
### --version
|
||||
|
||||
Show program's version number and exit.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --version
|
||||
```
|
||||
|
||||
### --support
|
||||
|
||||
Print out info that would be helpful supporting any issues.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --support
|
||||
```
|
||||
|
||||
## Optional Arguments
|
||||
|
||||
### --export-config
|
||||
|
||||
Export the configuration of the device. (to be consumed by the '--configure' command).
|
||||
|
|
@ -27,10 +82,6 @@ To create to a file with the connected device's configuration, this command's ou
|
|||
meshtastic --export-config > example_config.yaml
|
||||
```
|
||||
|
||||
```title="Usage"shell
|
||||
meshtastic --export-config
|
||||
```
|
||||
|
||||
### --configure
|
||||
|
||||
Configure radio using a yaml file.
|
||||
|
|
@ -39,29 +90,13 @@ Configure radio using a yaml file.
|
|||
meshtastic --configure example_config.yaml
|
||||
```
|
||||
|
||||
### --port PORT
|
||||
|
||||
The port the Meshtastic device is connected to, i.e. `/dev/ttyUSB0`, `/dev/cu.wchusbserial`, `COM4` etc. if unspecified, meshtastic will try to find it. Important to use when multiple devices are connected to ensure you call the command for the correct device.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --port /dev/ttyUSB0 --info
|
||||
meshtastic --port COM4 --info
|
||||
```
|
||||
|
||||
### --host HOST
|
||||
|
||||
The hostname/ipaddr of the device to connect to (over TCP).
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --host HOST
|
||||
```
|
||||
|
||||
### --seriallog SERIALLOG
|
||||
|
||||
Logs device serial output to either 'stdout', 'none' or a filename to append to.
|
||||
Logs device serial output to either 'stdout', 'none' or a filename to append to. Defaults to 'stdout' if no filename is specified.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --port /dev/ttyUSB0 --seriallog
|
||||
meshtastic -t meshtastic.local --seriallog log.txt
|
||||
```
|
||||
|
||||
### --info
|
||||
|
|
@ -114,12 +149,20 @@ meshtastic --nodes
|
|||
|
||||
### --qr
|
||||
|
||||
Displays the QR code that corresponds to the current channel.
|
||||
Displays the URL and QR code that corresponds to the current primary channel.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --qr
|
||||
```
|
||||
|
||||
### --qr-all
|
||||
|
||||
Displays the URL and QR code that corresponds to all configured channels on the node.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --qr-all
|
||||
```
|
||||
|
||||
### --get [config_section]
|
||||
|
||||
Gets a preferences field.
|
||||
|
|
@ -131,6 +174,12 @@ meshtastic --get lora
|
|||
meshtastic --get lora.region
|
||||
```
|
||||
|
||||
To see all valid values, pass an invalid value, such as `0`:
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --get 0
|
||||
```
|
||||
|
||||
### --set [config_section].[option] [value]
|
||||
|
||||
Sets a preferences field.
|
||||
|
|
@ -143,15 +192,24 @@ meshtastic --set lora.region Unset
|
|||
|
||||
### --seturl SETURL
|
||||
|
||||
Set a channel URL.
|
||||
Set the channel URL, which contains LoRa configuration plus the configuration of channels. Replaces your current configuration and channels completely.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --seturl https://www.meshtastic.org/c/GAMiIE67C6zsNmlWQ-KE1tKt0fRKFciHka-DShI6G7ElvGOiKgZzaGFyZWQ=
|
||||
```
|
||||
|
||||
### --pos-fields POS_FIELDS
|
||||
|
||||
Configure position fields to send with positions; can pass multiple values. With 0 values, list current settings.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --pos-fields
|
||||
meshtastic --pos-fields ALTITUDE HEADING SPEED
|
||||
```
|
||||
|
||||
### --ch-index CH_INDEX
|
||||
|
||||
Set the specified channel index.
|
||||
Act on the specified channel index. Applies to options that configure channels (such as `--ch-set` and `--ch-del`) as well as options that send messages to the mesh (such as `--sendtext` and `--traceroute`).
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ch-index 1 --ch-disable
|
||||
|
|
@ -161,29 +219,35 @@ meshtastic --ch-index 1 --ch-disable
|
|||
|
||||
Add a secondary channel, you must specify a channel name.
|
||||
|
||||
Incompatible with `--ch-index`. If you pass `--ch-add`, any subsequent `--ch-set` and other commands that use a channel will use the index of the newly-added channel.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ch-add testing-channel
|
||||
```
|
||||
|
||||
### --ch-del
|
||||
|
||||
Delete the ch-index channel.
|
||||
Delete the channel specified by `--ch-index`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ch-index 1 --ch-del
|
||||
```
|
||||
|
||||
### --ch-enable
|
||||
### --ch-enable (deprecated)
|
||||
|
||||
Enable the specified channel.
|
||||
This option is deprecated. Using `--ch-add` is preferred in order to ensure there are no gaps in the channel list.
|
||||
|
||||
Enable the channel specified by `--ch-index`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ch-index 1 --ch-enable
|
||||
```
|
||||
|
||||
### --ch-disable
|
||||
### --ch-disable (deprecated)
|
||||
|
||||
Disable the specified channel.
|
||||
This option is deprecated. Using `--ch-del` is preferred in order to ensure there are no gaps in the channel list.
|
||||
|
||||
Disable the channel specified by `--ch-index`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ch-index 1 --ch-disable
|
||||
|
|
@ -191,7 +255,7 @@ meshtastic --ch-index 1 --ch-disable
|
|||
|
||||
### --ch-set CH_SET CH_SET
|
||||
|
||||
Set a channel parameter.
|
||||
Set a channel parameter on the channel specified by `--ch-index`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ch-set id 1234 --ch-index 0
|
||||
|
|
@ -255,7 +319,7 @@ meshtastic --ch-shortfast
|
|||
|
||||
### --set-owner SET_OWNER
|
||||
|
||||
Set device owner name.
|
||||
Set device owner name, sometimes called the long name.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --set-owner "MeshyJohn"
|
||||
|
|
@ -271,7 +335,9 @@ meshtastic --set-owner-short "MJ"
|
|||
|
||||
### --set-ham SET_HAM
|
||||
|
||||
Set licensed Ham ID and turn off encryption.
|
||||
Set licensed Ham ID (by setting the owner name) and turn off encryption on the primary channel.
|
||||
|
||||
To disable Ham mode, use `--set-owner` and `--set-owner-short` to reset the owner names, and use `--seturl` or `--ch-set` commands to configure channels with the name and encryption you wish them to have. Or, use `--factory-reset` to reset to default settings.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --set-ham KI1345
|
||||
|
|
@ -279,7 +345,9 @@ meshtastic --set-ham KI1345
|
|||
|
||||
### --dest DEST
|
||||
|
||||
The destination node id for any sent commands. Used for [Remote Node Administration](/docs/configuration/remote-admin)
|
||||
The destination node id for any sent commands, if not passed to a command another way. Used for [Remote Node Administration](/docs/configuration/remote-admin).
|
||||
|
||||
On many shells, exclamation points trigger special behavior unless enclosed in single quotes.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --dest '!28979058' --set-owner "MeshyJohn"
|
||||
|
|
@ -287,23 +355,16 @@ meshtastic --dest '!28979058' --set-owner "MeshyJohn"
|
|||
|
||||
### --sendtext SENDTEXT
|
||||
|
||||
Send a text message. Can specify a channel index ('--ch-index') or a destination ('--dest').
|
||||
Send a text message. Can specify a channel index (`--ch-index`) and/or a destination (`--dest`).
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --sendtext "Hello Mesh!"
|
||||
```
|
||||
|
||||
### --sendping
|
||||
|
||||
Send a ping message (which requests a reply).
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --sendping
|
||||
meshtastic --sendtext 'Hello Mesh!'
|
||||
meshtastic --ch-index 1 --sendtext 'Hello secondary channel!'
|
||||
```
|
||||
|
||||
### --traceroute TRACEROUTE
|
||||
|
||||
Traceroute from connected node to a destination. You need pass the destination ID as an argument. Only nodes that have the encryption key can be traced.
|
||||
Traceroute from connected node to a destination. You need pass the destination ID as an argument, and may pass `--ch-index` to specify a channel. The node you are tracing must have the same channel configured, and only nodes that share the channel will identify themselves within the response. With recent enough firmware, other nodes may be included as `!ffffffff` but not with their actual ID.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --traceroute '!ba4bf9d0'
|
||||
|
|
@ -311,19 +372,27 @@ meshtastic --traceroute '!ba4bf9d0'
|
|||
|
||||
### --request-telemetry
|
||||
|
||||
Request telemetry from a node. You need to pass the destination ID as an argument with '--dest'. For repeaters, the nodeNum is required.
|
||||
Request telemetry from a node. You need to pass the destination ID as an argument with `--dest`. For repeaters, using the node's decimal ID may be more effective, but a hexadecimal ID should work as well.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --request-telemetry --dest '!ba4bf9d0'
|
||||
meshtastic --request-telemetry --dest 1828779180
|
||||
```
|
||||
|
||||
### --ack
|
||||
### --request-position
|
||||
|
||||
Used in combination with --sendtext to wait for an acknowledgment.
|
||||
Request position from a node. You need to pass the destination ID as an argument with `--dest`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --sendtext "Hello Mesh!" --ack
|
||||
meshtastic --request-position --dest '!ba4bf9d0' --ch-index 1
|
||||
```
|
||||
|
||||
### --ack
|
||||
|
||||
Used in combination with `--sendtext` and other commands to wait for an acknowledgment. Not all commands will be able to return an acknowledgment. Best used for commands that specify a single destination node.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --sendtext 'Hello Mesh!' --dest '!28979058' --ack
|
||||
```
|
||||
|
||||
### --reboot
|
||||
|
|
@ -358,14 +427,128 @@ Tell the node to clear its list of nodes.
|
|||
meshtastic --reset-nodedb
|
||||
```
|
||||
|
||||
### --remove-node NODE
|
||||
|
||||
Tell the node to remove the specified node from the NodeDB.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --remove-node '!48759737'
|
||||
```
|
||||
|
||||
### --reply
|
||||
|
||||
Reply to received messages.
|
||||
Listen for messages. When one is received, send a message to the primary channel repeating the message along with some information.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --reply
|
||||
```
|
||||
|
||||
### --no-time
|
||||
|
||||
Suppress sending the current time to the mesh on startup. May improve reliability and startup time.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --port /dev/ttyUSB0 --no-time
|
||||
```
|
||||
|
||||
### --no-nodes
|
||||
|
||||
Instruct the node to not send nodeinfo from the NodeDB on startup. Requires firmware of sufficient version. Commands that use node information may behave unpredictably, since that information will not be populated, but this can improve efficiency for commands that don't.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --no-nodes --no-time --sendtext "Firing off a quick message"
|
||||
```
|
||||
|
||||
### --wait-to-disconnect WAIT_TO_DISCONNECT
|
||||
|
||||
After performing whatever actions are specified by other options, wait before disconnecting from the device. Some devices will reboot when the serial connection disconnects, so adding a wait time may improve reliability. Defaults to 5 seconds if not provided.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --set lora.channel_num 20 --wait-to-disconnect 10
|
||||
```
|
||||
|
||||
### --setalt SETALT
|
||||
|
||||
Set device altitude (allows use without GPS), and enables fixed position mode.
|
||||
|
||||
Can only be used on locally-connected nodes and not along with `--dest`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --setalt 120
|
||||
```
|
||||
|
||||
### --setlat SETLAT
|
||||
|
||||
Set device latitude (allows use without GPS), and enables fixed position mode.
|
||||
|
||||
Can only be used on locally-connected nodes and not along with `--dest`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --setlat 25.2
|
||||
```
|
||||
|
||||
### --setlon SETLON
|
||||
|
||||
Set device longitude (allows use without GPS), and enables fixed position mode.
|
||||
|
||||
Can only be used on locally-connected nodes and not along with `--dest`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --setlon -16.8
|
||||
```
|
||||
|
||||
### --remove-position
|
||||
|
||||
Clear the node's currently set fixed position and disable fixed position mode.
|
||||
|
||||
Can only be used on locally-connected nodes and not along with `--dest`.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --remove-position
|
||||
```
|
||||
|
||||
### --debug
|
||||
|
||||
Show API library debug log messages.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --debug --info
|
||||
```
|
||||
|
||||
### --listen
|
||||
|
||||
Stay open and listen to the stream of protocol buffer messages. This option enables `--debug` even if it is not provided alongside this argument.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --listen
|
||||
```
|
||||
|
||||
### --test
|
||||
|
||||
Run stress test against all connected Meshtastic devices.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --test
|
||||
```
|
||||
|
||||
### --ble-scan
|
||||
|
||||
Scan for available Meshtastic devices using BLE. This command lists discoverable devices, providing a convenient method to identify devices for connection via BLE.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ble-scan
|
||||
```
|
||||
|
||||
### --noproto
|
||||
|
||||
Don't start the API, just function as a dumb serial terminal. Probably not very helpful from the command line. Used more for testing/internal needs.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --noproto
|
||||
```
|
||||
|
||||
## Remote Hardware arguments
|
||||
|
||||
### --gpio-wrb GPIO_WRB GPIO_WRB
|
||||
|
||||
Set a particular GPIO # to 1 or 0.
|
||||
|
|
@ -390,90 +573,14 @@ Start watching a GPIO mask for changes.
|
|||
meshtastic --port /dev/ttyUSB0 --gpio-watch 0x10 --dest '!28979058'
|
||||
```
|
||||
|
||||
### --no-time
|
||||
## Tunnel arguments
|
||||
|
||||
Suppress sending the current time to the mesh.
|
||||
### --tunnel
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --port /dev/ttyUSB0 --no-time
|
||||
```
|
||||
Linux only, very experimental. Low bandwidth and low reliability.
|
||||
|
||||
### --setalt SETALT
|
||||
Create a TUN tunnel device for forwarding IP packets over the mesh.
|
||||
|
||||
Set device altitude (allows use without GPS).
|
||||
## --subnet TUNNEL_NET
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --setalt 120
|
||||
```
|
||||
|
||||
### --setlat SETLAT
|
||||
|
||||
Set device latitude (allows use without GPS).
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --setlat 25.2
|
||||
```
|
||||
|
||||
### --setlon SETLON
|
||||
|
||||
Set device longitude (allows use without GPS).
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --setlon -16.8
|
||||
```
|
||||
|
||||
### --debug
|
||||
|
||||
Show API library debug log messages.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --debug --info
|
||||
```
|
||||
|
||||
### --test
|
||||
|
||||
Run stress test against all connected Meshtastic devices.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --test
|
||||
```
|
||||
|
||||
### --ble BLE
|
||||
|
||||
Connect to a Meshtastic device using its BLE address or name. This option allows for wireless communication with the device, similar to how the `--host` option is used for TCP connections.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ble "device_name_or_address" --info
|
||||
```
|
||||
|
||||
### --ble-scan
|
||||
|
||||
Scan for available Meshtastic devices using BLE. This command lists discoverable devices, providing a convenient method to identify devices for connection via BLE.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --ble-scan
|
||||
```
|
||||
|
||||
### --noproto
|
||||
|
||||
Don't start the API, just function as a dumb serial terminal. Probably not very helpful from the command line. Used more for testing/internal needs.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --noproto
|
||||
```
|
||||
|
||||
### --version
|
||||
|
||||
Show program's version number and exit.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --version
|
||||
```
|
||||
|
||||
### --support
|
||||
|
||||
Print out info that would be helpful supporting any issues.
|
||||
|
||||
```shell title="Usage"
|
||||
meshtastic --support
|
||||
```
|
||||
Set the subnet for the local end of the tunnel established using `--tunnel`.
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
Subproject commit eeddd10c108f1516e6e0c878fbaa8ed40a4d279d
|
||||
Subproject commit 77fafb2b027787f1206fe3774a2f456f1ffc721d
|
||||
BIN
static/img/hardware/heltec/capsule-connector.webp
Normal file
BIN
static/img/hardware/heltec/capsule-connector.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 106 KiB |
BIN
static/img/hardware/heltec/capsule-sensor-extensibility.webp
Normal file
BIN
static/img/hardware/heltec/capsule-sensor-extensibility.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 135 KiB |
BIN
static/img/hardware/heltec/capsule-sensor-v3-button.webp
Normal file
BIN
static/img/hardware/heltec/capsule-sensor-v3-button.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 110 KiB |
Loading…
Reference in a new issue