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. [. . . ] To learn how to configure your MATLAB Web preferences, see "Web Preferences" in the MATLAB documentation. 13 Fixed-Point ToolboxTM Release Notes Version 2. 4 (R2009a) Fixed-Point Toolbox Software This table summarizes what's new in Version 2. 4 (R2009a): New Features and Changes Yes Details below Version Compatibility Considerations Yes Summary Fixed Bugs and Known Problems NoBug Reports Includes fixes Related Documentation at Web Site No New features and changes introduced in this version are: · "Support Added for numerictype Objects with Unspecified Sign" on page 14 · "New Fixed-Point Menu Options in the MATLAB Editor" on page 15 · "New mrdivide and rdivide Functions for Fixed-Point Inputs" on page 15 · "New Compilation Report for emlc and emlmex" on page 15 · "New and Updated Demos" on page 16 · "Complex fi Objects with Nontrivial Slope and Bias Scaling Are No Longer Supported" on page 17 Support Added for numerictype Objects with Unspecified Sign A new Signedness property has been added to the numerictype object. This new Signedness property allows you to set the Signedness of a numerictype object to Signed, Unsigned, or Auto. By setting the Signedness property to Auto, you can create numerictype objects that have an unspecified sign. Although you can create numerictype objects with an unspecified sign (Signedness: Auto), all fi objects must have a Signedness of Signed or Unsigned. If you use a numerictype object with Signedness: Auto to construct a fi object, the Signedness property defaults to Signed at fi object creation. 14 Version 2. 4 (R2009a) Fixed-Point ToolboxTM Software The toolbox still supports the Signed property of the numerictype object. 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. To run this demo, type fixpt_atan2_demo at the MATLAB command line. 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. [. . . ] 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. When you simulate the model or generate code for a target environment, a function in an Embedded MATLAB Function block generates efficient C code. [. . . ]