Ensure meshadv tx power is within legal limits and add note

Author: LeoVerto

docs/docs/examples.md

@@ -153,7 +153,7 @@ pyMC_Core supports both direct SX1262 radio control and KISS TNC devices:
 - **Hardware**: FrequencyLabs meshadv Hat
 - **Platform**: Raspberry Pi (or compatible single-board computer)
 - **Frequency**: 868MHz (EU) or 915MHz (US)
-- **TX Power**: Up to 22dBm
+- **TX Power**: Up to 27dBm (Note: Actual tx power is [10dB higher than configured value](https://github.com/chrismyers2000/MeshAdv-Pi-Hat/issues/18))
 - **SPI Bus**: SPI0
 - **GPIO Pins**: CS=21, Reset=18, Busy=20, IRQ=16
 
@@ -342,7 +342,7 @@ All examples use the SX1262 LoRa radio with the following default settings:
 #### meshadv (Frequency Labs)
 - **Radio Type**: SX1262 direct hardware control
 - **Frequency**: 869.525MHz (European standard)
-- **TX Power**: 22dBm
+- **TX Power**: 22dBm (Note: Actual tx power is [10dB higher than configured value](https://github.com/chrismyers2000/MeshAdv-Pi-Hat/issues/18))
 - **Spreading Factor**: 11
 - **Bandwidth**: 250kHz
 - **Coding Rate**: 4/5

examples/common.py

@@ -70,7 +70,7 @@
         "rxen_pin": 12,
         "use_dio3_tcxo": True,
         "frequency": int(910.525 * 1000000),  # US: 910.525 MHz
-        "tx_power": 22,
+        "tx_power": 12,  # real meshadv power is 10dB higher, see https://github.com/chrismyers2000/MeshAdv-Pi-Hat/issues/18
         "spreading_factor": 7,
         "bandwidth": int(62.5 * 1000),
         "coding_rate": 5,
@@ -94,9 +94,11 @@
     },
 }
 
+
 def get_supported_radios():
     return list(RADIOS.keys()) + ["kiss-tnc"]
 
+
 def create_radio(radio_type: str = "waveshare", serial_port: str = "/dev/ttyUSB0") -> LoRaRadio:
     """Create a radio instance with configuration for specified hardware.
 
@@ -143,9 +145,7 @@ def create_radio(radio_type: str = "waveshare", serial_port: str = "/dev/ttyUSB0
         logger.debug("Imported SX1262Radio successfully")
 
         if radio_type not in RADIOS:
-            raise ValueError(
-                f"Unknown radio type: {radio_type}. Use f{get_supported_radios()}"
-            )
+            raise ValueError(f"Unknown radio type: {radio_type}. Use f{get_supported_radios()}")
 
         radio_kwargs = configs[radio_type]
         logger.debug(f"Radio configuration for {radio_type}: {radio_kwargs}")

examples/discover_nodes.py

@@ -177,9 +177,7 @@ def main():
     if args.radio_type == "kiss-tnc":
         print(f"Serial port: {args.serial_port}")
 
-    asyncio.run(
-        discover_nodes(args.radio_type, args.serial_port, args.timeout, args.filter)
-    )
+    asyncio.run(discover_nodes(args.radio_type, args.serial_port, args.timeout, args.filter))
 
 
 if __name__ == "__main__":