Home / 5G / Protocols / PHY / TDD UL/DL Configuration

5G NR TDD UL/DL Configuration

TDD UL/DL configuration in 5G NR defines which time resources are downlink, which are uplink, and which remain flexible on a TDD carrier. It is the timing map that many other PHY procedures assume before control, data, or random-access behavior can be interpreted correctly.

Read this topic as the direction layer on top of the frame structure. Once the slot and symbol timing is known, the TDD configuration tells the UE and gNB where downlink reception, uplink transmission, and flexible behavior are allowed.

Technology 5G NR
Area PHY timing and duplexing
Main specs 3GPP TS 38.213, 38.331, 38.211
Release Release 18
Main use Defines downlink, uplink, and flexible slot and symbol direction in TDD operation
Main fields referenceSubcarrierSpacing, pattern1, pattern2, nrofDownlinkSlots, nrofDownlinkSymbols, nrofUplinkSlots, nrofUplinkSymbols
Main variants Common TDD pattern plus dedicated slot-specific overrides where configured
Related pages Frame Structure, Numerology, PDCCH, PDSCH, PUSCH, PRACH
5G NR TDD pattern layout showing downlink slots, flexible symbols, and uplink slots inside a repeating period
The TDD pattern is read as a repeating direction map. Full downlink slots, partial downlink symbols, partial uplink symbols, and full uplink slots together define the usable timing structure.
5G NR TDD periodicity map showing pattern repetition with reference subcarrier spacing and optional second pattern
Pattern periodicity matters as much as slot direction. The UE reads the TDD pattern against the configured repetition period and the reference subcarrier spacing.

Contents

  1. Overview
  2. How the TDD UL/DL model works
  3. Operational view
  4. Where TDD configuration appears in real procedures
  5. Troubleshooting
  6. References
  7. FAQ

Overview

TDD configuration is the time-direction definition for an NR TDD carrier. It decides whether a given slot or a symbol range inside a slot is reserved for downlink, uplink, or flexible use.

  • It is carried mainly through TDD-UL-DL-ConfigCommon.
  • It is built from one or two repeating patterns.
  • Each pattern combines full downlink slots, partial downlink symbols, full uplink slots, and partial uplink symbols.
  • Dedicated slot-specific configuration can override the common pattern in configured cases.
  • Control, data, PRACH, and monitoring behavior all depend on this direction map.

Quick interpretation

Role Defines the downlink, uplink, and flexible time resources of a TDD carrier
Configured by TDD-UL-DL-ConfigCommon and, when applicable, dedicated slot-specific overrides
Main timing anchor referenceSubcarrierSpacing plus one or two repeating DL/UL patterns
Pattern fields dl-UL-TransmissionPeriodicity, nrofDownlinkSlots, nrofDownlinkSymbols, nrofUplinkSlots, and nrofUplinkSymbols
Main impact Control timing, downlink scheduling, uplink opportunities, PRACH timing, guard behavior, and latency balance

How the TDD UL/DL model works

The common TDD configuration is defined by referenceSubcarrierSpacing and at least one TDD-UL-DL-Pattern. A pattern contains a repetition period plus counts for full downlink slots, partial downlink symbols, full uplink slots, and partial uplink symbols.

Reference subcarrier spacing

referenceSubcarrierSpacing gives the SCS basis used to interpret the TDD pattern. Because slot duration changes with numerology, the same periodicity value means a different slot count at different SCS settings.

Pattern structure

Each TDD-UL-DL-Pattern contains:

  • dl-UL-TransmissionPeriodicity for the repetition period
  • nrofDownlinkSlots for full downlink slots
  • nrofDownlinkSymbols for additional downlink-only symbols in the transition slot
  • nrofUplinkSlots for full uplink slots
  • nrofUplinkSymbols for additional uplink-only symbols in the transition slot

What remains between the partial downlink and partial uplink symbol groups is the flexible region. That region is where later control procedures and scheduling can create more adaptable behavior.

Pattern1 and Pattern2

pattern1 is mandatory and defines the main TDD cycle. pattern2 is optional and can extend the direction model when a second repeating pattern is needed. In practical reading, many deployments use only one pattern, but the page should always be read with the possibility of two configured patterns.

Dedicated overrides

Dedicated TDD configuration does not replace the full common pattern. It overrides specific slots through TDD-UL-DL-SlotConfig style configuration. This is most important when one slot must behave differently from the common cycle instead of redesigning the whole repeating pattern.

Field or concept Purpose
referenceSubcarrierSpacing Defines the SCS basis for the pattern timing interpretation
pattern1 Main repeating TDD pattern
pattern2 Optional second TDD pattern
dl-UL-TransmissionPeriodicity Defines how often the pattern repeats
nrofDownlinkSlots Number of full downlink slots in the pattern
nrofDownlinkSymbols Number of extra downlink-only symbols in the transition slot
nrofUplinkSlots Number of full uplink slots in the pattern
nrofUplinkSymbols Number of extra uplink-only symbols in the transition slot
Flexible symbols Symbols not fixed as purely downlink or uplink by the common pattern
Dedicated slot config Overrides selected slots without replacing the entire common pattern

Operational view

Read TDD configuration as the timing constraint behind control and data procedures. Many apparent scheduling or radio issues are simply direction-map issues once the configured pattern is examined.

Control and monitoring

PDCCH monitoring and search-space behavior make sense only on symbols that can be used as downlink or flexible for control. The UE does not read control as if every slot were symmetric.

Shared-channel scheduling

PDSCH needs downlink direction. PUSCH needs uplink direction. A pattern that favors one side heavily changes throughput balance, latency, and grant availability even when the radio conditions are unchanged.

Flexible-symbol reading

Flexible symbols are the most commonly misunderstood part of the TDD pattern. They are not simply "free" symbols. They are adaptable symbols that must still follow the higher-layer and DCI-driven interpretation rules used by the UE and gNB.

Release 18 reading

Release 18 TDD reading is broader than a static DL/UL ratio view. It includes common-pattern interpretation, slot-specific dedicated overrides, multi-cell directional-collision handling, and interactions with special control such as DCI format 2_0 and other procedure-specific control behavior.

Reading area Why it matters
Pattern periodicity Defines the repeating timing window for DL and UL opportunities
DL slot and symbol counts Defines when downlink control and data can be scheduled
UL slot and symbol counts Defines when uplink control, data, and random access can occur
Flexible symbols Defines where more adaptable scheduling behavior may exist
Dedicated overrides Defines whether one slot behaves differently from the common pattern

Where TDD configuration appears in real procedures

Initial access

SSB / PBCH -> PRACH opportunity in UL symbols -> access response in DL symbols -> setup path

Random access depends on having the right uplink opportunity in the configured TDD pattern. A cell can be visible while access still fails because the expected PRACH timing is misread or too sparse.

Control and grant delivery

DL or flexible control symbols -> PDCCH -> DCI -> PDSCH or PUSCH action in allowed symbols

Control and data are both constrained by TDD direction. A valid DCI still needs usable DL or UL symbols for the scheduled action.

Throughput balance

DL-heavy pattern -> more downlink capacity | UL-heavy pattern -> more uplink opportunity | flexible region -> adaptation margin

This is why throughput and latency must be read together with the TDD pattern, not only with channel quality.

Troubleshooting

Start with TDD configuration when uplink and downlink behavior look asymmetric, when PRACH timing seems inconsistent, or when control and data appear to vanish only on specific slots or symbol groups.

  • Check the configured referenceSubcarrierSpacing and pattern periodicity first.
  • Check whether the expected slot is truly DL, UL, or flexible.
  • Check whether a dedicated slot-specific override is active.
  • Check whether PRACH, PUCCH, PUSCH, PDCCH, or PDSCH are being expected on the wrong symbol direction.
  • Check whether the symptom is really a scheduling issue or simply a direction-map issue.
Symptom What to inspect first
PRACH never appears when expected UL slot and symbol availability in the TDD pattern and the configured PRACH timing relation
PDCCH seems missing on some slots Whether the monitored slot and symbols are downlink or flexible in the current pattern
Strong downlink but weak uplink opportunity UL slot count, UL symbol count, and whether the pattern is DL-heavy by design
Latency spikes at regular intervals Pattern periodicity and whether grants must wait for the next allowed direction window
One slot behaves differently from the rest Dedicated slot-specific configuration overriding the common TDD pattern

Common reading mistakes

  • Reading TDD only as a DL/UL ratio instead of as a slot and symbol direction map.
  • Ignoring the role of referenceSubcarrierSpacing in pattern timing interpretation.
  • Assuming flexible symbols behave as permanently downlink or permanently uplink.
  • Ignoring dedicated slot overrides and reading only the common pattern.
  • Explaining throughput or access issues without first checking whether the needed direction actually exists at that time.

References

FAQ

What is TDD UL/DL configuration in 5G NR?

It is the configuration that defines which slots and symbols are downlink, uplink, or flexible in a TDD carrier.

What do pattern1 and pattern2 mean?

Pattern1 is the main repeating TDD pattern. Pattern2 is an optional second pattern that can also be configured.

What are flexible symbols?

Flexible symbols are symbols not fixed as fully downlink or fully uplink by the common pattern. They allow more adaptable control and scheduling behavior.

What is the difference between common and dedicated TDD configuration?

The common configuration defines the main repeating pattern. Dedicated configuration overrides selected slots instead of replacing the whole pattern.

Why does TDD configuration matter in troubleshooting?

Because a procedure can fail simply because the expected uplink or downlink direction is not available in that slot or symbol range.

Related PHY topics