====================================================================== -- VisualAudio Designer 2.6.0.585: NOT FOR REDISTRIBUTION -- Release Notes -- -- Analog Devices, Inc. -- -- Updated July 28, 2008 -- ====================================================================== Section I: System Requirements 1. Operating System: Windows XP with Service Pack 2 or later (make sure you have Administrator's privileges). 2. Analog Devices VisualDSP++ release 4.5 (with June 2007 update), or Analog Devices VisualDSP++ release 5.0 (with SP3 update) http://www.analog.com/processors/blackfin/evaluationDevelopment/crosscore/toolsUpgrades/index.html http://www.analog.com/processors/sharc/evaluationDevelopment/crosscore/toolsUpgrades/index.html ------------------------------------------------------------------------------- Section II: Installation information VisualAudio 2.6 is installed in the following directory by default: /Program Files/Analog Devices/VisualAudio 2.6 The user may choose any other destination during the installation process. Let represent the installation directory. The directories under VisualAudio 2.6 are as follows: - root installation directory. Contains the executable for the VisualAudio Designer application as well as the .ini file. /Common - shared source files needed to build real-time targets on the SHARC and Blackfin /Designer - Misc DLL's used by the application. Also the schema for platform XML files. /Docs - Documentation /ExampleLayouts - VisualAudio's Layouts /Matlab - files that allow Matlab to connect to VisualAudio's external interface /Modules - Module XML files, source, libraries, module packs, and custom inspectors /Platforms - Platform source, including drivers ------------------------------------------------------------------------------- Section III: Other settings *This release of VisualAudio includes following platforms: 1. EZKit_21262_Basic 2. EZKit_21364_Basic 3. EZKit_21364_SPI_Basic ** new ** 4. EZKit_21369_AVR 5. EZKit_21369_Basic 6. EZKit_21369_RS232_Basic ** new ** 7. EZKit_21375_Basic ** new ** 8. EZKit_BF527_Basic ** new ** 9. EZKit_BF533_Basic 10. EZKit_BF537_Basic 11. EZKit_BF537_AudioX_AVR 12. EZKit_BF537_AudioX_Basic 13. EZKit_BF538_AudioX_Basic ** new ** 14. EZKit_BF548_Basic ** new ** 15. EZKit_BF561_Basic ** new ** Refer to the platform documentation regarding how to setup and configure the EZ-KITs. Pay close attention to the switch settings! For better orientation, turn the board so that the text on the switch blocks is right side up. Then you can clearly see the side of the switch block which is labeled 'ON'. To fully use the tuning capabilities of VisualAudio you must run VisualDSP++ under a non-simulator session. In addition, symbols must be enabled, so a Release configuration of the project must generate debug information. ------------------------------------------------------------------------------- Section IV: Changes From Previous Releases New Features since 2.5 ------------------------ Support for VisualDSP++ 5.0. You must use VisualDSP++ 5.0 with service pack 1 (SP3). The module libraries are built with VisualDSP++ 5.0 and are backward compatible with VisualDSP++ 4.5. Most platforms support both VisualDSP++ 4.5 and 5.0. The VisualDSP++ 4.5 projects have the standard names (e.g., EZKit_21262_Basic.dpj) while the VisualDSP++ 5.0 project have the string "_vdsp5_0" appended (e.g. EZKit_21262_Basic_vdsp5_0.dpj) Some of the newer Blackfin processors are supported under VisualDSP++ 5.0 only. These platforms only have a single .dpj file: EZKit_BF527_Basic EZKit_BF548_Basic Tuning via RS232 and SPI in addition to BTC. SPI tuning requires the U2C-12 USB to SPI converter from Diolan. See www.diolan.com. Changes to the way tuning symbols are managed. When entering tuning mode for the first time, a Tuning Symbol File (.tsf) is generated for the layout. If no changes occur to the layout, the .tsf is reused. This allows standalone tuning on the RS232 and SPI platforms. Additional SHARC modules: Pooled delay Table driven compressor core Table driven limiter core Graphic EQ AGC RMS volume control with low and highi frequency boosts Additional Blackfin modules Spectral module pack ------------------------------------------------------------------------------- Section V: Notes To view Tools anomalies visit: http://www.analog.com/processors/cda/epTASearch/ To view Silicon anomalies visit: http://www.analog.com/processors/technicalSupport/ICanomalies.html Please report bugs to visualaudio.support@analog.com. Please specify the platform specifics (hardware/software) and version information as well as steps to reproduce the bug. ------------------------------------------------------------------------------- (c) 2008 Analog Devices, Inc., ALL RIGHTS RESERVED. Trademarks and registered trademarks are property of their respective companies. This document may not be reproduced in any form without prior, express written consent from Analog Devices, Inc. ====================================================================== -- VisualAudio Designer 2.5.0.99: NOT FOR REDISTRIBUTION -- Release Notes -- -- Analog Devices, Inc. -- -- Updated December 12, 2006 -- ====================================================================== Section I: System Requirements 1. Operating System: Windows XP with Service Pack 2 or later (make sure you have Administrator's privileges). 2. Analog Devices VisualDSP++ release 4.5 (with November 2006 or later update). http://www.analog.com/processors/blackfin/evaluationDevelopment/crosscore/toolsUpgrades/index.html http://www.analog.com/processors/sharc/evaluationDevelopment/crosscore/toolsUpgrades/index.html [Important: See "HotFix" requirement, described below.] ------------------------------------------------------------------------------- Section II: Installation information VisualAudio 2.5 is installed in the following directory by default: /Program Files/Analog Devices The user may choose any other destination during the installation process. The root directory of VisualAudio Designer is VisualAudio 2.5. The directories under VisualAudio 2.5 are as follows: Designer - Visual Tool, external interface, tuning dll, and related dlls. Docs - Documentation ExampleLayouts - VisualAudio's Layouts Matlab - files that allow Matlab to connect to VisualAudio's external interface Modules - Module XML files, source, libraries, module packs, and custom inspectors Platforms - Platform source, including drivers ------------------------------------------------------------------------------- Section III: Documentation overview The documentation has been factored into three categories. These are represented by directories under VisualAudio 2.5/Docs. The categories and their function are: 1. Audio Designer - VisualAudio Designer user documentation, etc. 2. Audio Programmer - How to create your own audio module, etc. 3. Embedded Engineer - Framework documentation, platforms, etc. The documentation is accessible from VisualAudio Designer's Help menu. ------------------------------------------------------------------------------- Section IV: Other settings *This release of VisualAudio includes following platforms: 1. EZKit_21262_Basic 2. EZKit_21364_Basic 3. EZKit_21369_Basic 4. EZKit_BF533_Basic 5. EZKit_BF537_Basic 6. EZKit_BF537_AudioX_Basic 7. EZKit_BF537_AudioX_AVR 8. EZKit_21369_AVR *To fully use the tuning capabilities of VisualAudio you must run VisualDSP++ under a non-simulator session. In addition, symbols must be enabled, so a Release configuration of the project must generate debug information. If you halt and reset from VisualDSP++, be sure to reload the .dxe before running again from VisualDSP++. *EZ-KIT Lite DIP switch settings for use with VisualAudio: (For better orientation, turn the board so that the text on the switch blocks is right side up. Then you can clearly see the side of the switch block which is labeled 'ON'.) All switches should be in default state. The default settings can be found in section Switches Settings of the EZKIT Lite Hardware Reference manuals. For detailed information on switcher settings, please check the platform documentation for each specific platform. ------------------------------------------------------------------------------- Section V: Changes From Previous Releases New Features since 2.0 ------------------------ Support for VisualDSP++ 4.5. "module pack" support for convenient installation of new modules. USB Platform support for file-based decoders such as WMA, MP3, Ogg on Blackfin Platforms (available separately.) Support for a variety of branded decoders, post-decoders and post-processing algorithms, such as Dolby Digital, DTS, Mpeg, Dolby Headphones, Dolby Virtual Speaker, DTS Neo6, etc. on SHARC and BF platforms. (Blackfin "AVR" platform included, SHARC platform available separately.) Frequency Domain and Control Rate processing support, including additional pin types to support these types. Module packs for frequency domain and control rate processing (SHARC only.) More and improved Example Layouts. Display modules including real-time FFT Scope and Peak Hold Meter. Modules supporting EZ Kit Lite buttons and LEDs. New 2nd Order Designer module allows high-level description of second order filters and shows graphic display of frequency and phase responses. Improved Automation API and Matlab support, including scripted instantiation of modules and Layouts through COM interface. Nearly all functionality of VisualAudio Designer can now be controlled by an exteral application. New automation support for Excel and other COM-aware applications New look for module inspector controls and Layout surface. New module block look with instance names, and pin labels. Integrated module help system with right clicks and help menus. New method of platform selection, with de-coupling of Layouts from Platforms, so you can open up a Layout in any platform. Module profiling display window with variety of ways to view results. 64-bit option for biquad filters. Improved speed of opening files, scanning modules, and changing platforms and Layouts Layouts may now be more fully annotated, including ability to add graphics in a Layout. Platforms now allow compiled presets to be easily placed in either internal memory or flash. (Internal memory by default.) New (backward-compatible) functionality in module XML files, including ability to initialize a settable array to a set of values, new control type options, ability to specify array alignment, etc. Assumed samling rate is now settable in tuning mode. Improved support in platform Comm drivers. Issues Fixed: ------------- Bug# Description General Functionality Issues 2028 Users' min/max values are now properly saved. 3122, 3064, 2154 Module path support improved. 3181 Toggles in presets now properly update their state when preset is applied. 3182 If min/max are described as expressions and these change, underlying value now always properly updated. 3576 Modules are now automatically updated when module path changes. 3591 The "default" attribute of a preset is now persisted after file save/load Code Generation Issues 3185 Error fixed in Compiled Preset generation. 3449 Designer no longer puts in module paths in VA*Commands.txt when no moduel from that location is used. 3475 Indirect pin descriptor now properly handled by code generator. GUI Issues 702 Wires can no longer be copied/pasted incorrectly. 2331 Cutting and pasting a module now properly handles instance name. 2379 Modules no longer incorrectly reappear after being deleted. 2437 Module no longer stays selected when it should not. 3124 Spaces are now allowed when typing a module path name (Windows XP). 1910 Changing instance name no longer generates Windows alert sound. 2315 Spurious error messages are no longer generated when tuning times out. 2986 Module status pull down menu is now correctly updated when applying presets. 3029 Tick size drop list is now in sorted order. 3223 Status bar can no longer get hidden by resizing window 3411 It is now easier to make wiring connections between modules. Performance Issues 3096 Updating long FIR coefficients via inspector in text mode is no longer slow. COM API and Matlab Issues 824 External COM & custom inspector interfaces now have better error codes. 1763 COM functions now work with Excel. 3129 Closing system while demand render mode is active now works properly. 3170 Matlab Module Designer can now properly design 3rd order filters while in tuning mode. 3215 COM low-level access of AUX variables now returns correct values Platform Issues 2996 Blackfin Audio EZ Extender now uses "live" VisualDSP++ version of drivers. 3031 EZKit_21369_Basic platform now puts more data structures off chip (for board rev 0.1), thus improving memory usage. 3506 Blackfin Audio EZ Extender issue now correctly handles certain problematic S/PDIF sampling rate changes addressed. 3633 VisualAudio Blackfin platforms now work properly as loader files when Booting from Flash on BF533 Module Issues 3175 Maximum number of inputs and outputs in the mixers expanded to 64. 3558 SHARC modules no longer clear CBUFEN (this was causing conflict with some customer frameworks) 3575 Blackfin ASRC function GetOutputAvail() no longer reports one sample more than is actually available. Documentation Issues 3091 Compiled presets and flash programming now documented. 2955 Documented/clarified procedure for resolving tuning deadlock. 3174 BF537 jumper settings clarified in user documentation. ------------------------------------------------------------------------------- Section VI: Notes To view Tools anomalies visit: http://www.analog.com/processors/cda/epTASearch/ To view Silicon anomalies visit: http://www.analog.com/processors/technicalSupport/ICanomalies.html ------------------------------------------------------------------------------- Section VII: Known Issues ------------------------- Issue Title XXXX (BF537 + Audio EZ-Extender platform specific) The current Audio EZ-Extender card has some hardware anomalies which cause problem when used with VisualDSP++ November update: It does not correctly configure the codecs(AD1938, ADAV801) on the board. To address this issue, replace the original versions of device driver files in your VisualDSP installation with the files in the "HotFix" subfolder of each platform folder like below. - copy "adi_ad1938_ii.c" to "/Program Files/Analog Devices/VisualDSP 4.5/Blackfin/lib/src/drivers/codec" - copy "adi_adav801.c" to "/Program Files/Analog Devices/VisualDSP 4.5/Blackfin/lib/src/drivers/codec" - copy "adi_device_access.c" to "/Program Files/Analog Devices/VisualDSP 4.5/Blackfin/lib/src/drivers/deviceaccess" Note that when you use these codec drivers in your own project (other than VisualAudio), you need to add the file "adi_device_access_spi.c" from the directory "/Program Files/Analog Devices/VisualDSP 4.5/Blackfin/lib/src/drivers/deviceaccess" to the list of source files in your project. (when you build your applications, this will get built and override the version in the device driver library) unless you are using TWI device. XXXX BF537 + Audio EZ-Extender AVR platform specific There is problem with the optimization enable in specific framework file while using this platform in release mode. because of this issue always audio presents in left channel, other channels are mute. Workaround(s): 1. Change the project options from Release mode to Debug.It should work fine. 2. If user want to run this platform in release mode open the PCM.c file in the project and go to the function PCM_PackDataAux(), top of this fuction you will find it is optimized for space which is creating problem,change this to optimize for speed.Rebuild project. it will work fine. XXXX The documents EZKit_BF537_AudioX_AVR.pdf and EZKit_21369_AVR.pdf are incorrectly placed in the folder "Basic Platform Docs", instead of "AVR and Automotive Platforms". XXXX Messages of the following form may occur if you have a Blackfin EZ Kit with an older rev of the Silicon: 0.3[Warning li2152] The following input file(s) 'si-revision' is incompatible with 0.2 0.3 c:\program files\analog devices\visualaudio 2.5\modules\blackfin\Lib\Modules_BF532.dlb[AMF_Scaler.doj] These messages can normally be ignored. Alternatively, the module library can be recompiled using the -si-revision compiler/assembler option to specify the correct rev of the Silicon. 1988 Atomic section true within false that is about to overflow msg buffer should back-track/flush. Workaround: Increase tuning buffer size 2033 Copy/paste is slown when pasting a large number of modules. 2175 No warning when Layout tick size is less than module's minTickSize. 2265 No documentation for bit stream detector in programmer's guide. 2344 Selecting a large number of modules on the screen is slow. 2375 No way to send array values atomically through GUI. 2661 Modules filter out duplicate settings, thus preventing "state" variables from being reset to the same value as before. Workaround: Use "trigger" control types 3188 Multiple applications accessing external interface simultaneously fail. 3195 Field names hard to read in status bar when Windows font size is set to "large" in Windows Display Properties dialog. Workaround: Don't use "large" font mode. 3261 Focus problems with second order designer and scope inspectors, when Edit/Capture Preset are used. 3549 Blackfin RMS meter has limited dynamic range. 3599 When you zoom in, dashed lines becomes non-dashed. 3614 Symbol lookup error if VDSP crashes or is closed after entering tuning. Workaround: Exit VisualAudio Designer, then restart it. 3806 VA may pop up dialogues in some cases, even when being used as a COM server (e.g. from Matlab.) 3972 AGCLimiterCore for Blackfin and SHARC are not compatible but are similarly-named. (This can cause errors when opening Layouts.) Workaround: Adjust parameters by hand when changing between SHARC and Blackfin. 3987 Delay modules do not allow delay to equal zero. Workaround: Set to tiny positive number. 3996,4212 Copying and pasting/deleting using Ctrl-A does not work properly 4008 USB-Lan extender is connected, EZKit_BF537_AudioX_Basic platform may not work properly. Workaround: Disconnect USB-Lan extender. ------------------------------------------------------------------------------- Please report bugs to visualaudio.support@analog.com. Please specify the platform specifics (hardware/software) and version information as well as steps to reproduce the bug. ------------------------------------------------------------------------------- (c) 2006 Analog Devices, Inc., ALL RIGHTS RESERVED. Trademarks and registered trademarks are property of their respective companies. This document may not be reproduced in any form without prior, express written consent from Analog Devices, Inc.