User manual MATLAB FIXED-POINT TOOLBOX RELEASE NOTES

[. . . ] Fixed-Point ToolboxTM Release Notes How to Contact The MathWorks Web Newsgroup www. mathworks. com/contact_TS. html Technical Support www. mathworks. com comp. soft-sys. matlab suggest@mathworks. com bugs@mathworks. com doc@mathworks. com service@mathworks. com info@mathworks. com Product enhancement suggestions Bug reports Documentation error reports Order status, license renewals, passcodes Sales, pricing, 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. Fixed-Point ToolboxTM Release Notes © COPYRIGHT 2004­2010 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. [. . . ] For more information about the Signedness property, see "numerictype Object Properties" in the Fixed-Point Toolbox documentation. New Fixed-Point Menu Options in the MATLAB Editor A new Tools > Fixed-Point Toolbox menu option in the MATLAB Editor allows you to build fi, fimath, and numerictype object constructors in a GUI and insert them directly into your file. For more information, see the following sections: · "Constructing fi Objects" · "Constructing fimath Objects" · "Constructing numerictype Objects" New mrdivide and rdivide Functions for Fixed-Point Inputs Fixed-Point Toolbox software now provides the following fi object functions for division: · mrdivide -- Forward slash (/) or right-matrix division · rdivide -- Right-array division (. /) New Compilation Report for emlc and emlmex A new compilation report is now available for emlc and emlmex. The new report provides compile-time type information for the variables and expressions in your MATLAB code. This information simplifies finding sources of error messages and aids understanding of type propagation rules, particularly for fixed-point data types. To generate the report, you must specify the -report option after the emlc or emlmex command. To learn more about the compilation report, see the following sections: · For information about using the report to view fixed-point data types, see "Working with Fixed-Point Compilation Reports" in the Fixed-Point Toolbox documentation. 15 Fixed-Point ToolboxTM Release Notes · For more information about using the report with emlmex, see "Working with Compilation Reports" in the Embedded MATLAB subset documentation. · For more information about using the report with emlc, see "Working with Compilation Reports" in the Real-Time Workshop documentation. Compatibility Consideration The following internal and external browsers do not support the new compilation report: · MATLAB internal browser (on 64-bit UNIX® platforms only) · MACI internal browser · Microsoft Internet Explorer® 6 To view the new compilation report when your internal browser does not support it, you must configure your MATLAB Web preferences to use an external browser, for example, Mozilla Firefox. To learn how to configure your MATLAB Web preferences, see "Specifying the System Browser for UNIX Platforms" in the MATLAB documentation. New and Updated Demos The Fixed-Point ATAN2 Calculation demo is new for this release. This new demo uses the CORDIC algorithm and polynomial approximation to perform a fixed-point calculation of the four quadrant inverse tangent. The Fixed-Point Data Type Override, Min/Max Logging, and Scaling demo has been updated for this release. The updated demo uses the emlc and emlmex functions to generate code and demonstrates the Embedded MATLAB subset's ability to generate code beyond 32-bits. To run this demo type fi_datatype_override_demo at the MATLAB command line. 16 Version 2. 4 (R2009a) Fixed-Point ToolboxTM Software Complex fi Objects with Nontrivial Slope and Bias Scaling Are No Longer Supported Fixed-Point Toolbox operations that result in the creation of a complex fi object with nontrivial slope and bias scaling are no longer supported. All complex fi objects must now have an integer power-of-two slope and a bias of 0 (binary-point scaling). Compatibility Consideration In prior releases, Fixed-Point Toolbox software supported complex fi objects with nontrivial slope and bias scaling. As of R2009a, all complex fi objects must have an integer power-of-two slope and a bias of 0. Operations that result in the creation of a fi object with nontrivial slope and bias scaling will error out. 17 Fixed-Point ToolboxTM Release Notes Version 2. 3 (R2008b) Fixed-Point Toolbox Software This table summarizes what's new in Version 2. 3 (R2008b): New Features and Changes Yes Details below Version Compatibility Considerations No Fixed Bugs and Known Problems Bug Reports Includes fixes Related Documentation at Web Site No New features and changes introduced in this version are: · "The Default fimath Object is Now User-Configurable" on page 18 · "Embedded MATLAB Subset Support for Data up to 128 Bits" on page 18 · "round and convergent Rounding Mode Support Added to the Embedded MATLAB Subset" on page 19 · "New reinterpretcast Function" on page 19 · "New sort Function for Fixed-Point Inputs" on page 19 The Default fimath Object is Now User-Configurable When you create a fi object in MATLAB code or the Embedded MATLAB Function block without providing any fimath attributes in the constructor call, a default fimath object is assigned to the fi object you create. Previously, this default fimath object could not be user-configured, and the only way to assign a different fimath to your fi objects was to specify the desired fimath object in every constructor call. In R2008b, the default fimath object used in the fi and fimath constructors can be user-configured. For more information, see "Working with the Global fimath" in the Fixed-Point Toolbox User's Guide. Embedded MATLAB Subset Support for Data up to 128 Bits The Embedded MATLAB subset now supports fixed-point word lengths up to 128 bits. This includes: 18 Version 2. 3 (R2008b) Fixed-Point ToolboxTM Software · Acceleration of fixed-point algorithm execution with the emlmex function. · Model simulation and C code production with the Embedded MATLAB Function block. round and convergent Rounding Mode Support Added to the Embedded MATLAB Subset The Embedded MATLAB subset now supports two additional rounding modes: · round -- Rounds to the closest representable number. In the case of a tie, the round method rounds positive numbers to the closest representable number in the direction of positive infinity, and rounds negative numbers to the closest representable number in the direction of negative infinity. In the case of a tie, convergent rounds to the nearest even number. New reinterpretcast Function Fixed-Point Toolbox software now provides a reinterpretcast function to convert fixed-point data types without changing the underlying data. New sort Function for Fixed-Point Inputs Fixed-Point Toolbox software now provides support for the MATLAB sort function. 19 Fixed-Point ToolboxTM Release Notes Version 2. 2. 1 (R2008a+) Fixed-Point Toolbox Software This table summarizes what's new in Version 2. 2. 1 (R2008a+) New Features and Changes No Version Compatibility Considerations No Fixed Bugs and Known Problems Bug Reports Includes fixes Related Documentation at Web Site No There were no new features or changes in this version. 20 Version 2. 2 (R2008a) Fixed-Point ToolboxTM Software Version 2. 2 (R2008a) Fixed-Point Toolbox Software This table summarizes what's new in Version 2. 2 (R2008a): New Features and Changes Yes Details below Version Compatibility Considerations No Fixed Bugs and Known Problems Bug Reports Includes fixes Related Documentation at Web Site No New features and changes introduced in this version are: · "Enhanced Memory Management" on page 21 · "New Rounding Functions for fi Objects" on page 22 · "New Bitwise Operator bitreplicate" on page 22 · "New Syntax for Bitwise Operator bitconcat" on page 22 · "ndgrid Function Support for Fixed-Point Inputs" on page 23 · "New fi Constructor Syntax" on page 23 Enhanced Memory Management The memory management of the fi object has been improved, and generating large multidimensional arrays should no longer hang the MATLAB environment. [. . . ] a= -1 DataTypeMode: Signed: WordLength: FractionLength: RoundMode: OverflowMode: ProductMode: MaxProductWordLength: SumMode: MaxSumWordLength: CastBeforeSum: logreport(a) minlog a -1 maxlog 0. 9999695 lowerbound -1 upperbound 0. 9999695 noverflows 3 nunderflows 0 -1 0 0. 99997 0. 99997 Fixed-point: binary point scaling true 16 15 nearest saturate FullPrecision 128 FullPrecision 128 true Now set DataTypeOverride to 'ScaledDoubles'. The minimum and maximum logs show the full possible range of the data without quantization: p = fipref; p. LoggingMode = 'On'; p. DataTypeOverride = 'ScaledDoubles'; b = fi(-2:2, true, 16, 15) Warning: 3 overflows occurred in the fi assignment operation. b= -2 -1 0 1 2 38 Version 1. 4 (R2006a) Fixed-Point ToolboxTM Software DataTypeMode: Signed: WordLength: FractionLength: RoundMode: OverflowMode: ProductMode: MaxProductWordLength: SumMode: MaxSumWordLength: CastBeforeSum: logreport(b) minlog b -2 maxlog 2 Scaled double: binary point scaling true 16 15 nearest saturate FullPrecision 128 FullPrecision 128 true lowerbound -1 upperbound 0. 9999695 noverflows 3 nunderflows 0 For an in-depth example of using logging and data type override to help set appropriate scalings for fixed-point quantities, see the Fixed-Point Toolbox demo "Fixed-Point Data Type Override, Min/Max Logging, and Scaling". 39 Fixed-Point ToolboxTM Release Notes Version 1. 3 (R14SP3) Fixed-Point Toolbox Software This table summarizes what's new in Version 1. 3 (R14SP3): New Features and Changes Yes Details below Version Compatibility Considerations Yes--Details labeled as Compatibility Considerations, below. Fixed Bugs and Known Problems Bug Reports Includes fixes Related Documentation at Web Site No New features and changes introduced in this version are · "Fixed-Point Toolbox Function Support Added to Embedded MATLAB Subset" on page 40 · "Double, Single, and Boolean Data Type Support Added to the fi Object" on page 41 · "Fixed-Point Doubles Override, Min/Max Logging, and Scaling Demo" on page 41 · "Helper Functions Added for Accessing Logged Information" on page 42 · "RoundMode Property Value 'round' Now Called 'nearest'" on page 42 Fixed-Point Toolbox Function Support Added to Embedded MATLAB Subset The Embedded MATLAB Function block lets you compose a MATLAB language function in a Simulink model that generates embeddable code using the Embedded MATLAB subset. [. . . ]