Release Notes for the SNiFF+ Tornado Integration
IMPORTANT NOTICE: The SNiFF+ Tornado Integration is currently in BETA PHASE.
Documentation is not yet fully finished.
Please send all your feedback or comments on the integration to sniff-tornado-beta@takefive.co.at
.
Table of Contents
Versions
-
Integration: 1.0_final_beta of 26-Apr-2000
-
Tornado: TornadoII
-
SNiFF+: 3.2.1 or later on both Unix and Windows NT
IMPORTANT: This version of the SNiFF+ Tornado integration will NOT
work with Tornado 1.0.1! It is also not prepared to support target operating
systems other than VxWorks 5.4. If you need a SNiFF+ integration for other
Tornado versions, please contact us at mailto:sniff-tornado-beta@takefive.co.at.
Features
- Use SNiFF+ hierarchical Project Service and Browsing Tools
- Easily create SNiFF+ Projects for Tornado with Templates
- Easily add ready-made Browsing Projects for VxWorks 5.4
- Use SNiFF+ Makesupport instead of or in parallel with Tornado Makesupport
- Call Tornado Target Tools directly from SNiFF+
- For more information, see the "GettingStarted.html"
file.
Requirements
-
In order to use the SNiFF+ Debugger Tool with the CrossWind gdb backend,
you will need to download and install the patch for SPR 28340 from WindSurf
at http://www.windriver.com. Note:
for your convenience, we have made an unpacked version of this patch available
at ftp://ftp.takefive.com/pub/SNiFF/integrations/TornadoII/SPR28340.
-
On Windows 9x, you must make sure that you have enough environment space
for the command interpreter. We recommend changing your CONFIG.SYS file
to include a line like "SHELL=C:\Windows\Command.com /E:8192".
Installation
Installation on Windows
-
Install SNiFF+ from CD or download it from http://www.takefive.com.
We recommend installation into your Tornado Directory tree (for instance
in C:\Tornado\sniff ), but that's not mandatory. We recommend
to accept all default settings and install the basic and example
packages only.
WARNING: Do NOT install SNiFF+ in a directory which contains blanks.
Installation into the 8.3 character version of a directory with blanks,
like C:\Progra~1\Sniff, is also not recommended.
-
If the Tornado Integration is already found in your SNiFF+ installation
(integrations/TornadoII directory), just execute "install.exe"
in there. Enter the directories for SNIFF_DIR and WIND_BASE.
You may accept the defaults for all other questions.
-
If you downloaded the Integration separately, extract it into any directory
you like, then run "install.exe" in the toplevel integration directory.
If you have WinZIP (R), you may also open the Integration ZIP File in WinZIP
(R) and press the "Install" button to accomplish the same.
-
The installation program will create a sniff.bat file in your Tornado installation,
and it will put a link for starting SNiFF+ onto your Desktop. You should
only start SNiFF+ with this link, and not from the Start Menu
Entries created by the original SNiFF+ Setup Program!
-
The installation program will overwrite your existing SNiFF+ Working
Environments, SiteMenus and SitePrefs with the default Settings for
Tornado. Your old settings will be copied to workingenvs.tor_orig,
config/SiteMenus.sniff.tor_orig, and SitePrefs.sniff.tor_orig
irrespective of whether you chose to make backups or not. So if you
modified any of the settings in these files, you must manually merge
back your modifications from the .tor_orig files.
Installation on UNIX
-
Install SNiFF+ from CD or download it from http://www.takefive.com.
We recommend installation into $WIND_BASE/sniff, but that's not
mandatory.
-
If the Tornado Integration is already found in your SNiFF+ installation
(integrations/TornadoII directory), just execute the shellscript "install.sh"
in there. Enter the directories for SNIFF_DIR and WIND_BASE. You may accept
the defaults for all other questions.
-
If you downloaded the Integration separately, extract the tgz file into
any directory you like, then run the shellscript "install.sh" in
the toplevel integration directory.
-
If your login shell is csh or tcsh: Merge the sniff.cshrc file,
which the installation process has generated in $WIND_BASE/sniff.cshrc
into your $HOME/.cshrc file or source it from there.
-
If your login shell is sh, ksh, bash or zsh: Merge the sniff.profile, which
the installation process has generated in $WIND_BASE/sniff.profile
into your $HOME/.profile or source it from there.
-
The installation program will overwrite your existing SNiFF+ Working
Environments, SiteMenus and SitePrefs with the default Settings for
Tornado. Your old settings will be copied to workingenvs.tor_orig,
config/SiteMenus.sniff.tor_orig, and SitePrefs.sniff.tor_orig
irrespective of whether you chose to make backups or not. So if you
modified any of the settings in these files, you must manually merge
back your modifications from the .tor_orig files.
Installation for Multiple Tornado Target
Platforms
-
You may use one single SNiFF+ installation with multiple Tornado Target
installations. Just run the regular installation process repeatedly for
each of your WIND_BASE settings of the target installations.
-
You may shorten this process by using the installation program's "configure
only" option: Manually copy the "install.WIND_BASE" directory
into each of your additional Tornado Installations, then run "install.bat
-c" (Windows) or "install.sh -c" (UNIX) to create the SNiFF+
configuration files for each of your additional installations.
Upgrading your Installation to the Latest Version
-
Download the latest Integration from ftp://ftp.takefive.com/pub/SNiFF/integrations/TornadoII/
-
For Windows, please use the ZIP or self-extracting EXE file
-
For UNIX, please use the gzipped tarfile (.tgz)
-
Execute the install script as mentioned above
-
Check the backup directory created by the install script for any old settings
that were overridden and need to be merged.
Uninstalling the SNiFF+ Tornado Integration
-
If you created a backup directory during installation, the SNiFF+ Tornado
Integration can be removed from your system again. To uninstall, navigate
to your $SNIFF_DIR/integrations/TornadoII directory and execute
"install.bat -u" (Windows) or "install.sh -u" (UNIX).
WARNING: THIS FEATURE IS CURRENTLY EXPERIMENTAL!
Documentation
-
Online Documentation:
-
If you installed the Tornado Integration as part of a full SNiFF+ kit,
online documentation can be found by choosing the Help Menu in the
SNiFF+
Launch Pad. Select "? -> Online Documentation -> Application
Papers" to see the Tornado Integration Tutorial.
-
If you installed the Tornado Integration as a separate package, you will
find online documentation as HTML in the SNiFF+ integrations/TornadoII/doc
directory instead.
-
A printable version of the full Documentation is available in the
SNiFF+ integrations/TornadoII/doc directory as
-
In addition to the full documentation, a quick Getting Started Guide is
available in the GettingStarted.html
file in the toplevel integration directory. This guide is for users who
are already familiar with SNiFF+. If you do not know SNiFF+ yet, you should
work with the full documentation (as mentioned above) instead.
-
Documentation Updates: The latest version of the Tornado Integration
Documentation can also be found on the Web at ftp://ftp.takefive.com/pub/SNiFF/integrations/TornadoII/doc/.
Usage
-
You can start SNiFF+ either from the Tornado Launcher, by double-clicking
on the "SNiFF+ for Tornado" icon (Windows only) or by typing "sniff
&" at the command line (UNIX only).
-
We recommend working through the "Getting
Started with SNiFF+ and Tornado" tutorial mentioned above.
Hints, Limitations and Known
Problems
- Starting Tornado Tools, as well as downloading code to your target from
the SNiFF+ Menu currently does not work on Windows 95 and Windows 98.
- Starting the Tornado Project Facility from SNiFF+ may not work on UNIX.
Workaround: Start the Tornado Launcher first, then run the Project Facility
from the Launcher.
-
Running the debugger inside SNiFF+: You will need to apply the patch for
WindRiver SPR 28340 to be able to run the Tornado gdb backend through the
SNiFF+ Debugger frontend.
-
In the SNiFF+ Debugger Tool, the "Execution -> Attach" only works
with host-based programs. For Tornado / VxWorks targets, you will only
see an empty list. Please use the "attach" commandline command instead.
-
With the SPR 28340 patch applied, the Debugger may sometimes seem to hang
for a moment. If this happens, just set any breakpoint (press the "Break
At" button in SNiFF) and it should work OK again.
-
CrossWind on UNIX: When you use the "SNiFF+ -> Show Symbol.." menu,
the first request after starting CrossWind is always ignored. Just click
the menu again and it will work.
-
WindSH: ESC Keysequences for cursor movement and commandline editing do
not work if the WindSH is started from SNiFF+.
Changelist
- V1.0_final_beta (26-Apr-2000) improvements:
- Add final version of full Docu
- Improved BSP and Bootable Application Makesupport
- V1.0_rc7 (25-Apr-2000) improvements:
- Use WIND_TARGET_BASE instead of WIND_BASE/target in absolute projects
- Use Default Config Latest_Stable for Gizmo Team SSWE
- Improved Documentation
- Menu: "Download Object of foo.c" instead of "Download foo.c.o"
- Install.sh: correct handling if no parameter given (allow selection)
- Install: Create Version number and Tornado Arch on Windows Shortcut
- Install: Correct handling of special characters in Startup Group
- Added pre-version of final docu
- Added some missing .shared files
- Use Standard directory for .sniffrc (SNiFF_RESOURCE_DIR)
- Review File Types and Project Templates, add DEBUG=0 switch
- Set CHECK_UPDATE=0 in general.mk
- Make Debugger Wrapper work with Tornado 2.0.1 on Windows
- Make Debugger Wrapper work with Tornado 2.0.1 on Windows
- Unconditionally make backups of critical files in SNiFF installation
- Fix some problems with Win98 install
- V1.0_rc6 (22-Apr-2000) improvements:
- Added Mib Filetype from pRISM integration (without Makesupport)
- Improved backup / uninstall concept
- Made install robust against spaces in File and Directory names
- Made install robust against accidental installation on Tornado 1.0.1
- Added "Download/Unload single object" facility from Editor an PE
- Get WIND_REGISTRY from Registry for gdb Debugger on Windows
- Cleanup Info about last used Target Server on start
- Add tar and gzip to Kit on Windows (for future ADDPACK installation)
- Reduce Kit size: separate Windows and UNIX Kits, don't ship Host PDFs
- Bugfix: Example WERoot of "New PWE" was wrong
- Add Ignore Directories for optimized platforms
- Bugfix: Download on Windows didn't work (wrong NullDevice)
- Bugfix: make WindSh work from Editor menu
- V1.0_rc5 (20-Apr-2000) improvements:
- Add Platform descriptions for OPTIMIZED platforms
- Add SHARED Project Descriptions into WIND_BASE
- Use torVars.bat / torVars.csh / torVars.sh to set WIND Environment
- Bugfix: Debugger on SIMHPPA was wrongly set
- Bugfix: WindSH Here menu in Editor now works
- Added an experimental UNINSTALL feature to the installer script
- Fix some typos in documentation
- Improved DOWNLOAD automatically checks for success or failure
- Fix problem starting VxSim if Tornado IDE was never started before
- Fix problem starting WindSH if no target server is running
- Fix problem with reboot targetserver on UNIX
- Fix Processornumber of VxSim on UNIX was wrong in caption
- Fix Targetserver Errorlog into Shell from which SNiFF was started
- V1.0_rc4 (19-Apr-2000) improvements:
- Reorganize Example Directory for better understanding
- Automatically set first REAL TARGET Working Environment on Install
- Make install program robust against slashes at end of directories
- Restructure PDFs to separate h_SYSTEM from h_NET
- V1.0_rc3 (18-Apr-2000) improvements:
- Further improved the documentation
- Make install program even more robust
- Bugfix: clicking SNiFF+ Icon in Tornado Launchbar now works
- V1.0_rc2 (17-Apr-2000) improvements:
- New install.exe allows pressing the Install button directly in WinZip
- Small bugfixes in the install shellscript
- Locked hotLib.[ch] in example programs to be more instructive
- Added Hyperlinks to README.html for the table of contents
- V1.0_rc1 (14-Apr-2000) improvements:
- New Installation Program
- Works on ALL Tornado Platforms by automatically generating files
- Organize and enhance SNiFF+ Project Descriptions for VxWorks Browsing
- Bugfix: SNiFF Debugging works now on gdbsimnt
- New Buttons for Target Server Management
- Simplified Project Templates
- General Cleanup and File Rename (Makefile_sniff, sniff_gdb_wrapper)
- V0.99g (22-Feb-2000) improvements:
- Bugfix: Starting the Simulator could hang on Windows
- V0.99f (21-Feb-2000) improvements:
- Bugfix Makesupport on Windows built .out.exe instead of .out
- Add FORCE_CHECK_DIRS flag to allow build default target creating dir
- Improve sniff.bat startupfile
- Extend Tornado Custom Menus to Launchpad and Source Editor
- V0.99e (18-Feb-2000) improvements:
- Clean-up of Python basic launch services
- Fix Building Lib Problem on Windows
- Fix Launching Tornado Project Tool
- New dialog for tools not available on Windows
- Revise Working Environment Structure
- V0.99d (18-Feb-2000) improvements:
- First version on public FTP
- Bugfix in RCS.py by TLE
- Add BETA Note to README
- Add sample.profile for sh/ksh/bash/zsh users
- Add GettingStarted.html
- Small Fix in wtxTclTool
- Add Piggy to AboutBox
- Document NavToSniff.sh usage
- V0.99c (17-Feb-2000) improvements:
- Rename main Makefile Template from MakeT2sniff to MakevxApp
- Makefile Templates for BSP and App
- Dialog Box to indicate finished download
- Revise example directories for better usability
- Fix WindSh in SniffSh to run also with multiple open projects
- V0.99b (17-Feb-2000) improvements:
- Add Slickedit Integration (Windows Only)
- Add Makefile Parser for Windows, Solaris and HP-UX (but don't activate)
- Clean up Makesupport, improve versatility
- Add About Box
- Several small changes in Project Descriptions and File Types
- Add Windows Installation Instructions
- Merge with SNiFF+ 3.2.1 files where necessary
- V0.99a (16-Feb-2000) improvements:
- On UNIX, SNiFF+ has now been hooked into the Tornado Launcher
- In Tornado CrossWind, two SNiFF+ Menu Entries allow Navigation to the Symbol
Browser and to the Class Browser
- Simulator and Windsh are now started exactly the same way as in Tornado
- V0.99 (15-Feb-2000):
- First interim in-house release as a Kit.
-- Author: Martin Oberhuber
- 18 Feb 2000