Mathworks SIMULINK FIXED POINT RELEASE NOTES

Simulink
®
Fixed Point™
Release Notes
How to Contact The MathWorks
www.mathworks. comp.soft-sys.matlab Newsgroup www.mathworks.com/contact_TS.html Technical Support
suggest@mathworks.com Product enhancement suggestions
bugs@mathwo doc@mathworks.com Documentation error reports service@mathworks.com Order status, license renewals, passcodes
info@mathwo
com
rks.com
rks.com
Web
Bug reports
Sales, prici
ng, and general information
508-647-7000 (Phone)
508-647-7001 (Fax)
The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098
For contact information about worldwide offices, see the MathWorks Web site.
®
Simulink
© COPYRIGHT 2002–20 10 by The MathWorks, Inc.
The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or reproduced in any form without prior written consent from The MathW orks, Inc.
FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by, for, or through the federal government of the United States. By accepting delivery of the Program or Documentation, the government hereby agrees that this software or documentation qualifies as commercial computer software or commercial computer software documentation as such terms are used or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern theuse,modification,reproduction,release,performance,display,anddisclosureoftheProgramand Documentation by the federal government (or other entity acquiring for or through the federal government) and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the government’s needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Docu mentation, unused, to The MathWorks, Inc.
Trademarks
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See
www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand
names may be trademarks or registered trademarks of their respective holders.
Patents
The MathWorks products are protected by one or more U.S. patents. Please see
www.mathworks.com/patents for more information.
Fixed Point™ Release Notes
Summary by Version ............................... 1
Contents
Version 6.3 (R2010a) Simulink
Software
........................................ 4
Version 6.2 (R2009b) Simulink
Software
........................................ 10
Version 6.1 (R2009a) Simulink
Software
........................................ 18
Version 6.0 (R2008b) Simulink
Software
........................................ 24
®
®
®
®
Version 5.6.1 (R2008a+) Simulink
Software
Version 5.6 (R2008a) Simulink
Software
........................................ 30
®
........................................ 31
Version 5.5.1 (R2007b+) Simulink
Software
........................................ 33
Fixed Point
Fixed Point
Fixed Point
Fixed Point
®
Fixed Point
Fixed Point
®
Fixed Point
Version 5.5 (R2007b) Simulink
Software
........................................ 34
®
Version 5.4.1 (R2007a+) Simulink
Software
Version 5.4 (R2007a) Simulink
Software
Version 5.3 (R2006b) Simulink
Software
........................................ 37
®
........................................ 38
®
........................................ 39
Fixed Point
®
Fixed Point
Fixed Point
Fixed Point
iii
Version 5.2.1 (R2006a+) Simulink®Fixed Point
Software
........................................ 40
Version 5.2 (R2006a) Simulink
Software
........................................ 41
Version 5.0 (R14) Simulink
®
Fixed Point
®
Fixed Point Software .... 43
Version 4.1 (R13SP1) Fixed-Point Blockset Software
Version 4.0.1 (R13+) Fixed-Point Blockset Software
Version 4.0 (R13) Fixed-Point Blockset Software
Compatibility Summary for Simulink
Software
........................................ 66
®
Fixed Point
..... 61
.. 55
... 58
iv Contents
SummarybyVersion
This table provides quick access to what’s new in each version. For clarification, see “Using Release Notes” on page 2 .
Simulink®Fixed Point™ Release Notes
Version (Release)
Latest Versi V6.3 (R2010a
V6.2 (R2009b)
V6.1 (R2009a)
V6.0 (R2
V5.6.1 (R2008a+)
V5.6 (R2008a)
1 (R2007b+)
V5.5.
V5.5 (R2007b)
on
)
008b)
New Features and Changes
Yes Details
Yes Details
Yes Details
Yes Details
No No Bug Reports
Yes
ls
Detai
No No Bug Reports
Yes Details
Version Compatibilit Consideratio
No Bug Reports
No Bug Reports
Yes Summary
Yes Summary
No Bug Re
Yes Summary
y
ns
Fixed Bugs and Known Problems
Includes fix
Includes fixes
Bug Repor Includes
Bug Reports Includes fixes
Includes fixes
Inclu
Includes fixes
Bug Reports Includes fixes
ts
fixes
ports
des fixes
Related Documentation at Web Site
Printable Release
es
Notes: PDF
Current product documentation
No
No
No
No
No
No
No
V5.4.1 (R2007a+)
.4 (R2007a)
V5
V5.3 (R2006b)
No No Bug
Inc
Yes Details
Yes Details
No Bug Reports
Includes fixes
No Bug Reports No
Reports
ludes fixes
No
No
1
Simulink®Fixed Point™ Release Notes
Version (Release)
V5.2.1 (R2006a+)
V5.2 (R2006a)
V5.0 (R14)
V4.1 (R13SP1)
V4.0.1 (R13+)
V4.0 (R13)
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs and Known Problems
Related Documentation at Web Site
No
at Web site
Yes Details
Yes Details
Yes Details
Yes Details
Yes Details
No Bug Reports
at Web site
Yes Summary
Yes Details
No Yes
Details
Yes
Fixed b ugs
Summary
Yes
No bug fixes
Summary
No
No
No
No
No
Using Release Notes
Use release notes when upgrading to a newer version to learn about:
New features
Changes
Potential impact on your existing files and practices
Review the release notes for other MathWorks™ products required for this product (for example, MATLAB
®
or Simulink®). Determine if enhancements,
bugs, or compatibility considerations in other products impact you.
If you are upgrading from a software version other than the m ost recent one, review the current release notes and all interim versions. For example, when you upg rade from V1.0 to V1.2, review the release notes for V1.1 and V1.2.
2
SummarybyVersion
What Is in the Rel
New Features and
New functional
Changes to exi
Version Compa
When a new fea versions, th impact.
Compatibil Reports at in incompa compatibi
Fixed Bug
The Math view Bug time and provisi availa is not a
ity issues reported after the product release appear under Bug The MathWorks™ W eb site. Bug fixes can sometimes result tibilities, so review the fixed bugs in Bug Reports for any
lity impact.
sandKnownProblems
Works offers a user-searchable Bug Reports database so you can Reports. The development team updates this database at release as more information becomes available. Bug Reports include
ons for any known workarounds or file replacements. Information is
ble for bugs existing in or fixed in Release 14SP2 or later. Information
vailable for all bugs in earlier releases.
ity
sting functionality
tibility Considerations
ture or change introduces a reported incompatibility between
e Compatibility Considerations subsection explains the
ease Notes
Changes
s Bug Reports using your MathWorks Account.
Acces
3
Simulink®Fixed Point™ Release Notes
Version 6.3 (R2010a) Simulink Fixed Point Software
This table summarizes what’s new in Version 6.3 (R2010a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are
“Trigonometric Function Block Supports CORDIC Algorithm and
Fixed-Point Signals” on page 5
“Elimination of Double-Precision Conversions for Algorithms that M ix
Single P recis ion with Integer or Fixed-Point Data” on page 5
“Improved Automatic Scaling Handles Data Type Constraints for Several
Simulink Blocks” on page 5
“Direct Lookup Ta bl e (n-D) Block Supports Fixed-Point Signa ls” on pa ge 6
“Increased Efficiency of Division by Constant Pow er of 2” on page 6
“Fixed-Point Advisor Supports Restore Points” on page 6
“Improved Fixed-Point Advisor Handling of Unsupported Blocks” on page 7
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
“Enhanced Target Function Library Support” on page 7
“Stateflow Support for Chart-Level Data with Fixed-Point Word Lengths
Up to 128 Bits” on page 8
“Root Inport Support for Fixed-Point Data Contained in a Structure” on
page 8
“To File and From File Blocks Support Fixed-Point Data” on page 9
4
Version 6.3 (R2010a) Simulink®Fixed Point™ Software
Trigonometric F Algorithm and Fi
The Trigonometr signals when yo is CORDIC.
u select
Elimination o Algorithms t Fixed-Point
In R2010a, c unnecessar intermedia
Results in
Enables si
arithmet
Improve Constra
Autosc data ty autosc
asting from single to fixed-point data types no longer inserts
y intermediate double-precision variables. Removing these
te variables:
more efficient code, particularly for embedded targets.
ngle to fixed-point casts for targets without double-precision
ic support.
d Automatic Scaling Handles Data Type
ints for Several Simulink Blocks
aling with the Fixed-Point Tool and Fixed-Point A dvisor now handles
pe constraints for ports on several Simulink blocks. For example,
aling now takes into account that:
unction Block Supports CORDIC
xed-Point Signals
ic Function block now accepts and outputs fixed-point
sin, cos,orsincos and the approximation method
f Double-Precision Conversions for
hat Mix Single Precision with Integer or
Data
The in
singl
The i
data
The i
dat
Thi the
formation when you accept autoscaling proposals. For more information,
in
dex port of the Selector and Assignment blocks support only
e
, and built-in integer data types.
nput port of the Data Type Conversion supports only built-in integer types when the block is configured to output an enumerated type.
ndex port of the Interpolation Using Prelookup supports only integer
atypes.
s improved autoscaling reduces data type mismatch errors and enables
Fixed-Point Tool and Fixed-Point Advisor to provide additional diagnostic
double,
5
Simulink®Fixed Point™ Release Notes
see “Constrained Data Type Summary” in the Simulink®Fixed Point™ User’s Guide.
Direct Lookup Table (n-D) Block Suppor ts Fixed-Point Signals
The Direct Lookup Table (n-D) block accepts fixed-point data types for the table input port.
Increased Efficiency of Division by Constant Power of 2
In R2010a, the Real-Time Workshop®software no longer unconditionally replaces divisions by constant power of 2 with casts. The software now replaces division by constant power of 2 with a cast only if this replacement results in less generated code. This enhancement relies on the target compiler to optimiz e the division appropriate to the target processor.
The decision whether to replace the division is based on these guidelines:
If the replacement by a cast results in extra rou n ding code, Real-Time
Workshop does not replace the division.
If the division requires a helper function, Real-Time Workshop replaces the
division with a cast even if the cast requires extra rounding code.
For more information, see “Improving Efficiency of Code That Uses Division by Constant Power of 2” in the Real-Time Workshop U ser’s Guide.
Fixed-Point Advisor Supports Restore Points
The Fixed-Point Advisor now supports restore points. Restore points provide you with the ability to:
Save a snapshot of your model at any time during conversion from floating
point to fixed point.
Revert any changes made in response to advice from the Fixed-Point
Advisor.
6
Version 6.3 (R2010a) Simulink®Fixed Point™ Software
Load and rerun from any restore point without the need to run through the
entire conversion process.
For more information, see “Restore Points” in the Simulink Fixed Point User’s Guide.
Improved Fixed-Point Advisor Handling of Unsupported Blocks
The Fixed-Point Advisor now provides:
A wired-subsystem replacement for the State-Space block.
A preview of the replacement options for an unsupported block, when
available.
A new context menu option to replace an unsupported block.
For more information, see “Address unsupported blocks” in the Fixe d-Point Advisor Reference.
Enhanced Target Function Library Support
Target Function Library enhancements include:
Ability to create custom Target Function Library entries
TFLs now support custom entries that allow you to specify near-arbitrary match criteria. You first create your own TFL entry class, derived from either
RTW.TflCOperationEntryML (for operation replacement). In y our derived
class, you implement a customize the match criteria. You also can modify the implementation signature to meet your application needs. For more information, see “Refining TFL Matching and Replacement Using Custom TFL Table Entries” in the Real-Time Workshop
Additional scalar operator replacemen ts
RTW.TflCFunctionEntryML (for function replacement) or
do_match method with a fixed preset signature a nd
®
Embedded Coder™ documentation.
- New TFL support for replacing scalar complex operations, including
addition, subtraction, multiplication, cast, and complex conjugate. Mixed types are supported.
7
Simulink®Fixed Point™ Release Notes
- Additionally, y ou can now replace fixed-point shift right for all
fixed-point input types.
Stateflow Support for Chart-Level Data with Fixed-Point Word Lengths Up to 128 Bits
Stateflow®chart-level data now support up to 128 bits of fixed-point precision for the following scopes:
Input
Output
Parameter
Data Store Memory
This increase in maximum precision from enhancements:
Supports generating efficient code for targets with non-standard word sizes
Allows charts to work with large fixed-point signals
You can explicitly pass chart-level data with these fixed-point word lengths as inputs and outputs of the following functions:
Embedded MATLAB
Simulink functions
Truth table functions that use Embedded MATLAB action language
For more information, see “Using Fixed-Point Data in Stateflow Charts” in the Stateflow and Stateflow
®
functions
®
Coder™ User’s Guide
32 to 128 bits provides these
Root Inport Support for Fixed-Point Data Contained in a Structure
You can now use a root (top-level) Inport block to supply fixed-point data that is contained in a structure. In releases before R2010a, you had to use a
Simulink.Timeseries object instead of a structure.
8
Version 6.3 (R2010a) Simulink®Fixed Point™ Software
To File and From F
TheToFileandFr length of up to
om File blocks now support fixed-p oin t data with a word
bits.
32
ile Blocks Support Fixed-Point Data
9
Simulink®Fixed Point™ Release Notes
Version 6.2 (R2009b) Simulink Fixed Point Software
This table summarizes what’s new in Version 6.2 (R2009b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are
“Discrete Transfer Function Block Supports Fixed-Point Intrinsically” on
page 11
“New PID Controller Blocks Support Fixed-Point Intrinsically” on page 11
“Rapid Accelerator Mode Now Supports All Fixed-Point Word Leng ths
for Parameters” on page 11
“Lookup Table (n-D) Block Supports Parameter Data Types Different from
Signal Data Types” on page 11
“Reduced Memory Use and More Efficient Code for Evenly-Spaced
Breakpoints in Prelookup and Lookup T able (n-D) Blocks” on page 12
“Math Function Block Enhancements for Real-Time Workshop Code
Generation” on page 13
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
10
“Improved Fixed-Point Advisor Workflow” on page 13
“New Optimization Option to Allow Integer Division to Handle Net Slopes
that are Reciprocals of Integers” on page 13
“Enhanced Model Advisor Check Identifies Opportunities to Improve Code
Efficiency” on page 14
“New Diagn osti c Controls to Detect Precision Loss in Fixed-Point
Constants” on page 14
Version 6.2 (R2009b) Simulink®Fixed Point™ Software
“Synchronized Zooming for Fixed-Point Tool Time Series Difference Plot”
on page 14
“Changes in Text and Visibility of Dialog Box Prompts for Easier Use with
Fixed-Point Advisor and Fixed-Point Tool” on page 15
“New and Enhanced Demos” on page 17
“Function Being R emo ved in a Future Version” on page 17
Discrete Transfer Functio n Block Supports Fixed-Point Intrinsically
The Dis crete Transfer Fcn block now accepts and outputs fixed-point signals.
New PID Controller Blocks Support Fixed-Point Intrinsically
In discrete-time, the new PID Controller and PID Controller (2 DOF) blocks accept real signals of any numeric data type supported by Simulink software, including fixed-point data types.
Rapid Accelerator Mode Now S upports All Fixed-Point Word Lengths for Parameters
Rapid Accelerator mode now supports fixed-point parameters up to 128 bits. To learn more about fixed-point considerations when accelerating your Simulink models, see “Accelerator and Rapid Accelerator Mode Data Type Considerations” in the Simulink User’s Guide.
Lookup Table (n-D) Block Supports Parameter Data Types Different from Signal Data Types
The Lookup Table (n-D) block supports breakpoint data types that differ from input data types. This enhancement provides these benefits:
Lower memory requirement for storing breakpoint data that uses a smaller
type than the input signal
Sharing of prescaled breakpoint data between two Lookup Table (n-D)
blocks with different input data types
11
Simulink®Fixed Point™ Release Notes
Sharing of custom storage breakp oint data in Real-Time Work sh op
generated code for blocks with different i nput data types
The Lookup Table (n-D) block supports table data types that differ from output data types. This enhancement provides these benefits:
Lower memory requirement for storing table data that uses a smaller type
than the output signal
Sharing of prescaled table data between two Lookup Table (n-D) blocks
with different output data types
Sharing of custom storage table data in Real-Time Workshop generated
code for blocks with different output data types
The Lookup Table (n-D) block also supports separate data type specification for intermediate results. This enhancement enables use of a higher precision for internal computations than for table data or output data.
Reduced Memory Use and More Efficient Code for Evenly-Spaced Breakpoints in Prelookup and Lookup Table (n-D) Blocks
For the Prelookup and Lookup Table (n-D) blocks, Real-Time Workshop generated code now stores only the first breakpoint, spacing, and number of breakpoints when:
12
The breakpoint data is n ot tunable.
The index search method is
This enhancement reduces memory use and provides faster code execution. Previously, the code stored all breakpoint values in a set, regardless of the tunability or spacing of the breakpoints.
The following enhancements also provide more efficient code for the two blocks:
Evenly spaced points.
Version 6.2 (R2009b) Simulink®Fixed Point™ Software
Block
Lookup Table (n-D) Removal of unnecessary bit shifts for
Prelookup and Lookup Table (n-D) Use of simple division instead of
Enhancement for Code Efficiency
calculating the fraction
computationally-expensive function calls for calculating the index and fraction
Math Function Block Enhancem ents for Real-Time Workshop Code Generation
The Math Function b lock now supports Real-Time Workshop code generation for fixed-point data types with fractional slope and non ze ro bias for the
magnitude^2, square,andreci pro cal functions.
Improved Fixed-Point Advisor Workflow
In R2009b, the new Fixed-Point Advisor workflow helps you convert your floating-point Simulink model to a fixed-point model more quickly and efficiently. You can now complete your first iteration through the conversion process without accepting all the recommendations. The new workflow ensures that you convert the entire model b efore preparing the model for code generation. For more information, see “Tutorial: Converting a Model from Floating- to Fixed-Point” and “Fixed-Point Advisor Reference” in the Simulink Fixed Point User’s Guide.
New Optimization Option to Allow Integer Division toHandleNetSlopesthatareReciprocalsofIntegers
R2009b introduces a new optimization parameter, Use integer division to handle net slopes that are reciprocals of integers.Whenachange
of fixed-point slope is not a power of two, net slope correction is necessary. Normally, net slope correction use s an integer multiplication followed by shifts. Enabling this new optimization replaces the multiplication and shifts with an integer division under certain sim plicity and accuracy conditions. For more information, see “Use integer division to handle net slopes that are reciprocals of integers” in the Simulink Graphical User Interface.
13
Simulink®Fixed Point™ Release Notes
Enhanced Model Advisor Check Identifies Opportunities to Improve Code Efficiency
The Model Advisor Identify questionable fixed-point operations check can:
ProvideadviceonwhentousethenewUse integer division to handle
netslopesthatarereciprocalsofintegersoptimization parameter
For more information, see “Use integer division to h andle net slopes that are reciprocals of integers” in the Simulink Graphical User Interface.
Identify opportunities to improve efficiency of generated code for Lookup
Table(n-D)blocksinthefollowingcases:
Breakpoint Spacing Index Search Method
Uneven Not Evenly spaced points
Even, power of 2
Not
Evenly spaced points
Even, not power of 2
For more information, see “Identify questionable fixed-point operations” in the Real-Time Workshop Reference.
Not Evenly spaced points
Evenly spaced points
New Diagnostic Controls to Detect Precision Loss in Fixed-Point Constants
You can now enable the detection of precision loss in net slope and net bias correction. If you enable these diagnostics, the software alerts you when precision loss occurs. It also provides information about the original fixed-point constant value and the error introduced due to quantization or saturation. For more information, see “Detect underflow”, “D etect overflow”, and “Detect precision loss” in the Simulink Graphical User Interface.
Synchronized Zooming for Fixed-Point Tool Time Series Difference Plot
The Fixed-Point Tool now p rovides synchronized zooming for the Time Series Difference (A-R) plot. By default, zooming on either the
Active and
14
Version 6.2 (R2009b) Simulink®Fixed Point™ Software
Reference plot or the Difference plot now zooms both plots. For more
information, see “Plot Interface” in the Simulink Reference.
Changes in Text and Vis ibility of Dialog Box Prompts for Easier Use with F ixed-Point Advisor and Fixed-Point Tool
The Lock output scaling against changes by the autoscaling tool check box is now Lock output data type setting against changes by the fixed-point tools. Previously, this check box was visible only if you entered an expression or a fixed-point data type for the output, such as
fixdt(1,16,0). This check box is now visible for any output data type
specification. This enhancement enables you to lock the current data type settings on the dialog box against changes that the Fixed-Point Advisor or Fixed-Point Tool chooses.
Which blocks are enhanced?
This enhancement applies to the following blocks:
Abs
Constant
Data Store Memory
Data Type Conversion
Difference
Discrete Derivative
Discrete-Time Integrator
Divide
Dot Product
Fixed-Point State-Space
Gain
Inport
Lookup Table
15
Simulink®Fixed Point™ Release Notes
Lookup Table (2-D)
Lookup Table Dynamic
Math Function
MinMax
Multiport Switch
Outport
Prelookup
Product
Product of Elements
Relay
Repeating Sequence Interpolated
Repeating Sequence Stair
Saturation
16
Saturation Dynamic
Signal Specification
Switch
The Lock scaling against changes by the autoscaling tool check box is now Lock data type settings against changes by the fixed-point tools. Previously, this check box was visible only if you entered an expression or a fixed-point data type, such as
fixdt(1,16,0). This check box is now
visible for any data type specification. This enhancement enables you to lock the current data type settings on the dialog box against changes that the Fixed-Point Advisor or Fixed-Point Tool chooses.
Which blocks are enhanced?
This enhancement applies to the following blocks:
Discrete FIR Filter
Interpolation Using Prelookup
Version 6.2 (R2009b) Simulink®Fixed Point™ Software
Lookup Table (n-D)
Sum
Sum of Elements
New and Enhanced Demos
Thefollowingdemoshavebeenadded:
Demo...
Fault-tolerant Fuel Control System
Shows How You Can...
Perform a floating-point and a fixed-point simulation of a fuel rate control system designed using Simulink and Stateflow.
Function Being Removed in a Future Version
This function will be removed in a future version of Simulink Fixed Point software.
Function Name
fixpt_instrument_purge
What Happens When You Use This Function?
Still works in R2009b
Compatibility Considerations
None
17
Simulink®Fixed Point™ Release Notes
Version 6.1 (R2009a) Simulink Fixed Point Software
This table summarizes what’s new in Version 6.1 (R2009a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. Se e also Summary.
New features and changes introduced in this version are
“Discrete Filter Block Supports Fixed-Point Data Types” on page 19
“Prelookup and Interpolation Usin g Prelookup Blocks Support Parameter
DataTypesThatAreDifferentfromSignalDataTypes”onpage19
“Lookup Table (n-D) and Interpolation Using Prelookup Blocks Pe rfo rm
Efficient Fixed-Point Interpolations” on page 20
“Autoscaling for Simulink Signal Objects is Supported by Fixed-Point
Advisor and Fixed-Point Tool” on page 20
“Rounding Modes Convergent and Round Added to Multiple Blocks” on
page 21
“Simplest Rounding Mode Added to Multiple Blocks” on page 21
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
18
“Multiword Generated Code Enhancements” on page 21
“Fixed-Point Tool Provides the Ability to Narrow Down Displayed Results
Using Filtering Controls” on page 22
“MinMax Block Performs More Efficient and Accurate Comparison
Operations” on page 22
“New and Enhanced Demos” on page 22
Version 6.1 (R2009a) Simulink®Fixed Point™ Software
Discrete Filter
The Discrete Fil types.
In this release Filter block:
Improved nume
reducing the
Support for v
Support for
AnewInitia
AnewLeadi
more effic denominat
Prelooku Support P from Sig
The Prel data typ
ookup block supports breakpoint data types that differ from input
es. This enhancement provides these benefits:
ter block now offers support for fixed-point and integer data
, the following enhancements have been made to the Discrete
number of divide operations in the filter to at m ost one
ector and matrix inputs
inputs with mixed complexity
l states parameter allows you to enter n on zero initi al states
ng denominator coefficient equals 1 parameter provides a
ient implementation by eliminating all divides when the leading
or coefficient is one
p and Interpolation Using Prelookup Blocks
arameter Data Types That Are Different
nal Data Types
Block Supports Fixed-Point Data Types
rics and run-time performance of outputs and states by
Enable
smalle
Enabl
block
Enabl
gene
The I from
Ena
sma
s lower memory requirement for storing breakpoint data that uses a
r type than the input signal
es sharing of prescaled breakpoint data between two Prelookup
s with different input data types
es sharing of custom storage breakpoint data in Real-Time Workshop
rated code for blocks with different input data types
nterpolation Using Prelookup block supports table data types that differ output data types. This enhancement provides these benefits:
bles lower memory requirement for storing table data that uses a ller type than the output signal
19
Simulink®Fixed Point™ Release Notes
Enables sharing of prescaled table data between two Interpolation Using
Prelookup blocks with different output data types
Enables sharing of custom storage table data in Real-Time Workshop
generated code for blocks with different output data types
The Interpolation Using Prelookup block also supports separate data type specification for intermediate resu lts. This enhancement enables use of a different precision for internal computations than for table data or output data.
Lookup Table (n-D) and Interpolation Using Prelookup Blocks Perform Efficient Fixed-Point Interpolations
Whenever possible, Lookup Table (n-D) and Interpolation Using Prelookup blocks use a faster overflow-free subtraction algorithm for fixed-point interpolation. To achieve this efficiency, the blocks use a data type of larger containersizetoperformtheoverflow-free subtraction, instead of using control-flow branches as in previous releases. Also, Real-Time Workshop generated code for fixed-point interpolation is now smaller.
20
Compatibility Considerations
Duetothechangeintheoverflow-freesubtraction algorithm, fixed-point interpolation in Lookup Table (n-D) and Interpolation Using Prelookup blocks might, in a few cases, introduce different rounding results from previous releases. Both simulation and code generation use the new overflow-free algorithm, so they have the same rounding behavior and provide bit-true consistency.
Autoscaling for Simulink Signal Objects is Supported by Fixed-Point Advisor and Fixed-Point Tool
In this release, Fixed-Point Advisor and Fixed-Point Tool can propo se new scaling for Simulink signal objects in the base or model workspace. If you accept the proposed scaling, Fixed-Point Advisor or Fixed-Point Tool will apply the new scaling to the Simulink signal objects automatically.
Version 6.1 (R2009a) Simulink®Fixed Point™ Software
For more information, see “Automatic Scaling Tools” in the Simulink Fixed Point documentation.
Rounding Modes Convergent and Round Added to Multiple Blocks
Rounding modes Convergent and Round were added to multiple Simulink, Communications Blockset™, Signal Processing Blockset™ , and Video and Image Processing Blockset™ blocks. The introduction of these rounding modes allows numerical agreement with advanced embedded hardware and MATLAB.
For more information, see “Rounding Mode: Convergent” and “Rounding Mode: Round” in the Simulink Fixed Point documentation.
Compatibility Considerations
If you use an earlier version of Simulink to open a model that uses the
Convergent or Round rounding modes, the software automatically changes
theroundingmodeto
Nearest.
Simplest Rounding Mode Added to M ultiple Blocks
The Simplest rounding mode was added to multiple Simulink, Communications Blockset, Signal Processing Blockset, and Video and Image Processing Blockset blocks. Support for this rounding mode maximizes efficiency for blocks handling mixtures of floating point an d fixed point.
For more information, see “Rounding Mode: Simplest” in the Simulink Fixed Point documentation.
Multiword Generated Code Enhancements
More Efficient Reuse of Temporary Variables
A reduction in the number of temporary variables and reorganization of function signatures provide more efficient multiword cod e. This results in faster execution speeds and reduced memory usage. In addition, the new code compiles faster and is easier to ins pect manually.
21
Simulink®Fixed Point™ Release Notes
Support for Real-Time Workshop Embedded Coder Code Control Features
More Real-Time Workshop Embedded Coder code control features n ow apply to multiwo rd functions. These features provide the ability to customize your code, for example, you can customize the code style.
Fixed-Point Tool Provides the Ability to Narrow Down Displayed Results Using Filtering Controls
In this release, the Fixed-Point Tool provides a results filter in the toolbar which specifies the type of results to display. You can use the filter to focus on the types of results that you are interested in at different stages of the autoscaling workflow. Filter options include:
All results
Signal Logging results
Min/Max results
22
Overflows
Conflicts with proposed data types
Groups that must share the same data type
For more information, see
fxptdlg in the Simulink Reference.
MinMax Block Performs More Efficient and Accurate Comparison Operations
For multiple inputs with mixed floating-point and fixed-point data types, the MinMax block selects an appropriate data type for performing comparison operations, instead of using the output data type for all comparisons, as in previous releases. This enhancement provides these benefits:
Faster comparison operations, with fewer fixed-point overflows
Smaller size of Real-Time Workshop generatedcodefortheMinMaxblock
New and Enhanced Demos
The following demo has been added:
Version 6.1 (R2009a) Simulink®Fixed Point™ Software
Demo...
Multiword Code Generation
Shows How You Can...
Use Real-Time Workshop to convert wide integer and fixed-point operations to multiword C code.
23
Simulink®Fixed Point™ Release Notes
Version 6.0 (R2008b) Simulink Fixed Point Software
This table summarizes what’s new in Version 6.0 (R2008b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. Se e also Summary.
New features and changes introduced in this version are
“Limit of Bits Increased with Embedded MATLAB Function Block” on
page 25
“Limit of Bits Increased with Accelerated Simulation” on page 25
“Limit of Bits Increased with Code Generation” on page 25
“Fixed-Point Advisor Enhanced” on page 25
“Generated Code Enhancement” on page 25
“Parameter to Lock Output Scaling Added to Six Simulink Blocks” on
page 26
““What’s This?” Context-Sensitive Help Available for Fixed-Point Tool”
on page 26
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
No
24
“Enhanced Support for Stateflow Charts in the Fixed-Point Tool” on page 27
“Cell Array No Longer Created When Data Logging Is Enabled in the
Fixed-PointTool”onpage27
“Name Change for Associated Parameters” on page 28
“Functions Being Removed in a Future Version” on page 29
Version 6.0 (R2008b) Simulink®Fixed Point™ Software
Limit of Bits I ncreased with Embedded MATLAB Function Block
Replacement of Embedded MATLAB Function block limit of 32 bits with standard block limit of 128 bits.
Limit of Bits Increased with Accelerated Simulation
Replacement of accelerated simulation limit of 32 bits with norm al simulation limit of 128 bits.
Limit of Bits Increased with Code Generation
Replacement of code-generation limit of 32 bits with simulation limit of 128 bits.
Fixed-Point Advisor Enhanced
In R2008b, the Fixed-Point Advisor is enhanced with:
Improved usability including more descriptive results and intuitive table
formatting.
Improved analysis such as the ability to regenerate si mulation data in
Create simulation reference data.
Direct links from the Fixed-Point Advisor to the Fixed-Point Tool for
improved analysis after the conversion is complete.
A system selector that allows you to choose the system level from which to
start the Fixed-Point Advisor.
For more information, see “Fixed-Point Advisor” in the Simu link Fixed Point documentation.
Generated Code Enhancement
In R2008b, code generation is enhanced to remove excess saturation logic code, reducing RAM and ROM, improving code efficiency.
25
Simulink®Fixed Point™ Release Notes
Parameter to Loc Simulink Blocks
For the followin lock scaling of
Constant
Data Store Mem
Inport
Outport
Relay
Signal Spec
For more in
Simulink R
“What’s T Fixed-Po
R2008b i that app detaile find th
ntroduces “What’s This?” context-sensitive help for parameters
ear in the Fixed-Point Tool. This feature provides quick access to a d description of the parameters, saving you the time it would take to e information in the Help browser.
g Simulink blocks, the dialog box now displays a parameter to
outputs against changes by the autoscaling tool:
ory
ification
formation about these blocks, see “Block Reference” in the
eference.
his?” Context-Sensitive Help Available for
int Tool
k Output Scaling Added to Six
26
To use t
1 Place
2 Right-click. A What’s This? context menu appears.
he "What’s This?" help:
your cursor over the label of a parameter.
For example, the following figure shows the What’s This? context menu appearing after right-clicking the Percent safety margin (e.g. 10 for 10%) parameter.
Version 6.0 (R2008b) Simulink®Fixed Point™ Software
3 Click What’s This? A context-sensitive help window appears showing a
description of the parameter.
Enhanced Support for Stateflow Charts in the Fixed-Point Tool
You can now control the signal logging of a Simulink subsystem placed inside a Stateflow chart from the subsystem parent node.
Cell Array No Longer Created When Data Logging Is Enabled in the Fixed-Point Tool
In R2008b, the cell array FixPtSimRanges is no longer created automatically in the MATLAB workspace after simulation of a model where data logging is enabled in the Fixed-Point Tool.
Compatibility Considerations
Previously, simulating a model with logging enabled in the Fixed-Point Tool would store maximum values, minimum values, and overflow data in the workspace variable However, you can still view this information in one of these ways:
FixPtSimRanges. In R2008b, this behavior has changed.
In the Contents pane of the Fixed-Point Tool
In the MATLAB Command Window by calling the function
showfixptsimranges
If...
Youdonotusescriptstomanipulate the data stored in
You use scripts to manipulate the data stored in
For example, suppose you have a script as follows:
global FixPtSimRanges outputMaxForBlock1 = FixPtSimRanges{1}.MaxValue; outputMinForBlock1 = FixPtSimRanges{1}.MinValue;
FixPtSimRanges
FixPtSimRanges
Then...
Youhavenobackward incompatibility
Youmustaddafunctioncallto
showfixptsimranges in your scripts
27
Simulink®Fixed Point™ Release Notes
pathForBlock1 = FixPtSimRanges{1}.Path;
In R2008b, you must add a line to the script:
global FixPtSimRanges showfixptsimranges('quiet'); outputMaxForBlock1 = FixPtSimRanges{1}.MaxValue; outputMinForBlock1 = FixPtSimRanges{1}.MinValue; pathForBlock1 = FixPtSimRanges{1}.Path;
For more information about showfixptsimranges,seeshowfixptsimranges in the Simulink Fixed Point Function Reference.
Name Change for Associated Parameters
The Associated parameters in the Autoscale Information dialog box are now Model-Required parameters. Specifically, the Shared Associated
Parameter Initial Value Max parameter is now Shared Model-Required Maximum and Associated Parameter Initial Value Max is Model-Required Maximum. The names of the minimum values have
changed in the same manner. For more information, see “Examining Results to Resolve Conflicts” in the Simulink Fixed Poi nt documentation.
28
Version 6.0 (R2008b) Simulink®Fixed Point™ Software
Functions Being
These functions software.
Function Name
showfixptsimerrors
showfixp
will be removed in a future version of Simulink Fixed Point
tsimranges
Removed in a Future Version
What Happens When You Use This Function?
Still works in R2008b
Still wor
ks in R2008b
Compatibility Considerations
Use the Fixed Tool to view o data for fixe simulation “Fixed-Poi the Simuli
Point User
Use the Fixed-Point Tool to view maximum values, minimum values, and overflow data. (Se e “Fixed-Point Tool” in the Simulink
Fixed Point User’s Guide.)
s. (See
nt Tool” in
nk Fixed
’s Guide.)
-Point
verflow
d-point
29
Simulink®Fixed Point™ Release Notes
Version 5.6.1 (R2008a+) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.6.1 (R2008a+):
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
30
Version 5.6 (R2008a) Simulink®Fixed Point™ Software
Version 5.6 (R2008a) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.6 (R2008a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are
“Enhanced Fixed-Point Tool” on page 31
“New Fixed-Point Advisor” on page 32
“Fixed-Point Enhancements in Simulink Blocks” on page 32
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
Enhanced Fixed-Point Tool
This release introduces the following enhancements to the Fixed-Point Tool:
In previous releases, you access the Fixed-Point Tool by selecting
Fixed-Point Settings from the Simulink Tools menu. To display the Fixed-Point Tool in this release, from a model’s Tools menu, select Fixed-Point > Fixed-Point Tool. See “Opening the Fixed-Point Tool” for more information.
In this release, the Fixed-Point Tool incorporates design minimum and
maximum values in its automatic scaling procedure. Typically, you use a model object’s Output minimum and Output maximum parameters to specify this design range. The tool’s Contents pane displays these values in new columns titled DesignMin and DesignMax.See“Proposing Scaling” for more information.
The Fixed-Point Tool provides a new Autoscale Information dialog box. For
each model object, this dialog summarizes data type details and explains the tools scaling proposal. See “Examining Results to Resolve Conflicts” for more information.
31
Simulink®Fixed Point™ Release Notes
See “Fixed-Point Tool” in the Simulink Fixed Point User’s Guide for more information about working with the tool.
New Fixed-Point Advisor
The Fixed-Point Advisor is a new interactive tool you can use to facilitate converting a floating-point model or subsystem to an equivalent fixed-point representation. You can use the Fixed-Point Advisor to prepare a model for conversion and obtain an initial scaling to use as the starting point for refinement and exploration inside the Fixed-Point To ol. For more information, see “Fixed-Point Advisor” in the Simulink Fixed Point documentation.
Fixed-Point Enhancements in Simulink Blocks
This section describes enhancements to fixed-point data type support in Simulink blocks.
Lookup Table (n-D) Block
The Lookup Table (n-D) block now supports fixed-point data types.
32
Sum Block
The Sum block provides a new parameter for specifying the data type of its accumulator. You can now specify its accumulator data type as any data type that Simulink supports, including fixed-point data types.
Version 5.5.1 (R2007b+) Simulink®Fixed Point™ Software
Version 5.5.1 (R2007b+) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.5.1 (R2007b+):
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
33
Simulink®Fixed Point™ Release Notes
Version 5.5 (R2007b) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.5 (R2007b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. Se e also Summary.
New features and changes introduced in this version are
“New Signal Logging Options in the Fixed-Point Tool” on page 34
“Add, Subtract, and Sum Blocks Use an Accumulator Data Type” on page 34
“Cast O perations with Net Bias Use an Intermediate Data Type” on page 35
“Non-Matrix-Wise Parameter Scaling Modes Removed” on page 35
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
No
New Signal Logging Options in the Fixed-Point Tool
In this release, the Fixed-Point Tool includes new options that provide batch control of signal logging for models and subsystems. These options allow you to enable or disable logging for m ultiple signals simultaneously, based on the location of signals in a model hierarchy and whether the signals have names. For m ore information, see the documentation for the Simulink Reference.
fxptdlg function in the
34
Add, Subtract, and Sum Blocks U se an Accumulator Data Type
In previous releases, the Add, Subtract, and Sum blocks used a user-specified output data type to perform all operations. This behavior might have caused precision loss and saturation during intermediate operations, producing unexpected results. In this release, these blocks use an ideal accumulator data type w hen performing intermediate operations. Consequently, the
Version 5.5 (R2007b) Simulink®Fixed Point™ Software
Add, Subtract, and Sum blocks now produce more precise results, and the Real-Time Workshop product generates less saturation code for them.
Cast Operations with Net Bias Use an Intermediate Data Type
Data type conversions w ith net bias involve an intermediate addition operation. In previous releases, blocks that perform such casts used the output data type’s container to compute the addition operation. This behavior might have caused extra saturation, producing unexpected results. In this release, data type conversions can use an ideal data type when perfo r m in g all intermediate operations. By reducing or eliminating intermediate saturations, cast operations now produce more accurate results, and the Real-Time Workshop product generates more efficient code for them.
Non-Matrix-Wise Parameter Scaling Modes Removed
In previous releases, the Gain and Weighted Moving Average blocks contained aparameternamedParameter scaling mode whose options included the following scaling modes:
Best Precision: Element-wise
Best Precision: Row-wise
Best Precision: Column-wise
Best Precision: Matrix-wise
In this release, only the Best Precision: Matrix-wise setting is available, and it is now simply named pane of the Gain or Weighted Moving Average block parameter dialog box, use the Data Type Assistant to specify
Best precision.OntheParameter Attributes
Best precision for the Scaling control.
Compatibility Considerations
Pre-R2007b models that contain Gain or Weighted Moving Average blocks whose Parameter scaling mode option specifies a non-matrix-wise setting will be updated automatically when loaded in R2007b. That is, the Simulink software will change non-matrix-wise settings to
Best precision, which now
35
Simulink®Fixed Point™ Release Notes
represents matrix-w ise-best-precision scaling. Consequently, affected blocks might g enerate results that differ from those obtained in previous releases.
36
Version 5.4.1 (R2007a+) Simulink®Fixed Point™ Software
Version 5.4.1 (R2007a+) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.4.1 (R2007a+):
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
37
Simulink®Fixed Point™ Release Notes
Version 5.4 (R2007a) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.4 (R2007a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
Fixed-Point Tool
The Fixed-Point Tool is a new interactive graphical environment for analyzing and scaling fixed-point systems, which replaces the Fixed-Point Settings interface in previous releases. To access the tool, from the Simulink model editor Tools menu, select Fixed-Point Settings. Alternatively, you use the
fxptdlg function to access the tool. See “Fixed-Point Tool” in Simulink
Fixed Point User’s Guide for a tutorial that demonstrates how to use the
new interface.
38
Version 5.3 (R2006b) Simulink®Fixed Point™ Software
Version 5.3 (R2006b) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.3 (R2006b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports No
New features and changes introduced in this version are
Fixed Bugs an d Known Problems
Related Documentation at Web Site
Fixed-Point Enhancements in Simulink Blocks
This section describes enhancements to fixed-point data type support in Simulink blocks.
Math Function Block
The sqrt operation in the Math Function block supports fixed-point data types.
New Lookup Table Blocks
The new Prelookup and Interpolation Using Prelookup blocks support fixed-point data types.
39
Simulink®Fixed Point™ Release Notes
Version 5.2.1 (R2006a+) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.2.1 (R2006a+):
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs an d Known Problems
at Web site
Related Documentation at Web Site
No
40
Version 5.2 (R2006a) Simulink®Fixed Point™ Software
Version 5.2 (R2006a) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.2 (R2006a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are
“Fixed-Point Block Parameters Supported” on page 41
“’Simplest’ Rounding Mode” on page 41
Fixed Bugs an d Known Problems
at Web site
Related Documentation at Web Site
No
Fixed-Point Block Parameters Supported
This release allows you to specify fixed-point numbers as the values of Simulink block parameters. In particular, you can specify fixed-point data types in S imulink block parameter di al og boxes and as values of th e data type property of Fixed-Point Parameters” for more information.
Simulink.Parameter objects. See “Configuring Blocks with
’Simplest’ Rounding Mode
AnewSimplest rou nding mode is available for the Round integer calculations toward parameter of some fixed-point Simulink blocks. This
rounding mode attempts to reduce or eliminate the need for extra rounding code in your genera te d code. The available for the following blocks:
Simplest rounding mode is currently
Data Type Conversion
Product
Lookup Table
Lookup Table (2-D)
Lookup Table Dynamic
41
Simulink®Fixed Point™ Release Notes
For more inform ation, refer to “Rounding Mode: Simplest” in the product documentation.
42
Version 5.0 (R14) Simulink®Fixed Point™ Software
Version 5.0 (R14) Simulink Fixed Point Software
This table summarizes what’s new in Version 5.0 (R14):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. Se e also Summary.
New features and changes introduced in this version are
“Product Restructuring” on page 43
“Fixed-Point Blocks Fully Integrated into Simulink Software” on page 44
“API for User-Written Fixed-Point S-Functions” on page 52
“Fixed-Point Advisor” on page 52
“Arithmetic with Non-Zero Bias Fully Supported” on page 52
“Generated Code for Lookup Tables Uses Less ROM” on page 53
“Functions Moved to Simulink Software” on page 53
“Obsolete Functions” on page 54
“Major Bug Fixes” on p age 54
Fixed Bugs an d Known Problems
Yes Details
Related Documentation at Web Site
No
Product Restructuring
The Fixed-Point Blockset has been replaced by two new products, Fixed-Point Toolbox™ and Simulink Fixed Point. This product restructuring reflects the broad expansion of fixed-point capabilities in the MATLAB and Simulink software. The Fixed-Point Toolbox product introduces fixed-point operations to the MATLAB language, and the Simulink Fixed Point product enables fixed-point capabilities across much of the Simulink product family.
43
Simulink®Fixed Point™ Release Notes
The Simulink Fixed Point software requires the Fixed-Point Toolbox software. If you are on maintenance, you will automatically receive both of these new products in place of the Fixed-Point Blockset software.
Fixed-Point Blocks Fully Integrated into Simulink Software
All former Fixed-Point Blockset blocks have been moved into the Simulink block libraries with this release. Each of these blocks, as well as all other Simulink blocks, can be used with or without the S im ulink Fixed Point software installed. You can share models with any fixed-point and floating-point Simulink blocks among the users in your organization, whether or not they have the Simulink Fixed Point software installed. However, a Simulink Fixed Point software license is required to take full advantage of the fixed-point features of Simulink blocks. For more information, refer to “Sharing Fixed-Point Models” in the Simulink Fixed Point User’s Guide.
The fo llowing table lists all of the blocks in the Fixed-Point B lockset software as of Release 13. It tells you the current name of the block in the Simulink software and the Simulink library in which you can find the block. Most blocks have the same name as in the last release; however, some block names have changed.
Former Fixed-Point Blockset Block
Abs
Accumulator Calculus
Accumulator Resettable
Accumulator Resettable Limited
Add
Bit Clear
44
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Math
Calculus
Calculus
Math
Bits
Abs Math O perations
Discrete-Time Integrator
Discrete-Time Integrator
Discrete-Time Integrator
Add Math O perations
Bit Clear
Discrete
Discrete
Discrete
Logic and Bit Operations
Version 5.0 (R14) Simulink®Fixed Point™ Software
Former Fixed-Point Blockset Block
Bit Set
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Bits
Bit Set
Logic and Bit Operations
Bitwise O perator
Bits
Bitwise O perator
Logic and Bit Operations
Compare To Constant Logic & Comparison Compare To Constant
Logic and Bit Operations
Compare To Zero Logic & Comparison Compare To Zero
Logic and Bit Operations
Constant Sources Constant Sources
Conversion
Conversion Inhe rited
Data Type
Data Type
Data Type Conversion Signal Attributes
Data Type Conversion
Signal Attributes
Inherited
Cosine
Lookup
Cosine
Counter Free Sources Counter
Lookup Tables
Sources
Free-Running
Counter Limited Sources Counter Limited Sources
Data Type Duplicate
Data Type
Data Type Duplicate
Signal Attributes
Data Type Propagation
Data Type Data Type
Propagation
Signal Attributes
Dead Zone Nonlinear Dead Zone Discontinuities
Dead Zone Dynamic Nonlinear Dead Zone Dynamic Discontinuities
Decrement Real World Math Decrement Real World
Additional Math & Discrete / Additional Math: Increment ­Decrement
Decrement Stored Integer
Math
Decrement Stored Integer
Additional Math & Discrete / Additional Math: Increment ­Decrement
45
Simulink®Fixed Point™ Release Notes
Former Fixed-Point Blockset Block
Decrement Time To Zero
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Math Decrement Time To
Zero
Additional Math & Discrete / Additional Math: Increment ­Decrement
Decrement To Zero
Math
Decrement To Zero
Additional Math & Discrete / Additional Math: Increment ­Decrement
Derivative
Detect Change
Calculus
Edge Detect
Discrete Derivative Discrete
Detect Change
Logic and Bit Operations
Detect Decrease
Edge Detect
Detect Decrease
Logic and Bit Operations
Detect Fall Negative Edge Detect Detect Fall Negative Logic and Bit
Operations
Detect Fall Nonpositive
Detect Increase
Edge Detect Detect Fall
Nonpositive
Edge Detect
Detect Increase
Logic and Bit Operations
Logic and Bit Operations
Detect Rise Nonnegative
Edge Detect Detect Rise
Nonnegative
Detect Rise Positive Edge Detect Detect Rise Positive Logic and Bit
Difference Calculus Difference
Divide Math Divide
Dot Product Math Dot Product
Filter Direct Form I Filters This block is obsolete.
Filter Direct Form I
Filters This block is obsolete.
Time Varying
46
Logic and Bit Operations
Operations
Discrete
Math Operations
Math Operations
Version 5.0 (R14) Simulink®Fixed Point™ Software
Former Fixed-Point Blockset Block
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Filter Direct Form II Filters
Filter Direct Form II
Filters
Time Varying
Filter First Order
Filters
Filter Lead or Lag Filters
Filter R eal Zero Filters
FIR
Gain
Gateway In
Gateway In Inherited
Filters Weighted Moving
Math
Data Type
Data Type
Transfer Fcn Direct Form II
Additional Math & Discrete / Additional Discrete
Transfer Fcn Direct Form II Time Varying
Additional Math & Discrete / Additional Discrete
Transfer Fcn First
Discrete
Order
Transfer Fcn Lead or
Discrete
Lag
Transfer Fcn Real
Discrete
Zero
Discrete
Average
Gain Math Operations
Data Type Conversion Signal Attributes
Data Type Conversion
Signal Attributes
Inherited
Gateway Out
Data Type
Data Type Conversion Signal Attributes
Increment Real World Math Increment Real World
Increment Stored Integer
Index Vector
Integer Delay
Math
Select
Delays & Holds
Increment Stored Integer
Index Vector
Integer Delay Discrete
Additional Math & Discrete / Additional Math: Increment ­Decrement
Additional Math & Discrete / Additional Math: Increment ­Decrement
Signal Routing
47
Simulink®Fixed Point™ Release Notes
Former Fixed-Point Blockset Block
Integrator Backward
Integrator Backward Resettable
Integrator Backward Resettable Limited
Integrator Forward
Integrator Forward Resettable
Integrator Forward Resettable Limited
Integrator Trapezoidal
Integrator Trapezoidal Resettable
Integrator Trapezoidal Resettable Limited
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Calculus
Discrete-Time
Discrete
Integrator
Interval Test
Logic & Comparison
Interval Test Logic and Bit
Operations
Interval Test Dynamic
Logic & Comparison
Interval Test Dynamic Logic and Bit
Operations
Logical O perator Logic & Comparison Logical Operator
Logic and Bit Operations
Lookup Table Lookup Lookup Table Lookup Tables
Lookup Table Dynamic
Lookup Table (2-D)
Lookup Lookup Table
Dynamic
Lookup
Lookup Table (2-D)
Lookup Tables
Lookup Tables
48
Version 5.0 (R14) Simulink®Fixed Point™ Software
Former Fixed-Point Blockset Block
Matrix Gain
MinMax Math MinMax
MinMax Running Resettable
Multiply Math Product
Multiply Matrix Math Product
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Math
Gain Math Operations
Math Operations
Math MinMax Running
Math Operations
Resettable
Math Operations
Math Operations
Multi-Port Switch Select Multiport Switch Signal Routing
Product Math Product
Product of Elements
Product of Elements
Math
Math
Product of Elements Math Operations
Product of Elements Math Operations
Math Operations
Inverted
Rate Limiter Nonlinear Rate Limiter Discontinuities
Rate Limiter Dynamic Nonlinear Rate Limiter Dynamic Discontinuities
Relational Operator Log ic & Com paris on Relational Operator
Logic and Bit Operations
Relay Nonlinear Relay Discontinuities
Repeating Sequence Interpolated
Repeating Sequence Stair
Sources Repeating Sequence
Interpolated
Sources Repeating Sequence
Stair
Sample Rate Probe Calculus Weighted Sample
Time
Sample Time Add Calculus Weighted Sample
Time
Sample Time Divide Calculus Weighted Sample
Time
Sample Time Multiply Calculus Weighted Sam ple
Time
Sources
Sources
Signal Attributes
Signal Attributes
Signal Attributes
Signal Attributes
49
Simulink®Fixed Point™ Release Notes
Former Fixed-Point Blockset Block
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Sample Time Probe Calculus Weighted Sample
Time
Sample Time Subtract Calculus Weighted Sample
Time
Saturation
Saturation Dynamic
Scaling Strip
Nonlinear
Nonlinear
Data Type
Saturation
Saturation Dynamic
Data Type Scaling Strip
Shift Arithmetic
Sign
Sine
State-Space
Bits
Nonlinear
Lookup
Shift Arithmetic
Sign Math Operations
Sine
Filters Fixed-P oint
State-Space
Subtract
Sum
Math
Math
Subtract Math Operations
Sum Math Operations
Signal Attributes
Signal Attributes
Discontinuities
Discontinuities
Signal Attributes
Logic and Bit Operations
Lookup Tables
Additional Math & Discrete / Additional Discrete
Sum of Elements
Sum of Elements
Math
Math
Sum of Elements Math Operations
Sum of Elements Math Operations
Negated
Switch Select Switch Signal Routing
Tapped Delay
Delays & Holds
Unary Minus Math Unary Minus
Unit Delay
Unit Delay Enabled
Delays & Holds
Delays & Holds
Tapped Delay Discrete
Math Operations
Unit Delay Discrete
Unit Delay Enabled
Additional Math & Discrete / Additional Discrete
50
Version 5.0 (R14) Simulink®Fixed Point™ Software
Former Fixed-Point Blockset Block
Unit Delay Enabled External IC
Unit Delay Enabled Resettable
Unit Delay Enabled Resettable External IC
Unit Delay External IC
Unit Delay Resettable
Unit Delay Resettable External IC
Unit Delay With Preview Enabled
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Delays & Holds
Unit Delay Enabled External IC
Additional Math & Discrete / Additional Discrete
Delays & Holds
Unit Delay Enabled Resettable
Additional Math & Discrete / Additional Discrete
Delays & Holds
Delays & Holds
Unit Delay Enabled Resettable External IC
Unit Delay External IC
Additional Math & Discrete / Additional Discrete
Additional Math & Discrete / Additional Discrete
Delays & Holds
Unit Delay Resettable
Additional Math & Discrete / Additional Discrete
Delays & Holds
Unit Delay Resettable External IC
Additional Math & Discrete / Additional Discrete
Delays & Holds
Unit Delay With Preview Enabled
Additional Math & Discrete / Additional Discrete
Unit Delay With Preview Enabled Resettable
Unit Delay With Preview Enabled Resettable External RV
Unit Delay With Preview Resettable
Delays & Holds
Delays & Holds
Delays & Holds
Unit Delay With Preview Enabled Resettable
Unit Delay With Preview Enabled Resettable External RV
Unit Delay With Preview Resettable
Additional Math & Discrete / Additional Discrete
Additional Math & Discrete / Additional Discrete
Additional Math & Discrete / Additional Discrete
51
Simulink®Fixed Point™ Release Notes
Former Fixed-Point Blockset Block
Unit Delay Preview Resettable External RV
Wrap To Zero
Zero-Order Hold Delays & Holds Zero-Order Hold
Former Fixed-Point Blockset Library Simulink Block Simulink Library
Delays & Holds
Nonlinear
Unit Delay With Preview Resettable External RV
Wrap To Zero
API for User-Written Fixed-Point S-Functions
You can now write your own Simulink C S-functions that directly handle fixed-point data types with a newly published API. For m ore information, refer to “Writing Fixed-Point S -Functions” in the Simulink Fixed Point User’s Guide.
Fixed-Point Advisor
The Simulink Fixed Point software now includes Model Advisor checks to help you to configure your fixed-point models to achieve a more efficient design and optimize your generated code. To use the Model Advisor to check your fixed-point models:
1 Select Model Advisor from the Tools menu of the model you wish to
analyze. The Model Advisor appears in the Documents window on the MATLAB desktop.
Additional Math & Discrete / Additional Discrete
Discontinuities
Discrete
52
2 Click Select All to enable all Model Advisor checks. For fixed-point
code generation, the most important check boxes to select are Identify questionable fixed-point operations, Identify blocks that generate expensive s aturation and rounding code,andCheck the Hardware Implementation.
3 Click Check Model. Any tips for improving the efficiency of your
fixed-point model appear in the browser.
Arithmetic with Non-Zero Bias Fully Supported
Code generation has been enhanced to generate bit-true fixed-point code that supports multiplication, division, and reciprocal for signal and parameters
Version 5.0 (R14) Simulink®Fixed Point™ Software
with non-zero bias. Previously, these cases lead to code generation errors. Code w ill now be generated for these cases, and that code will make efficient use of just C integer operations.
Generated Code for Lookup Tables Uses Less ROM
In prior releases, the size of the generated code for models that contained lookup tables with similar attributes was larger than necessary. Such lookup tables produced similar algorithms that appeared throughout the code multiple times. In this release, some common algorithms have been placed into functions which are called by the lookup tables. This enables the same code to be reused multiple times. T he overall size of the generated code has been reduced through this enhancement.
Functions Moved to Simulink Software
The following former Fixed-Point Blockset functions are now installed with the Simulink software:
fixptbestexp
fixptbestprec
fixpt_interp1
fixpt_look1_func_approx
fixpt_look1_func_plot
fixpt_set_all
float
fxptdlg
num2fixpt
sfix
sfrac
sint
ufix
ufrac
53
Simulink®Fixed Point™ Release Notes
uint
Obsolete Functions
The functions fixpt_restore_links and fpupdate are obsolete.
Compatibility Considerations
These functions are no longer needed to update models.
Major Bug Fixes
This section summarizes the major bug fixes introduced in Version 5.0 of the Simulink Fixed Point software.
Simulation Error for 65-Bit+ Multiplication Corrected
In prior releases, fixed-point multiplication could produce the wrong answer under certain simulation conditions. For this error to occur, one input had to have at least 33 bits and the other input at least 32 bits. The correct answer hadtobenegative,andsomeadditional numerical criteria had to be met. This error could only occur in simulation; it never occurred in generated code. This error has been fully corrected for this release.
54
Fixed-Point Settings Interface Usable for Large Fonts
In the previous release, the Fixed-Point Settings interface was unusable if your system setup defined large default system fonts. When trying to open the dialog , an error would be reported and the dialog w ould not appear. The creation of the dialog has now been made robust to large fonts, a nd this problem is solved.
Lookup Table (2-D) Code Generation Bug Fixed
In a previous release, code generation w ould error out for the Lookup Table (2-D) block if the input data type had non-zero bias or non-one fractional slope, and the corresponding breakpoints were evenly spaced. This problem has been fixed.
Version 4.1 (R13SP1) Fixed-Point Blockset Software
Version 4.1 (R13SP1) Fixed-Point Blockset Software
This table summarizes what’s new in Version 4.1 (R13SP1):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Yes
New features and changes introduced in this version are
“Improved Treatment of Tunable Parameters” on page 55
“Generated Code Improved for Lookup Tables and Division” on page 56
“Major Bug Fixes” on p age 56
Fixed Bugs an d Known Problems
Details
Related Documentation at Web Site
No
Improved Treatment of Tunable Parameters
In Release 13, many Simulink and Fixed-Point Blockset blocks were unified. The unified blocks were designed to be fully compatible with models created in earlier releases. However, the unified rules for the treatment of tunable parameters caused compatibility problems for some legacy fixed-point models as discussed in “Backwards Compatibility of Tunable Parameters for Unified Fixed-Point Blocks” on pag e 58. In this release, these rules have been improved.
A fixed-point model created in Release 1 2.1 may have experienced problems with tunable parameters when generating code with Versions 5.0 or 5.0.1 of the Real-Time Workshop software. With the current release, a model createdinRelease12.1willbeabletogeneratecodewithoutcompatibility problems. Please note that the steps described in “Version 4.0.1 (R13+) Fixed-Point Blockset S oftw are” on page 58 of these Release Notes to solve these compatibility problems do not need to be reversed. The new rules are compatible both with legacy fixed-point models from Release 12.1 and with models that used the work-around described for the previous release.
55
Simulink®Fixed Point™ Release Notes
Generated Code Improved for Lookup Tables and Division
The generated code for utilities that support integer and fixed-point math have been improved to reduce the amount of ROM required. In particular, code that supports lookup tables and division has been improved. The generated code for these operations has been restructured to make greater use of shared functions and less use of inlined code.
Major Bug Fixes
This section summarizes the major bug fixes introduced in Version 4.1 of the Fixed-Point Blockset software.
Plot System Dialog Signal Information Co rrected
The Plot System dialog is a tool that allow s fixed-point simulation results to be easily compared against equivalent floating-p oint simulation results. Access this dialog by opening the Fixed-Point Settings interface from the Simulink Tools menu, and then clicking the Show plot dialog icon. For the current model, the dialog provides a lis t of signals that are logged to the workspace by To Workspace blocks, Scope blocks, and root-level Outport blocks. Signals from this list can be selected, and then plotted in three ways.
56
There are three plot buttons in the Plot System dialog. The Plot Signals button shows the simulation results that are collected using the model’s specified data types. The Plot Doubles button shows the simulation results that are collected wh en the m odel’s specified data types are overridden at the root level by True Doubles or Scaled Doubles. The Plot Both button shows both results simultaneously, making it easy to compare fixed-point behavior against idealized floating-point behavior.
In Release 13, the Plot System dialog did not al ways work properly. Clicking any of the three plot buttons could plot the wrong signals or lead to incorrect error messages. These errors have been corrected. Signals are now associated with the correct plot buttons. In addition, the error messages have been changed to give improved instructions on how to collect the data required by each button.
Version 4.1 (R13SP1) Fixed-Point Blockset Software
Fixed-Point Settings Interface Now Usable for Large Fonts
In the previous release, the Fixed-Point Settings interface was unusable if your system setup defined large default system fonts. When trying to open the dialog , an error would be reported and the dialog w ould not appear. The creation of the dialog has now been made robust enough to handle large fonts.
57
Simulink®Fixed Point™ Release Notes
Version 4.0.1 (R13+) Fixed-Point Blockset Software
This table summarizes what’s new in Version 4.0.1 (R13+):
New Features and Changes
Yes
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. Se e also Summary.
The major cha nge introduced in this version is
Fixed Bugs an d Known Problems
Fixed bugs
Related Documentation at Web Site
No
Backwards Compatibility of Tunable Parameters for Unified Fixed-Point Blocks
Unified fixed-point blocks with tunable parameters have com patibility problems under certain conditions in Release 13. The problem arises only if a tunable paramet er is mapped to a built-in integer or When tunable parameters are mapped to built-in integers or generated by the Real-Time Workshop product will be different for unified blocks than it was for Fixed-Point Blockset blocks in prior releases. There are no compatibility problems if a tunable parameter maps to a nonbuilt-in data type, such a s a scaled fixed-point integer.
single data type.
single,thecode
58
Compatibility Considerations
Tunable parameters are entered in a Simulink model by specifying the name of a MATLAB variable in a block’s dialog. This variable can be either a plain MATLAB variable or a Simulink parameter object. In either case , a numerical valuewillbedefinedforthistunableparameter by doing an assignment in MATLAB. MATLAB supports several numerical data types including the eight Simulink built-in numerical data types:
int16, uint16, int32,anduint32. One of these eight data types can be used
when a value is defined for a MATLAB variable. The effect of the data type of the MATLAB variable is significantly different depending on how the tunable parameter is used in the Simulink model.
double, single, int8, uint8,
Version 4.0.1 (R13+) Fixed-Point Blockset Software
For Simulink built-in blocks, the legacy rule is to fully respect the data type used for the value of a MATLAB variable. Whatever data type is used in MATLAB when assigning a value to a variable is also used when declaring that param eter in code generated by the Real-Time Workshop product. The use of that parameter by a block may require the value to be represented using a different data type. If so, additional code is generated to convert the parameter every time it is used by the block. Togetthemostefficientcode for a given block, the value of the MATLAB variable should use the same data type as is needed by the block.
For Fixed-Point Blockset blocks, the legacy rule is to expect no data type information from the MATLAB variable used for the tunable parameter. A fundamental reason for this is that MATLAB does not have native support for fixed-point data types and scaling, so the Simulink built-in legacy rule could not be directly extended to the general fixed-point case. Many fixed-point blocks automatically determine the data type and scaling for parameters based on what leads to the most efficient implementation of a given block. However, certain blocks such as Constant, as well as blocks that use tunable parameters in multiplication, do not imply a unique best choice for the data type and scaling of the parameter. These blocks have provided separate parameters on their dialogs for entering this information.
In Release 13, many Simulink built-in blocks and Fixed-Point Blockset blocks were unified. The Saturation block is an example of a unified block. The Saturation block appears in both the Simulink Library and in the Fixed-Point Blockset Library, but regardless of where it appears it has identical behavior. This identical unified behavior includes the treatment of tunable parameters. The dissimilarity of the legacy rules for tunable parameters has lead to a shortcoming in the unified blocks. Unified blocks obey the Simulink legacy rule sometimes and the Fixed-Point Blockset legacy rule at other times. If the block is using the parameter with built-in Simulink data types, then the Simulink legacy rule applies. If the block is using the parameter with nonbuilt-in data types, such as scaled fixed-point data types, then the Fixed-Point Blockset legacy rule applies. This gives full backwards compatibility with one important exception.
The backwards compatibility issue arises when a model created prior to R13 uses a Fixed-Point Blockset block with a tunable parameter, and the data type used by the block happens to be a built-in data type. If the block is unified, it will now handle the parameter using the Simulink legacy rule
59
Simulink®Fixed Point™ Release Notes
rather than the Fixed-Point Blockset legacy rule. This can have a significant impact. For example, suppose the tunable parameter is used in a Saturation block and the data type of the input signal is a built- in releases, the Fixed-Point Blockset block would have declared the parameter as an
int16. For legacy fixed-point models, the MATL AB variables used for
tunable parameters invariably gave their value using floating-point The unified Saturation block would now declare the tunable param eter in the generated code as six more bytes of memory as a Saturation block now includes conversions from every time the block executes. This increases code size and slows down execution. If the design was intended for use on a fixed-point processor, the use of floating-point variables and floating-point conversion code is likely to be unacceptable. It should be noted that the numerical behavior of the blocks is not changed even though the generate d code is different.
For an individual block, the backwards compatibility issue is easily solved. The solution involves understanding that the Simulink legacy rule is being applied. The Simulink legacy rule preserves the data type used when assigning the value to the MATLAB variable. The problem is that an undesired data type will be used in the generated code. To solve this, you should change the way you assign the value of the tunable parameter. Determine what data type is desired in the generated code, then use an explicit type cast when assigning the value in MATLAB. For example, if is desired in the generated code and the initial value is 3, then assign the value in MATLAB as
int16.Inprior
double.
double. This has several negatives. The variable takes up
double than as an int16. The code for the
double to int16 th at execute
int16
int16(3). The generated code will now be as desired.
60
A preliminary step to solving this issue with tunable parameters is identifying which blocks are affected. In most cases, the treatment of the parameter will involve a downcast from tab of the Simulation Parameters dialog is a line item called
downcast
. Setting this item to W arning or None will help identify the blocks
double to a smaller data type. On the Diagnostics
Parameter
whose tunable parameters require reassignment of their variables.
In R13, the solution described above did not work for three unified blocks: Switch, Look-Up Table, and Lookup Table (2-D ). These blocks caused errors when the value of a tunable p ara m ete r was specified using integer data types. This was a false error and has been removed. Usin g an explicit type cast when assigning a value to the MATLAB variable now solves the issue of generating code with the desired data types.
Version 4.0 (R13) Fixed-Point Blockset Software
Version 4.0 (R13) Fixed-Point Blockset Software
This table summarizes what’s new in Version 4.0 (R13):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. Se e also Summary.
New features and changes introduced in this version are
“Installation and Licensing” on page 61
“Unified Simulink and Fixed-Point Blockset Blocks” on page 62
“Global Data Type Override and Logging Modes” on page 64
“Shift Arithmetic Block” on page 65
Fixed Bugs an d Known Problems
No bug fixes
Related Documentation at Web Site
No
Installation and Licensing
To support the sharing of models in a large organization, Version 4.0 of the Fixed-Point Blockset product is a utomatically installed whenever the Simulink software is installed. You can configure models to either take full advantage of all fixed-point features, or to run without a Fixed-Point Blockset software license. Therefore all Simulink software users in your organization can run and work on the same model, regardless of whether they have a Fixed-Point Blockset software license.
YoumusthaveaFixed-PointBlocksetsoftwarelicensetorunamodelifitis configured to log minimums, maximums, or overflows. You control logging with the system-level setting Logging mode. If you turn logging off at the top-level system in a model, then no data is logged for any block in any subsystem of th e model, and a Fixed-P oi nt Blockset softwar e license is not required. Y ou also need a Fixed-Point Blockset software license to run a model that uses any nonbuilt-in, fixed-point data types. However, you can use the system-level setting Data type override to force blocks to use
doubles
61
Simulink®Fixed Point™ Release Notes
or singles instead of fixed-point data types. Therefore, by turning the Data type override parameter on and the Logging mode parameter off at the
top level of a model, a Simulink so ftw are user without a Fixed-Point Blockset software license can run a model with fixed-point enabled blocks. See “Global Data Type Ov erride and Logging Modes” on page 64 for mo re information on these settings.
If you have a Fixed-Point Blockset s oftw are license, you can run bit-true simulations with your models that contain fixed-point enabled blocks. If a Fixed-Point Blockset software license is not available or desired, you can turn log ging off and data type override on at the top level of your model and perform idealized floating point-based simulations.
IfyouhavebothaFixed-PointBlockset software license and a Real-Time Workshop software license, you can generate bit-true integer code from y our models with fixed-point enabled blocks. If you do not have a Fixed-Point Blockset software license but you do have a Real-Time Workshop software license, you can generate idealized floating-point code from your models with fixed-point enabled blocks.
62
Unified Simulink and Fixed-Point Blockset Blocks
Many core Simulink and Fixed-Point Blockset blocks with sim ilar functions have been unified in this release. For example, the Sum block in the Simulink Math Operations library and the Sum block in the Fixed-Point Blockset Math library are now the same block. All the functionality from each original block has been maintained in unifying these blocks. Compatibility with fixed-point data types and/or specific fixed-point features are now available with all of these blocks, whether the blocks used are from the Simulink library or the Fixed-Point Blockset library. You do no t need to make any changes to your earlier models as a result of this improvement. You can now use any of the unified blocks with either built-in data types or fixed-point data types, which eliminates the need to replace blocks in your models when you want to use different data types. This change does not require Simulink software users to have a Fixed-Point Blockset software license. Refer to “Installation and Licensing” on page 61 for more information.
Fixed-Point Blockset blocks that have been unified no longer have an “F” on their block icon. However, not all Fixed-Point Blockset blocks that have counterparts in the Simulink library have been unified. You can still use the
fixpt_convert function to replace nonunified Simulink blocks with their
corresponding Fixed-Point Blockset blocks in your models.
Nonunified Fixed-Point Blockset blocks have an advantage over their Simulink library counterparts in that they can handle more data types. As discussed above, you can easily switch them between fixed-point data types and singles or doubles using the global data type override setting. However, you may still want to use the Simulink library counterparts of nonunified Fixed-Point Blockset blocks in som e cases, because they support faster simulation times for the data types they handle.
The following table lists the unified blocks in this release, and the Simulink and Fixed-Point Blockset libraries in which they are found.
Block Simulink Library
Version 4.0 (R13) Fixed-Point Blockset Software
Fixed-Point Bloc kset Library
Abs Math Operations
Math
Constant Sources Sources
Data Store Memory Signal Routing N/A
Data Store Read Signal Routing N/A
Data Store Write Signal Routing N /A
Gain Math Operations
Inport
Ports & Subsystems, Sources N/A
Math
Logical Operator Math Operations Logic & Comparison
Look-Up Table Look-Up Tables LookUp
Look-Up Table (2-D)
Look-Up Tables LookUp
Manual Switch Signal Routing N/A
Memory
Merge
Discrete
N/A
Signal Routing N/A
Multi-Port Switch Signal Routing S e lec t
Outport Ports & Subsystems, Sinks N/A
Product
Math Operations
Math
63
Simulink®Fixed Point™ Release Notes
Block Simulink Library
Fixed-Point Bloc kset Library
Rate Transition
Relational Operator Math Operations Logic & Comparison
Relay Discontinuities Nonlinear
Saturation
Sign Math Operations
Signal Specification Signal Attributes N/A
Slider Gain Math Operations N/A
Sum Math Operations
Switch Signal Routing Select
Unit Delay Discrete
Zero-Order Hold
Signal Attributes N/A
Discontinuities Nonlinear
Nonlinear
Math
Delays & Holds
Discrete
Delays & Holds
Compatibility Considerations
Breaking library links to Fixed-Point Blockset blocks will almost certainly produce an error when you attempt to run the model. If broken links exist, you will likely uncover them when upgrading to the latest release of the Fixed-Point Blockset software. The used to restore links for Fixed-Point Blockset blocks.
fixpt_restore_links command can be
64
Global Data Type Override and Logging Modes
You can now set data type override and logging modes for systems or subsystems in the Fixed-Point Blockset Interface. The Override data type(s) with doubles and Log minimums and maximums check boxes have been removed from the mask of every Fixed-Point Blockset block.
Compatibility Considerations
The Override data type(s) with doubles and Log minimums and maximums check boxes have been removed from the mask of every
Fixed-Point Blockset block. You can now set these parameters on the system or subsystem level.
Version 4.0 (R13) Fixed-Point Blockset Software
When you upgrade to Version 4.0, all doubles override and logging information is cleared from your models. You can reset these controls in the Fixed-Point Blockset Interface for any system or subsystem. Access the Fixed-Point Blockset Interfa ce from the Simulink Tools menu, or by typing
fxptdlg('modelname') at the MATLAB command line.
Ifyouhavebeengettingorsetting the block parameters your M-code, you must now use the system parameters and MinMaxOverflowLogging.
DblOver or dolog in
DataTypeOverride
Shift Arithmetic Block
The Fixed-Point Blockset software now includes the Shift Arithmetic block in the Bits library. The Shift Arithmetic block shifts the bits or binary point of asignal,orboth.
65
Simulink®Fixed Point™ Release Notes
Compatibility Summary for Simulink Fixed Point Software
This table summarizes new features and changes that might cause incompatibilities when you upgrade from an earlier version, or wh en you use files on multiple versions. Details are provided in the description of the new feature or change.
Version (Release) New Features and Changes with Version
Compatibility Impact
Latest Version V6.3 (R2010a)
V6.2.(R2009b)
V6.1 (R2009a) See the Compatibility Considerations
V6.0 (R2008b) See the Compatibility Considerations
V5.6.1 (R2008a+)
V5.6 (R2008a)
None
None
subheading for these new features or changes:
“Lookup Table (n-D) and Interpolation
Using Prelookup Blocks Perform Efficient Fixed-Point Interpolations” on page 20
“Rounding Modes Convergent and Round
Added to Multiple Blocks” on page 21
subheading for these new features or changes:
“Cell Array No Longer Created When Data
Logging Is Enabled in the Fixed-Point Tool” on page 27
“Functions Being Removed in a Future
Version” on page 29
None
None
66
V5.5.1 (R2007b+)
None
Compatibility Summary for Simulink®Fixed Point™ Software
Version (Release) New Features and Changes with Version
Compatibility Impact
V5.5 (R2007b)
V5.4.1 (R2007a+)
V5.4 (R2007a)
V5.3 (R2006b)
V5.2.1 (R2006a+)
V5.2 (R2006a)
V5.0 (R14)
V4.1 (R13SP1)
See the Compatibility Considerations subheading for this new feature or change:
“Non-Matrix-Wise Parameter Scaling Modes
Removed” on page 35
None
None
None
None
None
See the Compatibility Considerations subheading for this new feature or change:
“Obsolete Functions” on page 54
None
V4.0.1 (R13+)
See the Compatibility Considerations subheading for this new feature or change:
“Backwards Compatibility of Tunable
Parameters for Unified Fixed-Point Blocks” on page 58
67
Simulink®Fixed Point™ Release Notes
Version (Release) New Features and Changes with Version
Compatibility Impact
V4.0 (R13)
See the Compatibility Considerations subheading for each of these new featu res or changes:
“Unified Simulink and Fixed-Point Blockset
Blocks” on page 62
“Global Data Type Override and Logging
Modes” on page 64
68
Loading...