info

Display information about RBDS waveform generator

Syntax

rbdsInfo = info(rbdsWaveGen)

Description

rbdsInfo = info(rbdsWaveGen) returns a structure containing information for the comm.RBDSWaveformGenerator System object™.

Examples

Review RBDS Encoding Implementation

Review a encoding implementation for the open data application (ODA) by using the info method of the comm.RBDSWaveformGenerator System object™. Set the ODA ID to 'CD46', which is the ID for the traffic message channel. The allocated group type is 8A.

rbds = comm.RBDSWaveformGenerator();
odaID = 'CD46';
allocatedGroupType = '8A';
s = info(rbds)

s = struct with fields:
             ODAMap: [1×1 struct]
    SamplesPerFrame: 1040

s.ODAMap

ans = struct with fields:
              ID: '4BD7'
       GroupType: '11A'
    FunctionMain: @comm.internal.RadioTextPlusEncodingMain
      Function3A: @comm.internal.RadioTextPlusEncoding3A

Input Arguments

rbdsWaveGen — RBDS waveform generator

comm.RBDSWaveformGenerator System object

RBDS waveform generator, specified as a comm.RBDSWaveformGenerator System object.

Output Arguments

rbdsInfo — RBDS waveform generator information

structure

RBDS waveform generator information, returned as a structure containing these fields. The RBDS waveform generator object is specified by the input rbdsWaveGen.

ODAMap — Open data application map

structure | vector of structures

Open data application map, returned as a structure of vector of structures containing these fields.

ID — Application identification number

hexadecimal scalar

Application identification number (AID), returned as a hexadecimal scalar representing a 16-bit value.

GroupType — Open format group type

char

Open format group type, returned as character vector containing one of these alphanumeric codes: '3B', '4B', '5A', '5B', '6A', '6B', '7A', '7B', '8A', '8B', '9A', '9B', '10B', '11A', '11B', '12A', '12B', '13A', or '13B'.

FunctionMain — Pointer to main function

function handle

Pointer to the main function, returned as a function handle. By default the function handle returned is @comm.internal.RadioTextPlusEncodingMain. To register a custom function handle use the registerODA object function.

The main function pointed to by the function handle generates four 16-bit words when the received group type has the value GroupType in this ODA map.

Function3A — Pointer to 3A function

function handle

Pointer to the 3A function, returned as a function handle. By default the function handle returned is @comm.internal.RadioTextPlusEncoding3A. To register a custom function handle use the registerODA object function.

The 3A function is the function handle that generates the third 16-bit information word when the received group type value, GroupType='3A' in this ODA map.

SamplesPerFrame — Number of samples per frame

positive scalar

The number of samples per frame, returned as a positive scalar. The number of samples per frames equals (rbdsWaveGen.GroupsPerFrame×104×rbdsWaveGen.SamplesPerSymbol)

Version History

Introduced in R2017a