Added documentation and updated README

docs/pl_rx_subsystem.md

@@ -0,0 +1,34 @@
+# 📡 PL Rx Subsystem (Channelizer)
+
+## Overview
+
+Implements PFB channelizer and FFT processing.
+
+---
+
+## Architecture
+
+ADC → PFB → FFT → Capture → FIFO → AXI → DMA
+
+---
+
+## Processing
+
+- 4096 MSPS input
+- Decimation 8
+- FFT 512 bins
+
+---
+
+## Output
+
+- AXI4-Stream
+- uint64 format
+- TLAST per frame
+
+---
+
+## 🔗 Related Components
+
+- [PL Tx Subsystem](pl_tx_subsystem.md)
+- [PS Subsystem](ps_subsystem.md)

docs/pl_tx_subsystem.md

@@ -0,0 +1,49 @@
+# 📡 PL Tx Subsystem (Pulse Generator)
+
+## Overview
+
+The Tx subsystem implements a pulse-based LFM chirp generator using a DDS/NCO architecture.
+
+---
+
+## Architecture
+
+TxPulseStart → pulse_gen_ctrl → tx_active → NCO → Output
+
+---
+
+## Chirp Generation
+
+Δφ[n] = Δφ[n−1] + step  
+φ[n]  = φ[n−1] + Δφ[n]
+
+---
+
+## Parameterization
+
+- Fc (center frequency)
+- B (bandwidth)
+
+Derived:
+f_start = Fc − B/2  
+step    = B / (N − 1)
+
+---
+
+## Pulse Timing
+
+|<------ PRI ------>|
+|<-- pulse -->| idle |
+
+---
+
+## Trigger
+
+Controlled via TxPulseStart (from PS subsystem)
+
+---
+
+## 🔗 Related Components
+
+- [PS Subsystem](ps_subsystem.md)
+- [PL Rx Subsystem](pl_rx_subsystem.md)

docs/ps_subsystem.md

@@ -0,0 +1,32 @@
+# 🧠 PS Subsystem
+
+## Overview
+
+Handles control and processing.
+
+---
+
+## Control
+
+- Writes parameters
+- Triggers Tx (TxPulseStart)
+
+---
+
+## Processing
+
+DMA → unpack → complex → RMS/peak
+
+---
+
+## Execution
+
+- Event-driven
+- Frame drops possible
+
+---
+
+## 🔗 Related Components
+
+- [PL Tx Subsystem](pl_tx_subsystem.md)
+- [PL Rx Subsystem](pl_rx_subsystem.md)