Mathworks GAUGES BLOCKSET RELEASE NOTES

Gauges Blockset™ Release Notes
How to Contact The MathWorks
www.mathworks. comp.soft-sys.matlab Newsgroup www.mathworks.com/contact_TS.html Technical Support
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.
Gauges Blockset™ Release Notes
© COPYRIGHT 2001–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.
Summary by Version ............................... 1
Contents
Version 2.0.5 (R2010a) Gauges Blockset Software
Version 2.0.5 (R2009b) Gauges Blockset Software
Version 2.0.5 (R2009a) Gauges Blockset Software
Version 2.0.5 (R2008b) Gauges Blockset Software
Version 2.0.5 (R2008a) Gauges Blockset Software
Version 2.0.5 (R2007b) Gauges Blockset Software
Version 2.0.5 (R2007a) Gauges Blockset Software
Version 2.0.4 (R2006b) Gauges Blockset Software
Version 2.0.3 (R2006a) Gauges Blockset Software
Version 2.0.2 (R14SP3) Gauges Blockset Software
..... 4
..... 5
..... 6
..... 7
..... 8
..... 9
..... 10
..... 11
..... 12
..... 13
Version 2.0.1 (R14SP2) Gauges Blockset Software
Version 2.0 (R14SP1) Gauges Blockset Software
Version 1.2 (R14) Dials & Gauges Blockset Software
Version 1.1.2 (R13) Dials & Gauges Blockset
Software
........................................ 19
...... 15
..... 14
.. 18
iii
Version 1.1.1 (R12.1) Dials & Gauges Blockset
Software
Compatibility Summary for Gauges Blockset
Software
........................................ 21
........................................ 24
iv Contents
SummarybyVersion
This table provides quick access to what’s new in each version. For clarification, see “Using Release Notes” on page 2 .
Gauges Blockset™ Release Notes
Version (Release)
Latest Versi V2.0.5 (R201
V2.0.5 (R2009b)
V2.0.5 (R2009a)
V2.0.5 (R2008b)
V2.0.5 (R2008a)
V2.0.5 (R2007b)
V2.0.5 (R2007a)
V2.0.4 (R2006b)
V2.0.3 (R2006a)
V2.0.2 (R14SP3)
on 0a)
New Features and Changes
No No None
No No Bug Reports No
No No Bug Reports No
No No Bug Reports No
No No Bug Reports No
No No Bug Reports No
No No Bug Reports No
No No Bug Reports No
No No Bug Reports
No No Bug R
Version Compatibilit Consideratio
y
ns
Fixed Bugs and Known Problems
Includes fixes
eports
ludes fixes
Inc
Related Documentation at Web Site
Printable R elease Notes: PDF
Current product documentation
No
No
.0.1 (R14SP2)
V2
V2.0 (R14SP1)
V1.2 (R14)
No No Bug Reports
Includes fixes
Yes Details
es
Y Details
Yes Summary
es
Y Summary
No bug fixes
Fixed bugs
No
No
N
o
1
Gauges Blockset™ Release Notes
Version (Release)
V1.1.2 (R13)
V1.1.1 (R12.1)
New Features and Changes
Yes Details
Yes Details
Version Compatibility Considerations
Yes Summary
Yes Summary
Fixed Bugs and Known Problems
No bug fixes
No bug fixes
Related Documentation at Web Site
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 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.
®
or Simulink®). Determine if enhancements,
What Is in the Release Notes
New Features and Changes
New functionality
Changes to existing functionality
Version Compatibility Con si derations
When a new feature or change introduces a reported incompatibility between versions, the Compatibility Considerations subsection explains the impact.
2
SummarybyVersion
Compatibility issues reported after the product release appear under Bug Reports at The MathWorks™ Web site. Bug fixes can sometimes result in incompatibilities, so review the fixed bugs in Bug Reports for any compatibility impact.
Fixed Bugs and Known Problems
The MathWorks offers a user-searchable Bug Reports database so you can view Bug Reports. The development team updates this database at release time and as more information becomes available. Bug Reports include provisions for any known workarounds or file replacem ents. Information is available for bugs existing in or fixed in Release 14SP2 or later. Information is not avail able for all bugs in earlier releases.
Access Bug Reports using y our MathWorks Account.
3
Gauges Blockset™ Release Notes
Version 2.0.5 (R2010a) Gauges Blockset Software
Gauges Blockset™ software has no changes between R2007a and R2010a, so its version number has not changed.
New Features and Changes
No No None
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
4
Version 2.0.5 (R2009b) Gauges Blockset™ Software
Version 2.0.5 (R2009b) Gauges Blockset Software
Gauges Blockset software has no changes between R2007a and R2009b, so its version number has not changed.
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
5
Gauges Blockset™ Release Notes
Version 2.0.5 (R2009a) Gauges Blockset Software
Gauges Blockset software has no changes between R2007a and R2009a, so its version number has not changed.
New Features and Changes
No No Bug Reports
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
6
Version 2.0.5 (R2008b) Gauges Blockset™ Software
Version 2.0.5 (R2008b) Gauges Blockset Software
Gauges Blockset software has no changes between R2007a and R2008b, so its version number has not changed.
New Features and Changes
No No Bug Reports No
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
7
Gauges Blockset™ Release Notes
Version 2.0.5 (R2008a) Gauges Blockset Software
Gauges Blockset software has no changes between R2007a and R2008a, so its version number has not changed.
New Features and Changes
No No Bug Reports No
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
8
Version 2.0.5 (R2007b) Gauges Blockset™ Software
Version 2.0.5 (R2007b) Gauges Blockset Software
Gauges Blockset software has no changes between R2007a and R2007b, so its version number has not changed.
New Features and Changes
No No Bug Reports No
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
9
Gauges Blockset™ Release Notes
Version 2.0.5 (R2007a) Gauges Blockset Software
This table summarizes what’s new in Version 2.0.5 (R2007a):
New Features and Changes
No No Bug Reports No
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
10
Version 2.0.4 (R2006b) Gauges Blockset™ Software
Version 2.0.4 (R2006b) Gauges Blockset Software
This table summarizes what’s new in Version 2.0.4 (R2006b):
New Features and Changes
No No Bug Reports No
Version Compatibility Considerations
Fixed Bugs an d Known Problems
Related Documentation at Web Site
11
Gauges Blockset™ Release Notes
Version 2.0.3 (R2006a) Gauges Blockset Software
This table summarizes what’s new in Version 2.0.3 (R2006a):
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
12
Version 2.0.2 (R14SP3) Gauges Blockset™ So ftware
Version 2.0.2 (R14SP3) Gauges Blockset Software
This table summarizes what’s new in Version 2.0.2 (R14SP3):
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
13
Gauges Blockset™ Release Notes
Version 2.0.1 (R14SP2) Gauges Blockset Software
This table summarizes what’s new in Version 2.0.1 (R14SP2):
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
14
Version 2.0 (R14SP1) Gauges Blockset™ Software
Version 2.0 (R14SP1) Gauges Blockset Software
This table summarizes what’s new in Version 2.0 (R14SP1):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. See also Summary.
New features and changes introduced in this version are described here.
Fixed Bugs an d Known Problems
No bug fixes
Related Documentation at Web Site
No
Changes Since V1.2 (R14)
*
Changes described in this section reflect reprogramm ing implemented to
comply with a court decision concerning patent litigation.
All source blocks (dials) have been removed from Dials & Gaug e s Blockset and it has been renamed Gauges Blockset 2.0.
Demos in o ther MathWorks products have b een updated to reflect the changes in Gauges Blockset software.
If you are updating from a release earlier than Release 14, then you should see “Version 1.2 (R14) Dials & Gauges Blockset Software” on page 18.
Compatibility Considerations
This section describes the issues involved in moving to Gauges Blockset software Version 2 .0 from Version 1.2 of Dials & Gauges Blockset. In the discussion below, a legacy model means a model that contains one or more blocks from Dials & Gauges Blockset and that you saved using Release 14 or earlier.
15
Gauges Blockset™ Release Notes
Resave Models to Suppress Warnings. When you initially open a legacy model, you see one or more warnings about unknown parameters, such as the message below:
Warning: ActiveX Block bl ock (mask) does not have a parameter named 'output'.
If you resave the model using V2.0 (R14SP1) of Gauges Blockset software, the unknown parameters will not be saved and the warnings will not appear the next time you open the model.
Dial Blocks and Related Parameters Removed. Ga ug es Blockset software no longer enables you to configure blocks as sources, that is, the blockset no longer supports user input. The blockset omits the following libraries:
Buttons & Switches
Knobs & Selectors
16
Sliders
Demo Joystick Control
Also, the Block Parameters dialog box for Gauges Blockset blocks omits the Output property and Event on which to output parameters. This dialog box no longer offers
output as a possible value for the Connections
parameter.
Ifyouopenalegacymodelthatpreviously contained dials (blocks from the former Dials & Gauges Blockset that operated as sources), you will find that they now show up as generic ActiveX Control blocks configured to simply pass their newly sprouted inport to their outport. Since these blocks perform no useful function other than to denote where you previously had used a “dial,” we recommend that you remove them from your model.
Button Blocks Modified and Re na med. Some blocks in the former Buttons & Switches library are now in the On Off Gauges library. The blocks are configured as output displays or sinks, that is, they no longer support user input.
Version 2.0 (R14SP1) Gauges Blockset™ Software
As the table below indicates, some blocks in the former Buttons & Switches library have been renamed to reflect the new reduced capability.
Former Name of Block New Name of Block
Dip Switch Dip Switch Readout
Generic Toggle On Off Reado ut
In addition, the following blocks have been removed from the library.
OnOff Switch
Round Green
Round Red
Round Yellow
Square Green
Square Red
Square Yellow
Slider Blocks Modified and Renamed. The Sliders library, along with
the Horizontal Slider and Vertical Slider have been removed. All othe r blocks in this library have been converted to sinks — that is, they are now output devices and do not support input — and have been moved to the Linear Gauges library.
In addition, two of the blocks that have been moved to the Linear Gauges library have been renamed.
Former Name of Block New Name of Block
Generic Slider Generic Bar Gauge
Scaled Slider Scaled Bar Gauge
17
Gauges Blockset™ Release Notes
Version 1.2 (R14) Dials & Gauges Blockset Software
Note Dials & Gauges Blockset 1.2 has been superseded by Gauges Blockset
software V ersion 2.0 and statements on these historical release notes may not apply to the current release.
This table summarizes what’s new in Version 1.2 (R14):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. See also Summary.
New features and changes introduced in this version are described here.
Fixed Bugs an d Known Problems
Fixed bugs
Related Documentation at Web Site
No
Block Customizations Saved in Model File
When you customize a preconfigured Dials & Gauges Blockset block using its ActiveX Control Properties dialog box, the customizations are saved in the modelfileratherthaninexternal
Compatibility Considerations
If you open a legacy model that was saved from a previous version, then the application reads the legacy the model file the next time you save the model.
.ax files.
.ax files and incorporates the information into
18
Version 1.1.2 (R13) D ials & Gauges Blockset Software
Version 1.1.2 (R13) Dials & Gauges Blockset Software
Note Dials & Gauges Blockset 1.1.2 h as been superseded by Gauges Blockset
software V ersion 2.0 and statements on these historical release notes may not apply to the current release.
This table summarizes what’s new in Version 1.1.2 (R13):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. See also Summary.
New features and changes introduced in this version are
“Examples of Displaying Multiple Input Values” on page 19
“Numerical Value of Buttons and Switches Changed” on page 19
“Off-Block Control Parameter Removed” on page 20
Fixed Bugs an d Known Problems
No bug fixes
Related Documentation at Web Site
No
Examples of Displaying Multiple Input Values
The documentation uses two new examplemodelstoillustratetwodifferent techniques for displaying multiple input values simultaneously on a multiple-component gauge. One model simulates a stopwatch that has multiple needles, while the other m odel varies multiple portions of a pie chart. See “Controlling Multiple Graphical Elements” for details.
Numerical Value of Buttons and Switches Changed
In V1.1.1 (R12.1) of Dials & Gauges Blockset software, blocks in the Bu t tons & Switches library return a numerical value of As of V1.1.2 (R13), the same blocks return a numerical value of
-1 when in the “on” state. 1 when in
19
Gauges Blockset™ Release Notes
the “on” state. The “off” state is unaffected by this change, and continues to return a numerical value of
Note More generally, this change in behavior applies to your own controls if they return a property w hose data type is Boolean.
Compatibility Considerations
Herearetwopossiblewaystoupgradeyourexistingmodelsthatusebutton or switch blocks:
If the model contains a “Button convert to Simulink” block at the output
port of the button or switch block, then remove the “Button convert to Simulink” block.
Otherwise, insert a Gain block at the output port of the button or switch,
using a value of Simulink Math library.
0.
-1 for the Gain parameter. The Gain block is in the
20
If y ou previously used a Data Type Conversion block to convert to a Boolean value, then you do not need to change your model.
Off-Block Control Parameter Removed
The Event on which to output field has been removed from the Block Parameters dialog box for off-block controls. Off-block dials are not supported.
Compatibility Considerations
Legacy models that used off-block dials might not work properly because this feature is not supported.
Version 1.1.1 (R12.1) Dials & Gauges Blockset Software
Version 1.1.1 (R12.1) Dials & Gauges Blockset Software
Note Dials & Gauges Blockset 1.1.1 h as been superseded by Gauges Blockset
software V ersion 2.0 and statements on these historical release notes may not apply to the current release.
This table summarizes what’s new in Version 1.1.1 (R12.1):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. See also Summary.
New features and changes introduced in this version are
“Real-Time Workshop Software Support” on page 21
“External Mode Support” on page 22
“Block Parameters Dialog Boxes Enhanced” on page 22
“Aircraft and Joystick Demo Controls Added” on page 23
“Double-Clicking Response Changed” on page 23
Fixed Bugs an d Known Problems
No bug fixes
Related Documentation at Web Site
No
Real-Time Workshop S oftware Support
You can now use Real-Time Workshop®software to generate code from models that include Dials & Gauges Blockset blocks.
For dials, the code you generate contains static values (i.e., the value specified at the time of code generation). Gauges are ignored during code generation, except through the use of external mode (see below). If you want to manipulate dials and view the gauges, you can do so through the Real-Time Workshop external mode.
21
Gauges Blockset™ Release Notes
External Mode Su
Support for exte
1.1.1 allows you connect to thro Windows Target
For more infor the Real-Time
Block Parame
Anewfield, Parameters
This field &GaugesBl queried th Version 1 value of t former ap time ste
The Even cause th
.1.1, when you move a dial, an event occurs that changes the output
he block. This new event-driven approach is more efficient than the
proach of repeatedly requesting the same information at successive
ps.
evalueoftheoutputtobeupdated.
rnal mode in Dials & Gauges Blockset software Version
to incorporate dials and gauges into any target that you can
ugh e xternal mode (e.g., see the xPC Target™ and Real-Time
™ documentation for those products for details).
mation about external mode, see the “External Mode” section of
Workshop documentation.
ters Dialog Boxes Enhanced
Event on which to output, has been added to the Block
dialog box for dials.
has been added to allow dial controls to be more efficient. In Dials
ockset software Version 1.0, at each time step the application
e dial for its value. Now, in Dials & Gauges Blockset software
t on which to output field allows you to specify what events will
pport
22
Note Th Versi
1.1.1
e field that was called Event in Dials & Gauges Blockset software
on 1.0 has been renamed in Dials & Gauges Blockset software Version
;itisnowcalledOther events and handlers.
Compatibility Considerations
you open a Version 1.0 model with Version 1.1.1, default values may be
When
matically inserted in the Event on which to output field. This occurs
auto
built-in Dials & Gauges Blockset blocks when this field is empty.
for
Version 1.1.1 (R12.1) Dials & Gauges Blockset Software
Aircraft and Joystick Demo Controls Added
The Global Majic ActiveX Library, dng_gmslib,containstwonewdemo sublibraries:
Demo Aircraft Instruments
Demos Joystick Control
These sublibraries contain controls that use time-limited evaluation licenses from Global Majic, Inc. Contact The MathWorks for details about purchasing full licenses for those controls.
Double-Clicking Response Changed
In V1.0, double-clicking on the border of a block displays the Block Parameters dialog box. In V1.1.1 (R12.1), double-clicking on a block that is supplied with the blockset (i.e., a built-in block) displays the ActiveX Control Properties dialog box. If you double -click on a user-created block, the Block Parameters dialog box is displayed (i.e., the behavior is the same as in V1.0).
Compatibility Considerations
Be aware of this change in mouse response when you double-click on blocks in this blockset.
23
Gauges Blockset™ Release Notes
Compatibility Summary for Gauges Blockset 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 Compatib ility Impact
Latest Version V2.0.5 (R2010a)
V2.0.5 (R2009b)
V2.0.5 (R2009a)
V2.0.5 (R2008b)
V2.0.5 (R2008a)
V2.0.5 (R2007b)
V2.0.5 (R2007a)
V2.0.4 (R2006b)
V2.0.3 (R2006a)
V2.0.2 (R14SP3)
V2.0.1 (R14SP2)
V2.0.0 (R14SP1) See th e Compatibility
V1.2 (R14) See the Compatibility
None
None
None
None
None
None
None
None
None
None
None
Considerations subheading for “Changes Since V1.2 (R14)” on page 15.
Considerations subheading for this new feature or change:
24
“Block Customizations Saved in
Model File” on page 18
Compatibility Summary for Gauges Blockset™ Software
Version (Release) New Features and Changes with
Version Compatib ility Impact
V1.1.2 (R13) See the Compatibility
Considerations subheading
for each of these new features or changes:
“Numerical Value of Buttons and
Switches Changed” on page 19
“Off-Block Control Parameter
Removed” on page 20
V1.1.1 (R12.1) See the Compatibility
Considerations subheading for each of these new features or changes:
“Block Parameters Dialog Boxes
Enhanced” on page 22
“Double-Clicking Response
Changed” on page 23
25
Loading...