From d585aa0041389e0167025312a240ebed8ba6bde0 Mon Sep 17 00:00:00 2001 From: Guido Casati Date: Wed, 6 Nov 2024 10:33:02 +0100 Subject: [PATCH] Add UL PRBs Blacklist section to NR_SA_Tutorial_COTS_UE.md --- doc/NR_SA_Tutorial_COTS_UE.md | 34 +++++++++++++++++++++++++++++++- doc/images/USRP_tune_offset.png | Bin 0 -> 9354 bytes 2 files changed, 33 insertions(+), 1 deletion(-) create mode 100644 doc/images/USRP_tune_offset.png diff --git a/doc/NR_SA_Tutorial_COTS_UE.md b/doc/NR_SA_Tutorial_COTS_UE.md index 7fc8b27a9a..73e3bffea5 100644 --- a/doc/NR_SA_Tutorial_COTS_UE.md +++ b/doc/NR_SA_Tutorial_COTS_UE.md @@ -193,7 +193,39 @@ sudo ethtool -G enp1s0f0 tx 4096 rx 4096 - You can also reduce the number of LDPC decoder iterations, which will make the LDPC decoder take less time: `--L1s.[0].max_ldpc_iterations 4`. ## 6.3 Uplink issues related with noise on the DC carriers -- There is noise on the DC carriers on N300 and especially the X300 in UL. To avoid their use or shift them away from the center to use more UL spectrum, use the `--tune-offset ` command line switch, where `` is ideally half the bandwidth, or possibly less. + +With devices like the USRP N300 and especially the X300, there is noise in the DC carriers: this can cause uplink PRBs that overlap with the DC carrier to experience interference and increased noise. + +There are two possible solution that can be enabled in OAI: + +* `--tune-offset`: it consists in shifting away the operational bandwidth to avoid the center frequency +* `ul_prbblacklist`: can be used to define specific PRBs that should not be used for uplink scheduling + +A spectrum clean from the noisy PRBs will eventually result in an enhanced UL throughput. + +Using `--tune-offset`, `ul_prbblacklist` or none at all is depending on the combination of the USRP model, the operational bandwidth configuration and the bandwidth of the daughterboard. + +There are two main points to keep in mind: + +- USRPs come with various daughterboards, each with its own specific bandwidth (see datasheets). +- Using `--tune-offset` to shift the entire operational bandwidth to avoid the center frequency could exceed the device capabilities: if the shifted operational bandwidth falls entirely within the bandwidth of the daughterboard, than `--tune-offset` is sufficient, otherwise `--tune-offset` is ineffective and `ul_prbblacklist` is needed. + +The option `ul_prbblacklist` is more relevant when using high-bandwidth configurations (e.g., 100 MHz) with devices like the USRP N310 or X310: in this scenarios, `--tune-offset` could not be sufficient to get rid of the noisy PRBs in the center frequency entirely, because it is not possible to shift the DC carriers out of the bandwidth (tune offset shall be smaller than half the bandwidth of the board). + +## 6.3.1 Tune offset + +The value passed to the command line option `--tune-offset ` will be calling an UHD API. It represents the LO offset frequency in Hz. +The API (tune_request_t class) will send a frequency tuning request (`tx_tune_req`, `rx_tune_req`) to the USRP device, in order to configure the target baseband tx/rx frequency, therefore shifting the tx/rx signal spectrum. + +The value passed to this option should be ideally equal to half the operational bandwidth, or possibly less, depending on the bandwidth configuration, and also it shall be lower or equal than half the bandwidth of the board. + +A visual representation of the impact of tune-offset with a 120 MHz bandwidth daughterboard: + +![Tune_Offset](./images/USRP_tune_offset.png) + +## 6.3.2 UL PRBs Blacklist + +To use this option, in the configuration file, e.g. 100 MHz bandwidth setup: `ul_prbblacklist = "135,136,137,138"`. ## 6.4 Lower latency on user plane - To lower latency on the user plane, you can force the UE to be scheduled constantly in uplink: `--MACRLCs.[0].ulsch_max_frame_inactivity 0` . diff --git a/doc/images/USRP_tune_offset.png b/doc/images/USRP_tune_offset.png new file mode 100644 index 0000000000000000000000000000000000000000..1372373503b78deae810e6b3ea176ae1005783f2 GIT binary patch literal 9354 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