Reimplement (PUSCH) power control

Introduce new data structures to track the average SNR and RSSI, and
that allow to dynamically modify the target SNR (per UE) as well as
continuously get TPC updates based on the average SNR. The target SNR is
per power control loop (which a future commit will extend to use for
PUCCH).

Concretely, it maintains an average of measured SNR and RSSI.  It also
updates "tpc_in_flight", which tracks TPC changes that don't show up in
the average yet. For instance, imagine that the target SNR of 15 changes
to 20. Three successive TPC commands need to be sent (+3, +1, +1), but
it will take time to show up in the average SNR. To account for this,
tpc_in_flight is updated by the TPCs sent, and an average will make it
go down back to zero at the same pace as the average SNR approaches the
target SNR.  The sum of average SNR and tpc_in_flight sums up to the
actual, current SNR, which approximates the target SNR.

The SNR is kept within -1<=targetSNR<=+2dB to avoid too many TPC
changes.

The current average SNR (sum of average SNR and tpc_in_flight) is used
to continuously get TPC updates, taking into account recent TPCs sent,
the difference to target SNR, and RSSI.

If there is DTX, tpc_in_flight is modified to artificially introduce TPC
commands which increase the currently used SNR of the UE. This is
temporary, as tpc_in_flight eventually will go back to zero. If the DTX
was due to sudden SNR drop (e.g., higher path loss), this will allow to
quickly adapt the UE's SNR to new conditions.

The periodical logs are extended to not only show the current SNR, but
also the difference from the target for better analysis.

Co-authored-by: Maxime Elkael <m.elkael@northeastern.edu>

This commit is contained in:

Robert Schmidt

2026-03-23 17:47:32 +01:00

co-authored by

Maxime Elkael

parent ffae59427a

commit db0f6696f4

10 changed files with 189 additions and 61 deletions

									
										openair2/E2AP/RAN_FUNCTION/CUSTOMIZED/ran_func_mac.c
									
		+1
		-1
	
												View File
												
				@@ -81,7 +81,7 @@ bool read_mac_sm(void* data)

				    rd->dl_aggr_sdus = UE->mac_stats.dl.num_mac_sdu;

				    rd->ul_aggr_sdus = UE->mac_stats.ul.num_mac_sdu;

				    rd->pusch_snr = (float) sched_ctrl->pusch_snrx10 / 10; //: float = -64;

				    rd->pusch_snr = sched_ctrl->pusch_pc.avg_snr; //: float = -64;

				    rd->pucch_snr = (float) sched_ctrl->pucch_snrx10 / 10; //: float = -64;

				    rd->wb_cqi = sched_ctrl->CSI_report.cri_ri_li_pmi_cqi_report.wb_cqi_1tb;