link budget
link_budgetCompute a full RF link budget from transmitter power, frequency, distance, and antenna gains. Calculates EIRP, free-space path loss (ITU-R P.525), received power at the receiver, and link margin relative to an optional receiver sensitivity threshold. Use this to determine whether a wireless link closes with adequate margin. Accepts output from noise_figure_cascade and feeds into snr_margin for full receive-chain analysis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tx_dbm | Yes | Transmitter output power in dBm | |
| dist_km | Yes | Link distance in kilometres | |
| freq_mhz | Yes | Carrier frequency in megahertz (MHz) | |
| rx_gain_dbi | No | Receive antenna gain in dBi (default 2.15 for a half-wave dipole) | |
| tx_gain_dbi | No | Transmit antenna gain in dBi (default 2.15 for a half-wave dipole) | |
| rx_sensitivity_dbm | No | Receiver sensitivity in dBm; when provided, link margin is calculated |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fspl_db | Yes | Free-space path loss in dB | |
| eirp_dbm | Yes | Effective isotropic radiated power in dBm | |
| margin_db | Yes | Link margin in dB (null when sensitivity is not provided) | |
| rx_power_dbm | Yes | Received signal power in dBm | |
| wavelength_m | Yes | RF wavelength in metres |