Home > Support > NI Product Manuals > LabVIEW Communications System Design Suite 1.0 Manual

Demodulates an minimum shift keying (MSK)-modulated complex baseband waveform and returns the time-aligned oversampled complex waveform, the ideal oversampled waveform, the demodulated bit stream, and the results of offset and drift measurements. This node attempts to remove carrier and phase offset by locking to the carrier signal.

Note  

MT Demodulate MSK assumes that the sample rate of the input complex waveform is exactly samples per symbol × the symbol rate. If this relationship does not apply to your application, use MT Resample (Complex Cluster) to resample the waveform to the desired sample rate.

Note  

Matched filtering and/or waveform realignment performed during symbol timing recovery may lead to the apparent loss of bits. Refer to Filter Delay in the Details for more information about this effect. You can use MT Detect MSK if your application requires only the demodulated bit stream output and not the recovered complex waveform or measurements.

connector_pane_image
datatype_icon

input complex waveform

The modulated complex baseband waveform data.

datatype_icon

t0

Trigger (start) time of the Y array.

Default: 0.0

datatype_icon

dt

Time interval between data points in the Y array.

Default: 1.0

datatype_icon

Y

The complex-valued signal-only baseband modulated waveform. The real and imaginary parts of this complex data array correspond to the in-phase (I) and quadrature-phase (Q) data, respectively.

datatype_icon

MSK system parameters

Parameter values defining the MSK system. Wire the MSK system parameters cluster of MT Generate MSK System Parameters to this cluster. Do not alter the values.

datatype_icon

differential encoding enable

Behavior of the differential encoding.

disable

Disables differential encoding for input symbols.

enable

Enables differential encoding for input symbols.

Default: enable

datatype_icon

samples per symbol

An even number of samples dedicated to each symbol. Multiply this value by the symbol rate to determine the sample rate.

Note  

The demodulation and detector nodes use timing recovery, which is optimized for four or more samples per symbol.

Default: 16

datatype_icon

matched filter coefficients

An ordered array containing the desired matched filter coefficients. Wire the matched filter coefficients parameter of MT Generate Filter Coefficients to this parameter. When generating the filter coefficients, ensure that the value of the matched samples per symbol parameter of MT Generate Filter Coefficients is equal to the value of the samples per symbol element of the MSK system parameters cluster that is passed to this node.

Dependency on reset? Input

datatype_icon

synchronization parameters

Parameter values describing the synchronization sequence and the range of bits over which to search for this sequence. Wire the MSK synchronization parameters cluster returned by MT Generate MSK Synchronization Parameters (bit array) or MT Generate MSK Synchronization Parameters (number array)to this cluster.

Note  

If the synchronization parameters cluster is not wired, the demodulator does not attempt to synchronize, and the constellation of the demodulated waveform has a carrier phase ambiguity.

datatype_icon

expected sync location

The expected location of the first symbol of the sync sequence.

This value is an index to the input complex waveform. A value of -1 searches the entire input complex waveform and ignores the sync location uncertainty parameter.

datatype_icon

sync sequence

The mapped symbol pattern used to synchronize the bit stream. To prevent false synchronization, select this pattern such that there is a low probability of accidental correlation to nonsynchronized parts of the data stream. For MSK, the real portion of the mapped symbols is the frequency deviation of the symbol value, and the imaginary portion is 0. If this parameter is left empty, the signal is still demodulated.

datatype_icon

sync location uncertainty

Number of symbols before or after the expected sync location where the first symbol of the sync sequence may be located. The node ignores this parameter if the expected sync location parameter is set to -1.

Default: 10

datatype_icon

sync indent

Distance that the sync sequence is indented into the information block.

The distance is the number of demodulated symbols preceding the sync sequence. For example, a value of 10 indicates that the output bit stream consists of 10 data symbols, followed by the sync sequence, followed by the remaining data symbols.

Default: 0

datatype_icon

error in

Error conditions that occur before this node runs. The node responds to this input according to standard error behavior.

Default: no error

datatype_icon

pulse shaping filter coefficients

An ordered array containing the desired pulse shaping coefficients. This parameter is used to remodulate the bit stream to perform measurements. Wire the pulse shaping filter coefficients parameter of MT Generate Filter Coefficients to this parameter. When generating the filter coefficients, ensure that the value of the pulse shaping samples per symbol parameter of MT Generate Filter Coefficients is equal to the value of the samples per symbol element of the MSK system parameters cluster.

datatype_icon

reset?

A Boolean that determines whether the node continues demodulating using the previous iteration states.

TRUE Restarts the demodulator. The node resets on the first call and when reset? is set to TRUE.
FALSE Continues demodulating using the previous iteration states. The input complex waveform is contiguous with the input complex waveform from the previous iteration of this node.

Default: TRUE

datatype_icon

detected complex waveform

The ideal oversampled waveform corresponding to the output bit stream. Wire this parameter to the detected complex waveform parameter of MT Measure MSK Quadrature Impairments.

datatype_icon

t0

Trigger (start) time of the Y array.

Default: 0

datatype_icon

dt

Time interval between data values in the Y array.

Default: 1.0

datatype_icon

Y

The complex-valued signal-only baseband modulated waveform. The real and imaginary parts of this complex data array correspond to the in-phase (I) and quadrature-phase (Q) data, respectively.

datatype_icon

recovered complex waveform

The time-aligned and oversampled complex waveform data after frequency offset correction and phase offset correction. The frequency offset and phase offset corrections are scalar values applied to the entire block.

Note  

The recovered complex waveform returned by the MSK demodulator is corrected for carrier phase and frequency offsets. As MSK modulation is essentially a digital implementation of analog FM modulation, you must perform FM demodulation and matched filtering to make frequency deviation measurements or display the eye diagram of the frequency of the recovered waveform. To do this, pass the recovered complex waveform to MT Demodulate FM, followed by MT Matched Filter.

datatype_icon

t0

Trigger (start) time of the Y array.

Default: 0

datatype_icon

dt

Time interval between data values in the Y array.

Default: 1.0

datatype_icon

Y

The complex-valued signal-only baseband modulated waveform. The real and imaginary parts of this complex data array correspond to the in-phase (I) and quadrature-phase (Q) data, respectively.

datatype_icon

output bit stream

The demodulated information bit stream.

Note  

For systems with more than 1 bit per symbol the symbols are converted to bits in least significant bit (LSB) first order. For example, if the detected symbols are 2,1,... the generated bits are 0,1,1,0...

datatype_icon

measurements

Measurements performed by the demodulator.

datatype_icon

frequency offset

The measured carrier frequency offset, in hertz (Hz). The measured frequency offset is removed from the recovered complex waveform.

datatype_icon

frequency drift

The measured carrier frequency drift, in Hz. The measured frequency drift is not removed from the recovered complex waveform.

datatype_icon

phase offset

The measured phase offset, in degrees. The measured phase offset is removed from the recovered complex waveform.

datatype_icon

sync found index

Symbol index within the input complex waveform where the peak correlation to the sync sequence was found. If no sync sequence is specified in the synchronization parameters cluster, the sync found index parameter returns the offset from the start of the input complex waveform to the first complete symbol.

datatype_icon

error out

Error information. The node produces this output according to standard error behavior.