From 4b6eb70b02d60c2462109611c9c91ac02ce6bf95 Mon Sep 17 00:00:00 2001
From: Jouni <j_github@tuu.fi>
Date: Mon, 16 Mar 2026 16:26:55 +0200
Subject: [PATCH] Airtime (af) documentation update

---
 docs/cli_commands.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/cli_commands.md b/docs/cli_commands.md
index e5cca0ea..8ae95443 100644
--- a/docs/cli_commands.md
+++ b/docs/cli_commands.md
@@ -483,7 +483,12 @@ This document provides an overview of CLI commands that can be sent to MeshCore
 - `set af <value>`
 
 **Parameters:**
-- `value`: Airtime factor (0-9)
+- `value`: Airtime factor (0-9). After each transmission, the repeater enforces a silent period of approximately the on-air transmission time multiplied by the value. This results in a long-term duty cycle of roughly 1 divided by (1 plus the value). For example:
+  - `af = 1` → ~50% duty
+  - `af = 2` → ~33% duty
+  - `af = 3` → ~25% duty
+  - `af = 9` → ~10% duty  
+  Yyou are responsible for choosing a value that is appropriate for your jurisdiction and channel plan (for example EU 868 Mhz 10% duty cycle regulation).
 
 **Default:** `1.0`