From 992cc083e6b414e1452f2ebcca9b56c6a1ab40b7 Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Fri, 6 Mar 2026 15:22:00 -0800 Subject: [PATCH 1/8] Update cli_commands.md to include path.hash.mode and loop.detect Adding the new repeater cli commands introduced in 1.14 Ref: https://buymeacoffee.com/ripplebiz/path-diagnostics-improvements --- docs/cli_commands.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index 1d3430db..8c48ced7 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -383,6 +383,43 @@ This document provides an overview of CLI commands that can be sent to MeshCore --- +### View or change this node's avert path hash size +**Usage:** +- `get path.hash.mode` +- `set path.hash.mode ` + +**Parameters:** +- `value`: Path hash size (0-2) + - `0`: 1 Byte hash size (256 count)[64 max flood] + - `1`: 2 Byte hash size (65,536 count)[32 max flood] + - `2`: 3 Byte hash size (16,777,216 count)[21 max flood] + +**Default:** `0` + +**Note:** the 'mode' is the low-level encoding (0..3) where 0 -> 1-byte (legacy), 1 -> 2-byte, 2 -> 3-byte for the ID/hash of the repeaters adverts. This feature was added in firmware 1.14 + +--- + +### View or change this node's loop detection +**Usage:** +- `get loop.detect` +- `set loop.detect ` + +**Parameters:** +- `state`: + - `off`: no loop detection is performed + - `minimal`: packets are dropped if repeaters ID/hash shows more times than 4(1-byte), 2(2-byte), 1(3-byte) + - `moderate`: packets are dropped if repeaters ID/hash shows more times than 2(1-byte), 1(2-byte), 1(3-byte) + - `strict`: packets are dropped if repeaters ID/hash shows more times than 1(1-byte), 1(2-byte), 1(3-byte) + +**Default:** `off` + +**Note:** When it is enabled, repeaters will now reject flood packets which look like they are in a loop. This has been happening recently in some meshes when there is just a single 'bad' repeater firmware out there (prob some forked or custom firmware). If the payload is messed with, then forwarded, the same packet ends up causing a packet storm, repeated up to the max 64 hops. This feature was added in firmware 1.14 + +**Example:** If preference is `loop.detect minimal`, and a 1-byte path size packet is received, the repeater will see if its own ID/hash is already in the path. If it's already encoded 4 times, it will reject the packet. If the packet uses 2-byte path size, and repeater's own ID/hash is already encoded 2 times, it rejects. If the packet uses 3-byte path size, and the repeater's own ID/hash is already encoded 1 time, it rejects. + +--- + #### View or change the retransmit delay factor for flood traffic **Usage:** - `get txdelay` From d2a6fda8d587a9bb7f8af09d74d1bc9bce5e3e64 Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Fri, 6 Mar 2026 16:30:45 -0800 Subject: [PATCH 2/8] Update cli_commands.md --- docs/cli_commands.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index 8c48ced7..ff5f2366 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -398,6 +398,8 @@ This document provides an overview of CLI commands that can be sent to MeshCore **Note:** the 'mode' is the low-level encoding (0..3) where 0 -> 1-byte (legacy), 1 -> 2-byte, 2 -> 3-byte for the ID/hash of the repeaters adverts. This feature was added in firmware 1.14 +**Temporary Note:** adverts with hash sizes of 2 or 3 bytes may have limited flood propogation in your network while this feature is new. Consider your install base of firmware >=1.14 before implementing. + --- ### View or change this node's loop detection From 721c21f1e52867cc4ff39b70d1b523c7fac01128 Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Sat, 7 Mar 2026 10:40:41 -0800 Subject: [PATCH 3/8] Apply suggestion from @weebl2000 Co-authored-by: Wessel --- docs/cli_commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index ff5f2366..e7cb85e3 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -383,7 +383,7 @@ This document provides an overview of CLI commands that can be sent to MeshCore --- -### View or change this node's avert path hash size +#### View or change this node's advert path hash size **Usage:** - `get path.hash.mode` - `set path.hash.mode ` From 0228d596e8aef95d32596b407f14874ac08df6fb Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Sat, 7 Mar 2026 10:42:13 -0800 Subject: [PATCH 4/8] Apply suggestion from @weebl2000 Co-authored-by: Wessel --- docs/cli_commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index e7cb85e3..d4c97e84 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -402,7 +402,7 @@ This document provides an overview of CLI commands that can be sent to MeshCore --- -### View or change this node's loop detection +#### View or change this node's loop detection **Usage:** - `get loop.detect` - `set loop.detect ` From 4aaa557dafe18d757c5ef9a7acb60b48b6be09be Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Sat, 7 Mar 2026 10:43:23 -0800 Subject: [PATCH 5/8] Apply suggestion from @weebl2000 Co-authored-by: Wessel --- docs/cli_commands.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index d4c97e84..9f84808c 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -410,9 +410,9 @@ This document provides an overview of CLI commands that can be sent to MeshCore **Parameters:** - `state`: - `off`: no loop detection is performed - - `minimal`: packets are dropped if repeaters ID/hash shows more times than 4(1-byte), 2(2-byte), 1(3-byte) - - `moderate`: packets are dropped if repeaters ID/hash shows more times than 2(1-byte), 1(2-byte), 1(3-byte) - - `strict`: packets are dropped if repeaters ID/hash shows more times than 1(1-byte), 1(2-byte), 1(3-byte) + - `minimal`: packets are dropped if repeater's ID/hash appears 4 or more times (1-byte), 2 or more (2-byte), 1 or more (3-byte) + - `moderate`: packets are dropped if repeater's ID/hash appears 2 or more times (1-byte), 1 or more (2-byte), 1 or more (3-byte) + - `strict`: packets are dropped if repeater's ID/hash appears 1 or more times (1-byte), 1 or more (2-byte), 1 or more (3-byte) **Default:** `off` From fe32f16aa40a00dfed9d7315261680d84b9bf174 Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Sat, 7 Mar 2026 10:55:40 -0800 Subject: [PATCH 6/8] Update cli_commands.md R399 updates --- docs/cli_commands.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index 9f84808c..1bcb33cc 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -390,13 +390,14 @@ This document provides an overview of CLI commands that can be sent to MeshCore **Parameters:** - `value`: Path hash size (0-2) - - `0`: 1 Byte hash size (256 count)[64 max flood] - - `1`: 2 Byte hash size (65,536 count)[32 max flood] - - `2`: 3 Byte hash size (16,777,216 count)[21 max flood] + - `0`: 1 Byte hash size (256 unique ids)[64 max flood] + - `1`: 2 Byte hash size (65,536 unique ids)[32 max flood] + - `2`: 3 Byte hash size (16,777,216 unique ids)[21 max flood] + - `3`: DO NOT USE (Reserved) **Default:** `0` -**Note:** the 'mode' is the low-level encoding (0..3) where 0 -> 1-byte (legacy), 1 -> 2-byte, 2 -> 3-byte for the ID/hash of the repeaters adverts. This feature was added in firmware 1.14 +**Note:** the 'path.hash.mode' sets the low-level ID/hash encoding size used the for when the repeater adverts. This setting has no impact on what packet ID/hash size this repeater forwards, all sizes should be forwarded on firmware >= 1.14. This feature was added in firmware 1.14 **Temporary Note:** adverts with hash sizes of 2 or 3 bytes may have limited flood propogation in your network while this feature is new. Consider your install base of firmware >=1.14 before implementing. From bb454861c7b893c76813c3e29f0f19a871f67c71 Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Sat, 7 Mar 2026 11:01:20 -0800 Subject: [PATCH 7/8] Update cli_commands.md R402 --- docs/cli_commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index 1bcb33cc..78df127e 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -399,7 +399,7 @@ This document provides an overview of CLI commands that can be sent to MeshCore **Note:** the 'path.hash.mode' sets the low-level ID/hash encoding size used the for when the repeater adverts. This setting has no impact on what packet ID/hash size this repeater forwards, all sizes should be forwarded on firmware >= 1.14. This feature was added in firmware 1.14 -**Temporary Note:** adverts with hash sizes of 2 or 3 bytes may have limited flood propogation in your network while this feature is new. Consider your install base of firmware >=1.14 before implementing. +**Temporary Note:** adverts with ID/hash sizes of 2 or 3 bytes may have limited flood propogation in your network while this feature is new as v1.13.0 firmware and older will drop packets with multibyte path ID/hashes as only 1-byte hashes are suppored. Consider your install base of firmware >=1.14 has reached a criticality for effective network flooding before implementing higher ID/hash sizes. --- From 36db50a0d25af181de03fe2239cd9f8053c89930 Mon Sep 17 00:00:00 2001 From: AI7NC <77077873+AI7NC@users.noreply.github.com> Date: Sat, 7 Mar 2026 11:14:03 -0800 Subject: [PATCH 8/8] Update cli_commands.md R400 grammer Small grammar fix --- docs/cli_commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cli_commands.md b/docs/cli_commands.md index 78df127e..98238f0d 100644 --- a/docs/cli_commands.md +++ b/docs/cli_commands.md @@ -397,7 +397,7 @@ This document provides an overview of CLI commands that can be sent to MeshCore **Default:** `0` -**Note:** the 'path.hash.mode' sets the low-level ID/hash encoding size used the for when the repeater adverts. This setting has no impact on what packet ID/hash size this repeater forwards, all sizes should be forwarded on firmware >= 1.14. This feature was added in firmware 1.14 +**Note:** the 'path.hash.mode' sets the low-level ID/hash encoding size used when the repeater adverts. This setting has no impact on what packet ID/hash size this repeater forwards, all sizes should be forwarded on firmware >= 1.14. This feature was added in firmware 1.14 **Temporary Note:** adverts with ID/hash sizes of 2 or 3 bytes may have limited flood propogation in your network while this feature is new as v1.13.0 firmware and older will drop packets with multibyte path ID/hashes as only 1-byte hashes are suppored. Consider your install base of firmware >=1.14 has reached a criticality for effective network flooding before implementing higher ID/hash sizes.