Publish expanded 23-language matrix across all 20 inventions (460 codebases total)

evidence_proofs/RAKMINER_HARDWARE_INTEGRATION_GUIDE.md

@@ -49,3 +49,49 @@ Dynamic validation sweeps must conform to the working RF chain limitations of th
 * **Spreading Factor (SF):** **SF7** or **SF9** (verified limits).
 * **Signal Bandwidth:** **125 kHz**.
 * **RF Power Output:** **14 dBm (25 mW)** (provides optimal local link reliability while remaining fully FCC compliant).
+
+---
+
+## 4. Chip Diagnostics & Verification
+Before running high-level coordinate scripts, verify that the concentrator is responsive and has loaded correctly:
+
+```bash
+cd ~/sx1302_hal/util_chip_id
+./chip_id -d /dev/spidev0.0 -r 1250 -k 0
+```
+
+### Expected Diagnostic Output:
+Upon success, the tool should output:
+```text
+Note: chip version is 0x10 (v1.0)
+INFO: concentrator EUI: 0x0016C001...
+Closing SPI communication interface
+WARNING: optional STTS751 temperature sensor close failed; ignored (err=-1)
+```
+If `ERROR: failed to stop the gateway` appears, re-verify the temperature sensor patch or rebuild the HAL directory.
+
+---
+
+## 5. Low-Level RF Validation Benchmarks
+Use the standard HAL diagnostic tools to check link state before starting dynamic coordinate scripts.
+
+### receiver Mode (Miner B / RX Node):
+Start the receiver sweep on 903.9 MHz:
+```bash
+cd ~/sx1302_hal/libloragw
+./test_loragw_hal_rx -d /dev/spidev0.0 -r 1250 -a 903.9 -b 903.9 -k 0 -m 1 -j -z 255 -n 1
+```
+
+### transmitter Mode (Miner A / TX Node):
+Transmit a 10-packet burst from the active TX chain:
+```bash
+cd ~/sx1302_hal/libloragw
+./test_loragw_hal_tx -d /dev/spidev0.0 -k 0 -c 0 -r 1250 -f 903.9 -m LORA -s 7 -b 125 -l 8 -n 10 -z 39 -p 14 -j --pa 1 --pwid 12
+```
+
+---
+
+## 6. Important Safety & Operational Constraints
+* **Antenna Load Warning:** **Never** trigger the transmit script (`test_loragw_hal_tx` or the Python transmitter) unless a 915 MHz antenna or a 50-ohm dummy load is firmly attached to the active RF SMA port. Operating the transceivers without an antenna will cause signal reflection and permanently damage the power amplifier.
+* **Avoid TX Chain 1:** Do not attempts to select chain 1 (`-c 1`) for transmission. Doing so will disable the radio link.
+* **Reset GPIO Timing:** Ensure that your startup scripts do not continuously toggle GPIO 17, as this will prevent the SPI bus from stabilizing.