matlab/matlab-agentic-toolkit / skills-catalog/wireless-communications/matlab-generate-5g-waveform
matlab-generate-5g-waveform
VerifiedGenerate 3GPP-compliant 5G NR downlink and uplink baseband waveforms. Use to create NR signals, test model (TM) waveforms, fixed reference channels (FRC), test and measurement (T&M) signals, or test vectors for conformance testing. Covers configuring data, control, and broadcast channels and signals: PDSCH, PUSCH, PDCCH, PUCCH, SRS, SSBurst, CSI-RS, DM-RS, PT-RS, CORESET, and BWP parameters including bandwidth, subcarrier spacing (SCS), modulation (QPSK, QAM), numerology, FR1, FR2, TDD, FDD, and multi-bandwidth-part setups. Use for signal generation, RF instrument playback, or IQ baseband synthesis. Requires 5G Toolbox.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.0 KB |
| manifest.yaml | config | 440 B |
| references/api-reference.md | markdown | 3.4 KB |
| references/critical-rules.md | markdown | 8.0 KB |
| references/documentation-links.md | markdown | 2.4 KB |
| references/multi-bwp-guidance.md | markdown | 17.7 KB |
| references/narrow-band-manual-config.md | markdown | 4.5 KB |
| references/patterns.md | markdown | 1.8 KB |
| references/test-models-and-frc.md | markdown | 5.0 KB |
references/test-models-and-frc.md
View on GitHub# Test Models and Fixed Reference Channels
Use `hNRReferenceWaveformGenerator` to generate standard-defined NR test model
(TM) and fixed reference channel (FRC) waveforms. This is an example helper
shipped with 5G Toolbox (see the
[5G NR TM Waveform Generation](https://mathworks.com/help/5g/ug/5g-nr-tm-waveform-generation.html)
example).
## First: Make the Helper Available (Portable Setup)
`hNRReferenceWaveformGenerator` is an **example helper**, not a core toolbox
function, so it is not on the path by default. Bring it in with a portable,
reproducible mechanism — **never a hardcoded absolute path** (no user home or
release folder), and **do not** invent a namespaced name like
`wirelessWaveformApp.internal.hNRReferenceWaveformGenerator`:
```matlab
[exDir, ~] = setupExample('5g/NRTestModelWaveformGenerationExample', fullfile(tempdir, 'tmfrc'));
workDir = fullfile(tempdir, 'myTMWaveform');
mkdir(workDir);
copyfile(fullfile(exDir, '*'), workDir);
cd(workDir);
```
`openExample('5g/NRTestModelWaveformGenerationExample')` also works, as does an
`addpath` whose target is derived at runtime from `matlabroot`/`tempdir`/the
`setupExample`/`openExample` return value. Only after this is the helper
callable by its plain name.
## Basic Usage
```matlab
wavegen = hNRReferenceWaveformGenerator(RC, BW, SCS, DM, NCELLID);
[waveform, waveinfo] = generateWaveform(wavegen);
```
| Argument | Description | Default |
|----------|-------------|---------|
| `RC` | Reference channel identifier (see tables below) | Required |
| `BW` | Channel bandwidth: `'10MHz'`, `10`, or `"10MHz"` | 10 MHz (FR1), 100 MHz (FR2) |
| `SCS` | Subcarrier spacing: `'15kHz'`, `15`, or `"15kHz"` | 15 kHz (FR1), 120 kHz (FR2) |
| `DM` | Duplex mode: `'FDD'` or `'TDD'` | FDD (FR1), TDD (FR2) |
| `NCELLID` | Physical cell ID | 1 (DL), 0 (UL) |
The BW and SCS combination must be valid per the bandwidth table.
`RC`, `BW`, and `SCS` are the arguments you normally supply. `DM` and
`NCELLID` are optional — pass them only when the task specifies a particular
duplex mode or cell ID. Restating their defaults (`'FDD'`, `1`) adds nothing:
```matlab
% Requested: model, bandwidth, SCS only
wavegen = hNRReferenceWaveformGenerator('NR-FR1-TM1.1', '10MHz', '15kHz');
```
## Valid FR1 Test Models
| Identifier | Description |
|-----------|-------------|
| `'NR-FR1-TM1.1'` | Full-band QPSK, single PDSCH |
| `'NR-FR1-TM1.2'` | Full-band QPSK with boosted/deboosted PRBs |
| `'NR-FR1-TM2'` | Full-band 64QAM |
| `'NR-FR1-TM2a'` | Full-band 256QAM |
| `'NR-FR1-TM2b'` | Full-band 1024QAM |
| `'NR-FR1-TM3.1'` | Partial-band 16QAM |
| `'NR-FR1-TM3.1a'` | Partial-band 16QAM, variant |
| `'NR-FR1-TM3.1b'` | Partial-band 16QAM, variant |
| `'NR-FR1-TM3.2'` | Partial-band 16QAM/QPSK |
| `'NR-FR1-TM3.3'` | Partial-band QPSK |
## Valid FR2 Test Models
| Identifier | Description |
|-----------|-------------|
| `'NR-FR2-TM1.1'` | Full-band QPSK |
| `'NR-FR2-TM2'` | Full-band 64QAM |
| `'NR-FR2-TM2a'` | Full-band 256QAM |
| `'NR-FR2-TM3.1'` | Partial-band 16QAM |
| `'NR-FR2-TM3.1a'` | Partial-band 16QAM, variant |
## Valid DL Fixed Reference Channels
**FR1:** `'DL-FRC-FR1-QPSK'`, `'DL-FRC-FR1-64QAM'`, `'DL-FRC-FR1-256QAM'`,
`'DL-FRC-FR1-1024QAM'`
**FR2:** `'DL-FRC-FR2-QPSK'`, `'DL-FRC-FR2-16QAM'`, `'DL-FRC-FR2-64QAM'`,
`'DL-FRC-FR2-256QAM'`
## Valid UL Fixed Reference Channels
**FR1:** `'G-FR1-Ax-y'` format, where x = 1-5 and y varies. Examples:
`'G-FR1-A1-1'` through `'G-FR1-A5-14'`. Full list available via:
```matlab
hNRReferenceWaveformGenerator.FR1UplinkFRC
```
**FR2:** `'G-FR2-Ax-y'` format. Full list:
```matlab
hNRReferenceWaveformGenerator.FR2UplinkFRC
```
## Visualizing the Resource Grid
```matlab
displayResourceGrid(wavegen);
```
## Modifying Test Model Parameters
The `Config` property is read-only by default. To customize:
```matlab
wavegen = makeConfigWritable(wavegen);
% Example: enable transport coding on all PDSCHs
pdschArray = [wavegen.Config.PDSCH{:}];
[pdschArray.Coding] = deal(true);
wavegen.Config.PDSCH = num2cell(pdschArray);
[waveform, waveinfo] = generateWaveform(wavegen);
```
The `Config` property is an `nrDLCarrierConfig` or `nrULCarrierConfig` object,
so all the same customization patterns apply.
## Output Structure
```matlab
[waveform, waveinfo] = generateWaveform(wavegen);
```
| Field | Contents |
|-------|----------|
| `waveinfo.ResourceGridBWP` | Resource grid (subcarriers x symbols) |
| `waveinfo.Info.SampleRate` | Waveform sample rate |
| `waveinfo.Info.Nfft` | FFT size |
## Common Mistakes
- **Wrong model name format:** Use `'NR-FR1-TM1.1'` not `'FR1-TM1.1'` or
`'TM1.1'`. The `NR-` prefix is required.
- **Function does not exist:** If `hNRReferenceWaveformGenerator` is not found,
open the example first:
[5G NR TM Waveform Generation](https://mathworks.com/help/5g/ug/5g-nr-tm-waveform-generation.html).
This adds the helper to the MATLAB path.
- **Hallucinated alternatives:** `nrTMWaveformGenerator`, `h5gNRTMConfig`,
`nrTestModel`, `nrRMCDL` do **not exist**. Only
`hNRReferenceWaveformGenerator` is available.
Copyright 2026 The MathWorks, Inc.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |