From 542285b5d0d591d8e51b2203c8dc1602f9960338 Mon Sep 17 00:00:00 2001
From: Clive Blackledge <clive@ansible.org>
Date: Mon, 19 Jan 2026 15:14:50 -0800
Subject: [PATCH] More comments

---
 meshtastic/module_config.proto | 47 +++++++++++++++++++++++++++-------
 1 file changed, 38 insertions(+), 9 deletions(-)

diff --git a/meshtastic/module_config.proto b/meshtastic/module_config.proto
index feb8481..440ef9d 100644
--- a/meshtastic/module_config.proto
+++ b/meshtastic/module_config.proto
@@ -296,53 +296,82 @@ message ModuleConfig {
   }
 
   /*
-   * Config for the Traffic Management module
+   * Config for the Traffic Management module.
+   * Provides packet inspection and traffic shaping for mesh network optimization.
    */
   message TrafficManagementConfig {
     /*
-     * Master enable for traffic management
+     * Master enable for traffic management module
      */
     bool enabled = 1;
 
     /*
-     * Dry-run mode: log actions but don't drop/modify packets
+     * Dry-run mode: log actions but don't actually drop or modify packets
      */
     bool dry_run = 2;
 
     /*
-     * Position deduplication settings
+     * Enable position deduplication to drop redundant position broadcasts
      */
     bool position_dedup_enabled = 3;
+
+    /*
+     * Number of bits of precision for position deduplication (0-32)
+     */
     uint32 position_precision_bits = 4;
+
+    /*
+     * Minimum interval in seconds between position updates from the same node
+     */
     uint32 position_min_interval_secs = 5;
 
     /*
-     * NodeInfo direct response settings
+     * Enable direct response to NodeInfo requests from local cache
      */
     bool nodeinfo_direct_response = 6;
+
+    /*
+     * Minimum hop distance from requestor before responding to NodeInfo requests
+     */
     uint32 nodeinfo_direct_response_min_hops = 7;
 
     /*
-     * Rate limiting settings
+     * Enable per-node rate limiting to throttle chatty nodes
      */
     bool rate_limit_enabled = 8;
+
+    /*
+     * Time window in seconds for rate limiting calculations
+     */
     uint32 rate_limit_window_secs = 9;
+
+    /*
+     * Maximum packets allowed per node within the rate limit window
+     */
     uint32 rate_limit_max_packets = 10;
 
     /*
-     * Unknown/undecryptable packet handling
+     * Enable dropping of unknown/undecryptable packets from repeat offenders
      */
     bool drop_unknown_enabled = 11;
+
+    /*
+     * Number of unknown packets before dropping from a node
+     */
     uint32 unknown_packet_threshold = 12;
 
     /*
-     * Hop exhaustion for local telemetry/position
+     * Set hop_limit to 0 for locally-originated telemetry broadcasts
      */
     bool local_only_telemetry = 13;
+
+    /*
+     * Set hop_limit to 0 for locally-originated position broadcasts
+     */
     bool local_only_position = 14;
 
     /*
-     * Router hop preservation
+     * Preserve hop_limit for router-to-router traffic
      */
     bool router_preserve_hops = 15;
   }