Communications Blockset Release Notes

Communications Blockset
Release Notes
The “Communications Blockset 2.5 Release Notes” on page 1-1 describe
the changes introduced in the latest version of the Communications
Blockset. The following topics are discussed in these Release Notes.
• “New Features” on page 1-2
• “Major Bug Fixes” on page 1-7
• “Upgrading from an Earlier Release” on page 1-8
• “Known Software and Documentation Problems” on page 1-10
The Communications Blockset Release Notes also provide information
about recent versions of the product, in case you are upgrading from a
version that was released prior to Release 12.1. If you are upgrading from
a release earlier than Release 12.1, you should also see these sections:
• “Communications Blockset 2.0.1 Release Notes” on page 2-1
• “Communications Blockset 2.0 Release Notes” on page 3-1
Printing the Release Notes
If you would like to print the Release Notes, you can link to a PDF version.
-2
Contents
Communications Blockset 2.5 Release Notes
1
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RF Impairments Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sequence Generators Library . . . . . . . . . . . . . . . . . . . . . . . . . . .
Eye Diagram, ScatterPlot, and Signal Trajectory Scopes . . . . .
CRC Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enhancements to Reed-Solomon Blocks . . . . . . . . . . . . . . . . . .
New Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enhancements to CPM Modulator Block . . . . . . . . . . . . . . . . . .
1-2
1-2
1-3
1-4
1-4
1-5
1-5
1-6
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 1-8
Old Models Using the Baseband or Passband SSB Modulators
Must be Resaved . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Change the Boolean Logic Signals Parameter to Off . . . . . . . . 1-8
Known Software and Documentation Problems . . . . . . . . . 1-10
Communications Blockset 2.0.1 Release Notes
2
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting Simulink Preferences Automatically . . . . . . . . . . . . . . .
Converting Between Bipolar and Unipolar Signals . . . . . . . . .
Choosing Seeds for Random-Output Blocks . . . . . . . . . . . . . . .
Using Error Counts to Control Simulation Duration . . . . . . . .
Choosing the Algorithm for Integrator Blocks . . . . . . . . . . . . . .
2-2
2-2
2-2
2-2
2-3
2-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Bug Fixes Incorporated from Release 12.0 . . . . . . . . . . . . . . . . 2-4
iii
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 2-5
Known Software Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Code Generation Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Limited Frame and Matrix Support . . . . . . . . . . . . . . . . . . . . . . 2-6
Communications Blockset 2.0 Release Notes
3
New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Digital Modulation Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interleaving Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fading Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enhanced Support for Convolutional Coding . . . . . . . . . . . . . . .
Sequence Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-2
3-2
3-2
3-3
3-3
3-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Upgrading from an Earlier Release . . . . . . . . . . . . . . . . . . . . . 3-5
New Block Libraries in Release 12 . . . . . . . . . . . . . . . . . . . . . . . 3-5
New Signal Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Functionality Changes in Specific Blocks . . . . . . . . . . . . . . . . . . 3-7
Block Name Changes Since Previous Manual . . . . . . . . . . . . . . 3-8
Obsolete Blocks from Previous Manual . . . . . . . . . . . . . . . . . . 3-12
Known Software Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
Code Generation Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
Limited Frame and Matrix Support . . . . . . . . . . . . . . . . . . . . . 3-19
iv
Contents
1
Communications Blockset
2.5 Release Notes
New Features . . . . . . . . . . . . . . . . .
RF Impairments Library . . . . . . . . . . . . .
Sequence Generators Library . . . . . . . . . . . .
Eye Diagram, ScatterPlot, and Signal Trajectory Scopes .
CRC Library . . . . . . . . . . . . . . . . . .
Enhancements to Reed-Solomon Blocks . . . . . . .
New Demos . . . . . . . . . . . . . . . . . . .
Enhancements to CPM Modulator Block . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-2
1-2
1-3
1-4
1-4
1-5
1-5
1-6
Major Bug Fixes . . . . . . . . . . . . . . . . . . 1-7
Upgrading from an Earlier Release . . . . . . . . . 1-8
Old Models Using the Baseband or Passband SSB Modulators
Must be Resaved . . . . . . . . . . . . . . . . 1-8
Change the Boolean Logic Signals Parameter to Off . . . . 1-8
Known Software and Documentation Problems . . . . 1-10
1
Communications Blockset 2.5 Release Notes
New Features
This section summarizes the new features and enhancements introduced in the
Communications Blockset 2.5:
• RF Impairments Library
• Sequence Generators Library
• Eye Diagram, ScatterPlot, and Signal Trajectory Scopes
• CRC Library
• Enhancements to Reed-Solomon Blocks
• New Demos
• Enhancements to CPM Modulator Block
If you are upgrading from a release earlier than Release 12.1, then you should
also see the Communications Blockset 2.0.1 Release Notes, starting with “New
Features” on page 2-2.
RF Impairments Library
The new RF Impairments library contains blocks to simulate radio frequency
(RF) impairments at the receiver. The blocks in the library are listed in the
following table.
1-2
Block Name
Purpose
Free Space Path Loss
Reduce the amplitude of the input signal by
the amount specified
I/Q Imbalance
Create a complex baseband model of the
signal impairments caused by imbalances
between in-phase and quadrature receiver
components
Memoryless Nonlinearity
Apply a memoryless nonlinearity to a
complex, baseband signal
Phase/Frequency Offset
Apply residual phase and frequency offsets to
a complex, baseband signal
New Features
Block Name (Continued)
Purpose (Continued)
Phase Noise
Apply receiver phase noise to a complex,
baseband signal
Receiver Thermal Noise
Apply receiver thermal noise to a complex,
baseband signal
Sequence Generators Library
The Comm Sources library is now divided into four sublibraries for Version 2.5.
Three of these sublibraries contain the blocks from the Version 2.0.1 Comm
Sources library:
• Data Sources
• Noise Sources
• Controlled Sources
The fourth, the Sequence Generators sublibrary, contains the PN Sequence
Generator block and five new blocks for Version 2.5. You can use the blocks in
the Sequence Generators sublibrary to generate sequences for spreading or
synchronization in a communication system. The following table lists the
blocks in the Sequence Generators sublibrary.
Block Name
Purpose
Barker Code Generator
Generate a Barker Code
Gold Sequence Generator
Generate a Gold sequence from a set of
sequences
Kasami Sequence Generator
Generate a Kasami sequence from the
set of Kasami sequences
Hadamard Code Generator
Generate a Hadamard code from an
orthogonal set of codes
OVSF Code Generator
Generate an orthogonal variable
spreading factor (OVSF) code from a set
of orthogonal codes
1-3
1
Communications Blockset 2.5 Release Notes
Block Name (Continued)
Purpose (Continued)
PN Sequence Generator
Generate a pseudonoise sequence
Walsh Code Generator
Generate a Walsh code from an
orthogonal set of codes
Eye Diagram, ScatterPlot, and Signal Trajectory
Scopes
The Version 2.0.1 Discrete-Time Eye and Scatter Diagram block, in the Comm
Sinks library, has been replaced by three new blocks for Version 2.5, as
described in the following table.
Block Name
Purpose
Discrete-Time Eye
Diagram Scope
Display multiple traces of a modulated signal
Discrete-Time Scatter
Plot Scope
Display a modulated signal in its signal space
by plotting its in-phase component against its
quadrature component
Discrete-Time Signal
Trajectory Scope
Display a modulated signal in its signal space
by plotting its in-phase component versus its
quadrature component
These blocks greatly enhance the features of the Discrete-Time Eye and
Scatter Diagram.
CRC Library
The Channel Coding library has been renamed the Error Correction and
Detection library, and a new sublibrary, CRC, has been added to the Error
Detection and Correction library. The CRC library contains new blocks for
appending cylic redundancy check (CRC) bits to data and for detecting errors
in transmission.
1-4
New Features
The following table lists the blocks in the CRC library.
Block Name
Purpose
CRC-N Generator
Generate CRC bits according to the
selected CRC method and append
them to input data
CRC-N Syndrome Detector
Detect errors in the input data
according to the specified CRC method
General CRC Generator
Generate CRC bits according to the
generator polynomial and append
them to input data
General CRC Syndrome Detector
Detect errors in the input data
according to the generator polynomial
Enhancements to Reed-Solomon Blocks
The following four blocks, in the Block sublibrary of the Error Detection and
Correction Library, have new features:
• Binary-Input RS Endoder
• Binary-Input RS Decoder
• Integer-Input RS Encoder
• Integer-Input RS Decoder
You can now specify the primitive polynomial and generator polynomial, which
are used to generate the codes. This enables you to use a much wider range of
Reed-Solomon Codes. There is also a new option to output the number of
corrected errors from the Binary-Input RS Decoder and Integer-Input RS
Decoder blocks.
New Demos
The Communications Blockset contains eleven new demos for Version 2.5.
These include a large-scale demo model of a commercial application of a third
generation (3G) wireless system using wide-band code division multiple access
(WCDMA). The demo presents an end-to-end transmission between a base
1-5
1
Communications Blockset 2.5 Release Notes
station and a mobile station, as specified by the Third Generation Partnership
Project (3GPP).
The new demos are as follows:
• WCDMA End-to-End Physical Layer Demo
• WCDMA Coding and Multiplexing Demo
• WCDMA Spreading and Modulation Demo
• RF Satellite Link Demo
• HiperLAN/2 Demo
• Bluetooth Voice Transmission Demo
• Adaptive Equalization Demo
• CPM Phase Tree Demo
• GMSK vs. MSK Demo
• Filtered QPSK vs. MSK Demo
• Raleigh Fading Channel Demo
Enhancements to CPM Modulator Block
The CPM modulator block now enables you to specify both the entire pulse
length and the pulse main lobe length when simulating an LSRC frequency
pulse length. This feature enables you to simulate a modulation such as
3SRC6.
1-6
Major Bug Fixes
Major Bug Fixes
The Communications Blockset 2.5 includes several bug fixes made since
Version 2.0.1. This section describes the particularly important Version 2.5 bug
fixes.
If you are viewing these Release Notes in PDF form, please refer to the HTML
form of the Release Notes, using either the Help browser or the MathWorks
Web site and use the link provided.
If you are upgrading from a release earlier than Release 12.1, then you should
see “Major Bug Fixes” on page 2-4.
1-7
1
Communications Blockset 2.5 Release Notes
Upgrading from an Earlier Release
There issues involved in upgrading from the Communications Blockset 2.0.1 to
Version 2.5 are described below.
If you are upgrading from a version earlier than 2.0.1, then you should see
“Upgrading from an Earlier Release” on page 2-5.
Old Models Using the Baseband or Passband SSB
Modulators Must be Resaved
The baseband and passband SSB modulators have been updated for Release 13
to now include a pop-up menu enabling you to choose between upper and lower
sideband modulation. You should resave any models using the old SSB
modulators before running them in Release 13 to avoid producing Simulink
warnings.
Change the Boolean Logic Signals Parameter to Off
The Communications Blockset does not support signals with boolean data
type. In Release 13, the Simulink Boolean logic signals parameter is now set
to On by default. If you use Simulink blocks, such as the Logical Operator
block, together with Communications Blockset blocks in a model, you must
change the default setting of the Boolean logic signals parameter setting to
Off. To do so, type
commstartup
at the beginning of each MATLAB session, before you create a model. This sets
the Boolean logic signals parameter to Off for every model you create during
the current MATLAB session.
To manually change the Boolean logic signals parameter in a model to Off, do
the following steps:
1 Select Simulation parameters from the Simulation menu on the toolbar.
2 Click the Advanced tab in the Simulation Parameters dialog box.
3 Select Boolean logic signals in the Optimizations field.
4 Under Action, select the Off check box.
1-8
Upgrading from an Earlier Release
5 Click OK.
Note that this changes the Boolean logic signals parameter to Off only for the
current model.
Since the default setting of the Boolean logic signals parameter prior to
Release 13 was Off, it is not necessary to make changes to models that you
created prior to Release 13.
1-9
1
Communications Blockset 2.5 Release Notes
Known Software and Documentation Problems
This section includes a link to a description of known software and
documentation problems in Version 2.5.
If you are viewing these Release Notes in PDF form, please refer to the HTML
form of the Release Notes, using either the Help browser or the MathWorks
Web site and use the link provided.
For a list of bugs reported in the previous release that remain open, see “Known
Software Problems” on page 2-6.
1-10
2
Communications Blockset
2.0.1 Release Notes
New Features . . . . . . . . . . . . . . .
Setting Simulink Preferences Automatically . . .
Converting Between Bipolar and Unipolar Signals .
Choosing Seeds for Random-Output Blocks . . . .
Using Error Counts to Control Simulation Duration
Choosing the Algorithm for Integrator Blocks . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-2
2-2
2-2
2-2
2-3
2-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . 2-4
Bug Fixes Incorporated from Release 12.0 . . . . . . . . 2-4
Upgrading from an Earlier Release
. . . . . . . . . 2-5
Known Software Problems . . . . . . . . . . . . . 2-6
Code Generation Limitations . . . . . . . . . . . . . . 2-6
Limited Frame and Matrix Support . . . . . . . . . . . 2-6
2
Communications Blockset 2.0.1 Release Notes
New Features
Note The Communications Blockset was a new product that was introduced
with Release 12.0. The Communications Blockset incorporates the
functionality of the blocks that were included in the Communications Toolbox
1.4 (Release 11), with the addition of the new features summarized below. The
Communications Toolbox is described in the Communications Toolbox 2.0
Release Notes.
This section introduces the new features and enhancements added in the
Communications Blockset 2.0.1 since the Communications Blockset 2.0
(Release 12.0).
For information about Communications Blockset features that are
incorporated from the previous release, see “New Features” on page 3-2.
Setting Simulink Preferences Automatically
The new commstartup.m script sets certain Simulink preferences to values that
are most appropriate for the simulation of communication systems. To use this
script, type the command commstartup in your startup.m file or in the
MATLAB Command Window.
Converting Between Bipolar and Unipolar Signals
The Utility Functions library contains new blocks that convert between bipolar
and unipolar signals. The blocks are Bipolar to Unipolar Converter and
Unipolar to Bipolar Converter.
Choosing Seeds for Random-Output Blocks
The randseed function is a new function that generates prime numbers for use
as Initial seed parameters in blocks that produce random output. Compared
to composite seeds, prime seeds yield output that has better statistical
properties.
2-2
New Features
Using Error Counts to Control Simulation Duration
You can now configure the Error Rate Calculation block so that it
automatically stops the simulation upon detecting a specified number of errors.
You do not need to know in advance how long it will take to accumulate that
many errors.
Choosing the Algorithm for Integrator Blocks
The Discrete Modulo Integrator block now allows you to choose the integration
method using a mask parameter. The corresponding mask parameter in the
Windowed Integrator block has changed its name from Method to Integration
method for consistency with other integration blocks.
2-3
2
Communications Blockset 2.0.1 Release Notes
Major Bug Fixes
The Communications Blockset 2.0.1 includes several bug fixes, including the
following:
• The M-FSK Baseband Modulator, M-FSK Baseband Demodulator, M-FSK
Passband Modulator, and M-FSK Passband Demodulator blocks now use the
correct tone spacing.
• The PN Sequence Generator block now generates only binary values, and the
numbers in the sequence do not depend on the frame status or size.
Bug Fixes Incorporated from Release 12.0
The Communications Blockset 2.0.1 includes several bug fixes that were made
in Release 12.0; see “Major Bug Fixes” on page 3-4.
2-4
Upgrading from an Earlier Release
Upgrading from an Earlier Release
If you are upgrading from an earlier release to the Communications Blockset
2.0.1, then note these issues:
• The Binary Symmetric Channel block dialog box now omits the Input vector
length and Sample time parameters because the block now determines
these quantities automatically. However, if you open a model in Release 12.1
that contains the Release 12.0 Binary Symmetric Channel block, then the
Command Window might display warnings about block parameters. To
suppress these warnings in the future, simply save the model from Release
12.1.
• In the Communications Blockset 2.0.1, any model that includes a digital
passband modulator block or a digital passband demodulator block must use
a variable-step solver rather than a fixed-step solver. To configure a model so
that it uses a variable-step solver, select Simulation parameters from the
model window’s Simulation menu and then set the Type parameter on the
Solver panel to Variable-step.
See “Upgrading from an Earlier Release” on page 3-5 for upgrade issues
involved in moving from the Communications Toolbox 1.4 (Release 11) to the
Communications Blockset 2.0.1.
2-5
2
Communications Blockset 2.0.1 Release Notes
Known Software Problems
This section describes known Communications Blockset 2.0.1 software
problems.
Code Generation Limitations
Several Communications Blockset blocks are incompatible with Real-Time
Workshop. As a result, Real-Time Workshop cannot generate code for models
that include these blocks:
• Continuous-Time Eye and Scatter Diagrams block
• Multipath Rayleigh Fading Channel block
• Rician Fading Channel block
• Triggered Read from File block
• Triggered Write to File block
• Voltage-Controlled Oscillator block
• Blocks in the Analog Passband and Digital Passband sublibraries of the
Modulation library
• Blocks in the CPM sublibrary of the Digital Baseband sublibrary of the
Modulation library
Limited Frame and Matrix Support
The Communications Blockset provides limited support for matrix and
frame-based signals. In a future release, more blocks will support multichannel
behavior, and more blocks will be optimized for faster frame-based processing.
Release 12.1 strives to be forward-compatible in the sense that future signal
support modes should not invalidate current modes and should minimize the
difficulty of upgrading from Release 12.1 to a future release.
As a consequence of this view, some blocks now use strict guidelines to
determine the kinds of signals that they accept. One consideration is that if a
block will ultimately support frame-based multichannel signals, then a
sample-based vector input might potentially represent either a frame of data
from a single channel or a set of samples from multiple channels. Therefore,
even if such a block does not currently provide such comprehensive signal
support, it accepts only frame-based vectors, whose interpretation is
unambiguous.
2-6
3
Communications Blockset
2.0 Release Notes
New Features . . . . . . . . . . . .
Digital Modulation Libraries . . . . . . .
Interleaving Libraries . . . . . . . . . .
Fading Channels . . . . . . . . . . . .
Enhanced Support for Convolutional Coding
Sequence Operations . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-2
3-2
3-2
3-3
3-3
3-3
Major Bug Fixes . . . . . . . . . . . . . . . . . . 3-4
Upgrading from an Earlier Release . .
New Block Libraries in Release 12 . . . .
New Signal Support . . . . . . . . . .
Functionality Changes in Specific Blocks . .
Block Name Changes Since Previous Manual
Obsolete Blocks from Previous Manual . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-5
3-5
3-7
3-7
3-8
3-12
Known Software Problems . . . . . .
Code Generation Limitations . . . . . . .
Limited Frame and Matrix Support . . . .
Errors in Printed Version of Documentation .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-19
3-19
3-19
3-20
3
Communications Blockset 2.0 Release Notes
New Features
The Communications Blockset is a new product being introduced with Release
12. The Communications Blockset incorporates the functionality of the blocks
that were included in the Communications Toolbox 1.4 (Release 11), with the
addition of the new features summarized below.
Note The Communications Toolbox is described in a separate section.
Digital Modulation Libraries
The digital modulation libraries have been replaced with new ones. The new
libraries contain baseband and passband sublibraries for:
• Amplitude modulation (PAM, QAM)
• Phase modulation (PSK, DPSK)
• Frequency modulation (FSK)
• Continuous phase modulation (CPM), including MSK and GMSK
For a list of blocks, see the reference sections for the baseband and passband
digital modulation libraries. For a discussion of the capabilities of the new
libraries, see “Digital Modulation” in the Communications Blockset User’s
Guide.
Interleaving Libraries
A new Interleaving library contains sublibraries for block interleaving and
convolutional interleaving. These sublibraries support general block
interleavers and general multiplexed interleavers, as well as several special
cases of these. For more information, see “Interleaving” in the Communications
Blockset User’s Guide.
3-2
New Features
Fading Channels
The new Multipath Rayleigh Fading Channel and Rician Fading Channel
blocks implement baseband simulations of fading propagation channels. These
blocks model real-world mobile communication effects and are useful for
modeling mobile wireless communication systems. For more information, see
“Fading Channels” in the Communications Blockset User’s Guide.
Enhanced Support for Convolutional Coding
The new APP Decoder block implements a posteriori probability decoding. The
enhanced Convolutional Encoder and Viterbi Decoder blocks now support a
more general class of convolutional codes by accepting a trellis parameter in
their dialog boxes. The new poly2trellis function in the Communications
Toolbox supports this enhancement, by converting a polynomial description of
an encoder into a corresponding trellis description. For more information, see
“Convolutional Coding” in the Communications Blockset User’s Guide.
Sequence Operations
These new blocks in the Sequence Operations library manipulate data
sequences in various ways:
• Bit to Integer Converter and Integer to Bit Converter convert between
integers and their binary representations.
• Complex Phase Shift and Complex Phase Difference manipulate or analyze
the phase of a complex signal.
• Derepeat is an inverse of the DSP Blockset’s Repeat block.
• Interlacer and Deinterlacer can be useful for combining or separating
in-phase and quadrature components of a signal.
• Puncture and Insert Zero are useful for processing punctured codes.
3-3
3
Communications Blockset 2.0 Release Notes
Major Bug Fixes
The Communications Blockset includes several bug fixes, including
descriptions (online only) of particularly important bug fixes.
3-4
Upgrading from an Earlier Release
Upgrading from an Earlier Release
This section describes the upgrade issues involved in moving from the
Communications Toolbox 1.4 (Release 11) to the Communications Blockset 2.0.
Such issues relate to
• The new set of block libraries
• Support of new signal types, particularly frame-based signals and
two-dimensional (that is, matrix) signals
• Functionality changes in specific blocks
• Blocks from the previous Communications Toolbox User’s Guide that have
changed their names in Version 2.0 of the Communications Blockset
• Blocks from the previous Communications Toolbox User’s Guide that are not
in Version 2.0 of the Communications Blockset
Note that before Release 12, the Communications Toolbox was a collection of
functions and blocks, so that the previous Communications Toolbox User’s
Guide documented both functions and blocks. Release 12 is the first release of
the Communications Blockset as a distinct product.
New Block Libraries in Release 12
The Communications Blockset uses a new set of block libraries, although it also
includes the previous set of block libraries for backwards compatibility. The
new set of libraries is what appears in the Simulink Browser (on PC) and what
opens if you type commlib at the MATLAB prompt. You should build new
models using this new set. New blocks in the new set of libraries are described
in “New Features” on page 3-2.
Your previous models link to the previous set of libraries unless you choose to
replace individual blocks manually. You can access the previous set of libraries
by typing commlib 1.5 at the MATLAB prompt.
3-5
3
Communications Blockset 2.0 Release Notes
Reorganization of Utility Functions in New Set of Libraries
The Utility Functions library has been reorganized. The table below lists
blocks in Release 12 that were in the Release 11 Utility Functions library.
Block
New Location
Data Mapper
Utility Functions
Derepeat
Sequence Operations sublibrary
Descrambler
Sequence Operations sublibrary
Differential Decoder
Source Coding
Differential Encoder
Source Coding
Discrete Modulo Integrator
(formerly called Discrete
Time Modulo Integrator)
Integrators sublibrary
Discrete-Time VCO
Comm Sources
Windowed Integrator
Integrators sublibrary
Modulo Integrator
Integrators sublibrary
Integrate and Dump
(formerly called Scheduled
Reset Integrator)
Integrators sublibrary
Scrambler
Sequence Operations sublibrary
Voltage-Controlled Oscillator
Comm Sources
The Sequence Operations and Integrators sublibraries are in the Basic Comm
Functions library.
Some blocks from the Release 11 Utility Functions library have become
obsolete; for possible substitutions in Release 12, see “Obsolete Blocks from
Previous Manual” on page 3-12.
3-6
Upgrading from an Earlier Release
New Signal Support
As of Release 12, Simulink supports matrix signals in addition to
one-dimensional arrays, and frame-based signals in addition to sample-based
signals. The Communications Blockset processes certain kinds of matrix and
frame-based signals.
Because a future release is planned to include more comprehensive matrix and
frame support, some Release 12 blocks avoid conflict with future features by
using strict guidelines to determine the kinds of signals that they now accept.
As a consequence, if you used vector signals in a model before Release 12, then
you might need to use a particular kind of vector signal in Release 12 (such as
a frame-based column vector, a frame-based row vector, or a sample-based
vector of a particular shape or dimension).
As another consequence of frame support, the AWGN Channel and Derepeat
blocks no longer have the Frame-based inputs check box and the Number of
channels parameter as in the Communications Toolbox 1.5. Instead, these
blocks inherit the frame status and number of channels from their inputs.
The Communications Blockset User’s Guide includes more detail about signal
support. To learn the terminology associated with signal attributes, see the
Technical Conventions section. For general information about signal support
in the Communications Blockset, see the “Signal Support” section.
Functionality Changes in Specific Blocks
Aside from signal support and naming issues, some blocks have changed the
way that they behave:
• The Continuous-Time Eye and Scatter Diagrams and Discrete-Time Eye and
Scatter Diagrams blocks process complex signals, whereas their
counterparts before Release 12 (called Eye-Diagram Scatter Plot and
Sample-Time Eye-Diagram Scatter) processed real vectors that listed
in-phase and quadrature components separately.
• The blocks for Reed-Solomon and BCH coding no longer have a second input
port for an enabler signal. The change affects the Binary-Input RS Encoder,
Binary-Output RS Decoder, Integer-Input RS Encoder, Integer-Output RS
Decoder, and BCH Decoder blocks.
• The Scrambler, Descrambler, and PN Sequence Generator blocks no longer
have a trigger input. The Scrambler and Descrambler blocks no longer have
3-7
3
Communications Blockset 2.0 Release Notes
a state output. The PN Sequence Generator block produces output from the
last register in the generator, not the first.
• The Convolutional Encoder and Viterbi Decoder blocks have new interfaces
because they can now accept a more general trellis description of a
convolutional encoder.
• The Version 1.4 Error Rate Calculation block considers a vector input to be
a sample, whereas the current block considers a vector input to be a frame of
multiple samples. For vector inputs of length n, a Receive delay parameter
value of k in the Version 1.4 block is equivalent to a Receive delay of k*n in
the current block.
• The Voltage-Controlled Oscillator block now uses the cosine, not sine,
function to produce its waveform. This change affects the phase of the output
signal.
• The blocks in the Synchronization library no longer use a Gain at the output
parameter. The remaining parameters that define characteristics of the
voltage-controlled oscillator have changed slightly. Also, the Baseband PLL
and Linearized Baseband PLL blocks now include three output ports instead
of one, to match the Phase-Locked Loop and Charge Pump PLL blocks.
Block Name Changes Since Previous Manual
The table below lists the old and new names of blocks that were part of the
Communications Toolbox before Release 12 and that have changed their
names. The old names are from the last printed version of the Communications
Toolbox User’s Guide. Because the libraries have been reorganized since that
document was printed, the third column of the table lists the current library
name for each block.
Names of Blocks in Version 1.x and Version 2, Where Different
3-8
Old Block Name (Version 1.x)
New Block Name (Version 2)
Library Location
ADM with Carrier
DSB AM Demodulator
Passband
Analog Passband
ADM with Carrier CE
DSB AM Demodulator
Baseband
Analog Baseband
AM with Carrier
DSB AM Modulator Passband
Analog Passband
Upgrading from an Earlier Release
Names of Blocks in Version 1.x and Version 2, Where Different (Continued)
Old Block Name (Version 1.x)
New Block Name (Version 2)
Library Location
AM with Carrier CE
DSB AM Modulator Baseband
Analog Baseband
BCH Decode Vector In/Out
BCH Decoder
Block Codes
BCH Encode Vector In/Out
BCH Encoder
Block Codes
Baseband Model PLL
Baseband PLL
Synchronization
Bernoulli Random Binary
Noise Generator
Bernoulli Binary Generator
Comm Sources
Binary Error Channel
Binary Symmetric Channel
Channels
Cyclic Decode Vector In/Out
Binary Cyclic Decoder
Block Codes
Cyclic Encode Vector In/Out
Binary Cyclic Encoder
Block Codes
DPCM Decode
DPCM Decoder
Source Coding
DPCM Encode
DPCM Encoder
Source Coding
DSB-SC ADM
DSBSC AM Demodulator
Passband
Analog Passband
DSB ADM CE
DSBSC AM Demodulator
Baseband
Analog Baseband
DSB-SC AM
DSBSC AM Modulator
Passband
Analog Passband
DSB AM CE
DSBSC AM Modulator
Baseband
Analog Baseband
Discrete Time VCO
Discrete-Time VCO
Comm Sources
Discrete Time Modulo
Integrator
Discrete Modulo Integrator
Integrators
Eye-Pattern & Scatter Plot
Continuous-Time Eye and
Scatter Diagrams
Comm Sinks
FDM
FM Demodulator Passband
Analog Passband
3-9
3
Communications Blockset 2.0 Release Notes
Names of Blocks in Version 1.x and Version 2, Where Different (Continued)
3-10
Old Block Name (Version 1.x)
New Block Name (Version 2)
Library Location
FDM CE
FM Demodulator Baseband
Analog Baseband
FM
FM Modulator Passband
Analog Passband
FM CE
FM Modulator Baseband
Analog Baseband
Gaussian Random Noise
Generator
Gaussian Noise Generator
Comm Sources
Hamming Decode Vector In/
Out
Hamming Decoder
Block Codes
Hamming Encode Vector In/
Out
Hamming Encoder
Block Codes
Linear Block Decode Vector
In/Out
Binary Linear Decoder
Block Codes
Linear Block Encode Vector
In/Out
Binary Linear Encoder
Block Codes
Linearized Baseband Model
PLL
Linearized Baseband PLL
Synchronization
µ-Law Compressor
Mu-Law Compressor
Source Coding
µ-Law Expander
Mu-Law Expander
Source Coding
PDM
PM Demodulator Passband
Analog Passband
PDM CE
PM Demodulator Baseband
Analog Baseband
PLL
Phase-Locked Loop
Synchronization
PM
PM Modulator Passband
Analog Passband
PM CE
PM Modulator Baseband
Analog Baseband
Poisson Random Integer
Generator
Poisson Integer Generator
Comm Sources
Quantization Decode
Quantizer Decode
Source Coding
Upgrading from an Earlier Release
Names of Blocks in Version 1.x and Version 2, Where Different (Continued)
Old Block Name (Version 1.x)
New Block Name (Version 2)
Library Location
Reed-Solomon Decode Binary
Vector In/Out
Binary-Output RS Decoder
Block Codes
Reed-Solomon Decode Integer
Vector In/Out
Integer-Output RS Decoder
Block Codes
Reed-Solomon Encode Binary
Vector In/Out
Binary-Input RS Encoder
Block Codes
Reed-Solomon Encode Integer
Vector In/Out
Integer-Input RS Encoder
Block Codes
Rician Random Noise
Generator
Rician Noise Generator
Comm Sources
SSB ADM
SSB AM Demodulator
Passband
Analog Passband
SSB ADM CE
SSB AM Demodulator
Baseband
Analog Baseband
SSB-AM
SSB AM Modulator Passband
Analog Passband
SSB-AM CE
SSB AM Modulator Baseband
Analog Baseband
Sample Time Eye-Pattern
Diagram & Scatter Plot
Discrete-Time Eye and
Scatter Diagrams
Comm Sinks
Scheduled Reset Integrator
Integrate and Dump
Integrators
Signal Quantizer
Sampled Quantizer Encode
Source Coding
Triggered Signal Quantizer
Enabled Quantizer Encode
Source Coding
Uniform Random Noise
Generator
Uniform Noise Generator
Comm Sources
Uniform Random Integer
Generator
Random-Integer Generator
Comm Sources
VCO
Voltage-Controlled Oscillator
Comm Sources
3-11
3
Communications Blockset 2.0 Release Notes
Obsolete Blocks from Previous Manual
The table below lists blocks that appear in the previous version of the
Communications Toolbox User’s Guide but that are not included in the Release
12 Communications Blockset. Where applicable, the second column lists blocks
that provide similar functionality. In some cases, the similar block requires
different parameter settings, data formats, or signal attributes compared to
the original block. Therefore, you should read the documentation for the
similar block before using it in your model.
Blocks Not in v2, and Similar v2 Blocks
Obsolete Block
Similar Block(s), if Any
Array Function
See Math library in Simulink
BCH Code View Table
Use bchpoly in Communications
Toolbox
BCH Decode Sequence In/Out
BCH Decoder. See “Using Serial
Signals” in the Communications
Blockset User’s Guide
BCH Encode Sequence In/Out
BCH Encoder. See “Using Serial
Signals” in the Communications
Blockset User’s Guide
Coherent MFSK Corr Demod
Coherent MFSK Demod
Coherent MFSK Demod CE
3-12
Complex Filter
See Filtering library in DSP Blockset
Convolutional Decode Sequence
In/Out
Viterbi Decoder. See “Using Serial
Signals” in the Communications
Blockset User’s Guide
Convolutional Decode Vector In/
Out
Viterbi Decoder
Upgrading from an Earlier Release
Blocks Not in v2, and Similar v2 Blocks (Continued)
Obsolete Block
Similar Block(s), if Any
Convolutional Encode Sequence
In/Out
Convolutional Encoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
Convolutional Encode Vector In/
Out
Convolutional Encoder
Cyclic Decode Sequence In/Out
Binary Cyclic Decoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
Cyclic Encode Sequence In/Out
Binary Cyclic Encoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
DPSK Demod
M-DPSK Demodulator Passband
DPSK Mod
M-DPSK Modulator Passband
D-TDMA Demux
D-TDMA Mux
Edge Detector
Edge Detector in DSP Blockset
Envelope Detector
Maximum, Minimum in DSP Blockset
Error Counter
Counter, in DSP Blockset
Error Rate Meter
Error Rate Calculation
Hamming Decode Sequence In/
Out
Hamming Decoder. See “Using Serial
Signals” in the Communications
Blockset User’s Guide
3-13
3
Communications Blockset 2.0 Release Notes
Blocks Not in v2, and Similar v2 Blocks (Continued)
Obsolete Block
Similar Block(s), if Any
Hamming Encode Sequence In/
Out
Hamming Encoder. See “Using Serial
Signals” in the Communications
Blockset User’s Guide
Hilbert Filter
Remez FIR Filter Design in DSP
Blockset
Integer Scalar to Vector
Integer to Bit Converter
Integer Vector to Scalar
Bit to Integer Converter
Interleave
Matrix Interleaver
K-Step Delay
Integer Delay in DSP Blockset
Limited Binary Error Channel
Binary Vector Noise Generator
Linear Block Decode Sequence In/
Out
Binary Linear Decoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
Linear Block Encode Sequence
In/Out
Binary Linear Encoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
MASK Demap
MASK Demod
M-PAM Demodulator Passband
MASK Demod CE
M-PAM Demodulator Baseband
MASK Map
3-14
MASK Mod
M-PAM Modulator Passband
MASK Mod CE
M-PAM Modulator Baseband
Mean and Variance
Mean, Variance in DSP Blockset
Upgrading from an Earlier Release
Blocks Not in v2, and Similar v2 Blocks (Continued)
Obsolete Block
Similar Block(s), if Any
Mean and Std
Mean, Standard Deviation in DSP
Blockset
MFSK Map
MFSK Mod
M-FSK Modulator Passband
MFSK Mod CE
M-FSK Modulator Baseband
Min/Max Demap
Min/Max Index
Maximum, Minimum in DSP Blockset
Modulo
Math Function in Simulink
MPSK Correlation Demodulation
MPSK Demod
M-PSK Demodulator Passband
MPSK Demod CE
M-PSK Demodulator Baseband
MPSK Map
MPSK Mod
M-PSK Modulator Passband
MPSK Mod CE
M-PSK Modulator Baseband
MSK Demod
MSK Demodulator Passband
MSK Mod
MSK Modulator Passband
Noncoherent MFSK Corr Demod
Noncoherent MFSK Demod
M-FSK Demodulator Passband
Noncoherent MFSK Demod CE
M-FSK Demodulator Baseband
Number Counter
Counter, in DSP Blockset
OQPSK Demod
OQPSK Demodulator Passband
OQPSK Mod
OQPSK Modulator Passband
3-15
3
Communications Blockset 2.0 Release Notes
Blocks Not in v2, and Similar v2 Blocks (Continued)
Obsolete Block
Similar Block(s), if Any
QADM
General QAM Demodulator Passband
QADM CE
General QAM Demodulator Baseband
QAM
General QAM Modulator Passband
QAM CE
General QAM Modulator Baseband
QASK Demap Arbitrary
Constellation
QASK Demap Circle
Constellation
QASK Demap Square
Constellation
QASK Demod Arbitrary
Constellation
General QAM Demodulator Passband
QASK Demod CE Arbitrary
Constellation
General QAM Demodulator Baseband
QASK Demod CE Circle
Constellation
General QAM Demodulator Baseband
QASK Demod CE Square
Constellation
Rectangular QAM Demodulator
Baseband
QASK Demod Circle
Constellation
General QAM Demodulator Passband
QASK Demod Square
Constellation
Rectangular QAM Demodulator
Passband
QASK Map Arbitrary
Constellation
QASK Map Square Constellation
3-16
Upgrading from an Earlier Release
Blocks Not in v2, and Similar v2 Blocks (Continued)
Obsolete Block
Similar Block(s), if Any
QASK Mod Arbitrary
Constellation
General QAM Modulator Passband
QASK Mod CE Arbitrary
Constellation
General QAM Modulator Baseband
QASK Mod CE Circle
Constellation
General QAM Modulator Baseband
QASK Mod CE Square
Constellation
Rectangular QAM Modulator
Baseband
QASK Mod Circle Constellation
General QAM Modulator Passband
QASK Mod Square Constellation
Rectangular QAM Modulator
Passband
Raised Cosine Filter
Rayleigh Fading CE Channel
Multipath Rayleigh Fading Channel
Rayleigh Noise CE Channel
Rayleigh Noise Generator
Reed-Solomon Decode Binary
Sequence In/Out
Binary-Output RS Decoder. See
“Using Serial Signals” in the
Communications Blockset User’s
Guide
Reed-Solomon Decode Integer
Sequence In/Out
Integer-Output RS Decoder. See
“Using Serial Signals” in the
Communications Blockset User’s
Guide
Reed-Solomon Encode Binary
Sequence In/Out
Binary-Input RS Encoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
3-17
3
Communications Blockset 2.0 Release Notes
Blocks Not in v2, and Similar v2 Blocks (Continued)
Obsolete Block
Similar Block(s), if Any
Reed-Solomon Encode Integer
Sequence In/Out
Integer-Input RS Encoder. See “Using
Serial Signals” in the
Communications Blockset User’s
Guide
Register Shift
Queue in DSP Blockset
Rician Noise CE Channel
Rician Noise Generator
Sampled Read From Workspace
Signal From Workspace in DSP
Blockset
Sinc
Time-Share Demux
Time-Share Mux
Triggered Read from Workspace
Triggered Signal From Workspace in
DSP Blockset
Triggered Write to Workspace
Triggered To Workspace in DSP
Blockset
Varying AWGN Channel
Varying Rayleigh Fading CE
Channel
Varying Rayleigh Noise CE
Channel
Varying Rician Noise CE Channel
Vector Pulse
Vector Redistributor
3-18
Discrete Pulse Generator in Simulink
Known Software Problems
Known Software Problems
This section describes known Communications Blockset 2.0 software problems.
Code Generation Limitations
Several blocks are incompatible with Real-Time Workshop. As a result,
Real-Time Workshop cannot generate code for models that include these
blocks:
• Discrete-Time Eye and Scatter Diagrams block
• Continuous-Time Eye and Scatter Diagrams block
• Voltage-Controlled Oscillator block
• Multipath Rayleigh Fading Channel block
• Rician Fading Channel block
• Blocks in the Analog Passband and Digital Passband sublibraries of the
Modulation library
• Blocks in the CPM sublibrary of the Digital Baseband sublibrary of the
Modulation library
Furthermore, blocks in the Analog Passband sublibrary of the Modulation
library are not compatible with the Simulink Accelerator.
Limited Frame and Matrix Support
The Communications Blockset provides limited support for matrix and
frame-based signals. In a future release, more blocks will support multichannel
behavior, and more blocks will be optimized for faster frame-based processing.
Release 12 strives to be forward-compatible in the sense that future signal
support modes should not invalidate current modes and should minimize the
difficulty of upgrading from Release 12 to a future release.
As a consequence of this forward-looking view, some blocks now use strict
guidelines to determine the kinds of signals that they accept. One
consideration is that if a block will ultimately support frame-based
multichannel signals, then a sample-based vector input might potentially
represent either a frame of data from a single channel or a set of samples from
multiple channels. Therefore, even if such a block does not currently provide
3-19
3
Communications Blockset 2.0 Release Notes
such comprehensive signal support, it accepts only frame-based vectors, whose
interpretation is unambiguous.
3-20