From 73b7735ef28c3d20275105d6df22872575f1da80 Mon Sep 17 00:00:00 2001 From: GUVWAF Date: Tue, 30 Jan 2024 19:56:59 +0100 Subject: [PATCH] Add "Ignore MQTT" LoRa config and "ViaMQTT" header flag --- docs/about/overview/mesh-alg.mdx | 3 ++- docs/configuration/radio/lora.mdx | 7 ++++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/about/overview/mesh-alg.mdx b/docs/about/overview/mesh-alg.mdx index 2b9f9c2d..686c35f2 100644 --- a/docs/about/overview/mesh-alg.mdx +++ b/docs/about/overview/mesh-alg.mdx @@ -45,7 +45,8 @@ This layer is conventional non-reliable LoRa packet transmission. A packet gener | :----: | :-------: | :----------------------------- | | 0 | 3 | HopLimit (see note in Layer 3) | | 3 | 1 | WantAck | -| 4 .. 7 | 4 | Currently unused | +| 4 | 1 | ViaMQTT (packet came via MQTT) | +| 5 .. 7 | 3 | Currently unused | #### Usage Details diff --git a/docs/configuration/radio/lora.mdx b/docs/configuration/radio/lora.mdx index a204b9ca..071fb7f0 100644 --- a/docs/configuration/radio/lora.mdx +++ b/docs/configuration/radio/lora.mdx @@ -8,7 +8,7 @@ import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; import LoRaRegions from "../../blocks/_lora-regions.mdx"; -The LoRa config options are: Region, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Channel Number, Ignore Incoming Array, Override Duty Cycle Limit, SX126x RX Boosted Gain, and Override Frequency. LoRa config uses an admin message sending a `Config.LoRa` protobuf. +The LoRa config options are: Region, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Channel Number, Ignore Incoming Array, Ignore MQTT, Override Duty Cycle Limit, SX126x RX Boosted Gain, and Override Frequency. LoRa config uses an admin message sending a `Config.LoRa` protobuf. :::note In order to communicate fully, devices within a mesh must have identical settings for Region and Modem Preset, or identical custom Modem settings. @@ -112,6 +112,10 @@ LoRa Channel Configuration should not to be confused with messaging [Channel Con For testing it is useful sometimes to force a node to never listen to particular other nodes (simulating radio out of range). All nodenums listed in the ignore_incoming array will have packets they send dropped on receive (by router.cpp) +### Ignore MQTT + +Setting this to option to 'true' means the device will ignore any messages it receives via LoRa that came via MQTT somewhere along the path towards the device. Note this only works when your device and the MQTT node are running at least firmware version 2.2.19. + ### Override Duty Cycle Limit Setting this option to 'true' means the device will ignore the hourly duty cycle limit in Europe. This means that you might violate regulations if the device transmits too much. By default, this option is set to 'false,' which means the device will stop sending data when it reaches the hourly limit and will start again when it is allowed to do so. @@ -175,6 +179,7 @@ LoRa config commands are available in the python CLI. Example commands are below | lora.tx_power | `0` to `30` | `0` | | lora.tx_enabled | `false`, `true` | `true` | | lora.channel_num | `0`, `1` to `NUM_CHANNELS` | `0` | +| lora.ignore_mqtt | `false`, `true` | `false` | | lora.override_duty_cycle | `false`, `true` | `false` | | lora.sx126x_rx_boosted_gain | `false`, `true` | `false` | | lora.override_frequency | Any supported frequency the LoRA radio is capable of. Please respect local rules and regulations | `0` |