 --------------------------------------------------------------------

          DSO - BITSCOPE DIGITAL OSCILLOSCOPE AND ANALYZER

                      Version 1.3 Build 06100101

   Copyright (C) 2004-2006 by BitScope Designs. All Rights Reserved.

 --------------------------------------------------------------------
 
 DSO is a suite of high performance mixed signal virtual instruments
 in a single software application for use with all BitScopes.
 
 With a BitScope it provides the following virtual instruments:
 
   * Digital Storage Oscilloscope
   * Mixed Signal Oscilloscope
   * Logic State Analyzer
   * Waveform Generator
   * Spectrum Analyzer
   * Data Recorder
 
 The DSO may also be used by itself (ie, not connected to a BitScope)
 to replay and analyze in detail previously captured (or synthesized)
 waveforms and logic data.
 
 It supports dual timebase capture with sophisticated cross-triggers
 and user programmable post-trigger delay. It simultaneously captures
 analog and logic waveforms (ie, mixed signal capture) and displays
 the captured waveforms and associated spectra concurrently.
 
 Operation is modelled on stand-alone test instruments rather than PC
 software like a multi-windowing word processor. It presents a single
 application window with a large embedded display which is configured
 automatically depending on the connected device and operating mode.
 
 Surrounding the display are control panels for immediate access to
 capture, display and replay parameters. Some panels such as trigger
 and the waveform generator embed small auxiliary waveform displays
 associated with functions provided by the control.

 The main display reports relevant parameters and capture statistics
 such as sample rate, frequency, period, voltage etc. It also povides
 time, voltage, frequency and level cursors for precise measurements
 of signal features in both time and frequency domains.
 
 DSO can be used for both deep buffer one-shot capture and high speed
 live refresh analog or logic display. It autoconfigures for use with
 with supported BitScope devices and commuicates via ethernet, USB or
 RS-232 (depending on the interface provided by the BitScope itself).
 
 DSO is available on both Windows (98SE through to XP) and Linux.
 
 --------------------------------------------------------------------
 DSO 1.3                  RELEASE FEATURES                 2006-10-01
 --------------------------------------------------------------------
 

 DSO SNAPSHOT EXPORT                                            (DSE)
 -------------------
 
 The display may now be exported to a file at the click of a button.
 
 A SAVE button appears at the lower right side of the application.
 
 When clicked the DSO displays a file dialog allowing the selection
 of a file to which the display image is saved.
 
 This new feature makes it easy to publish images produced by the DSO
 for use in other documents, websites or email.
 
 Export works concurrently with DDR (as well as new captures). For
 example it is possible to replay and analyze a recording made with
 DDR using the DSO and save any frames of interest to snapshot files.
 

 OFFLINE DDR FILE REPLAY                                        (DDR)
 -----------------------
 
 By popular request it is now possible to use DSO without a BitScope
 device being connected so that previously recorded DDR files may be
 replayed even when a BitScope device is not available.
 
 Previously if the DSO failed to find a BitScope it continued showing
 the spash screen. As of this release the DSO opens making available
 the DSO controls even though they do not connect to a real device.
 
 This allows DSO to open and replay previously recorded DDR files.
 
 See below for more about DDR.


 WAVEFORM GENERATOR PREVIEW                                     (AWG)
 --------------------------
 
 The waveform generator preview display has been updated. 
 
 It now works like the main display, using the main display timebase
 and channel scaling. This means that the preview now shows waveform
 exactly as it will appear on the main display when selected.
 
 The preview updates instantaneously with waveform parameter changes
 so it is possible to observe the modified waveform live via preview
 before it appears (after a short upload delay) on the main display.
 
 Preview is  useful on BitScope  models that dont  support concurrent
 capture (BS50U) and to see the waveform without needing to select it
 on the main display on models that do support concurrent capture.
 

 AUTO RANGE AND NORMALIZE                                       (DSO)
 ------------------------
 
 Each analog channel has controls to select vertical scale and analog
 input range independently. This change (optionally) couples the two
 so that setting one parameter adjusts the other in one of two ways;
 "AUTO-RANGE" and "NORMALIZE".

 Auto-range is the default; when the vertical scaling is changed the
 input range is adjusted automatically to optimize the A/D to produce
 the highest resolution waveform capture possible.
 
 When normalized, changing the input range automatically adjusts the
 vertical scaling such that the entire A/D range is shown aligned to
 the full display height.
 
 Auto-range is appropriate for most general purpose uses because one
 does not need to consider the input range when changing the V/Div
 settings. Normalized is useful when trying to find an unknown signal
 or when calibrating channel offsets (see below).
 
 It also remains possible to set input range and scale independently.
 

 OFFSET (RE)CALIBRATION                                         (DSO)
 ----------------------
 
 BitScope channel offsets are factory calibrated but they may now be
 user (re)calibrated via the DSO application if required.

 Offsets that may be "zeroed out" depend on the signal path selected
 which in turn depends on input source, range and prescale settings.
 
 Session based calibration is immediately available at all times via
 a pop-up menu on each channel's "zero position" button. Simply move
 the (grounded) trace to zero and select "Assign Input Offset". This
 calibrates (ie, eliminates) any offset on the channel for the given
 source, range and prescale setting.
 
 Persistent calibration is also available. In this case calibration
 settings are saved to the device itself and reused every time it is
 powered on.  Persistent calibration requires a specific calibration
 procedure to be followed which is documented elsewhere.


 USER INTERFACE CHANGES                                         (DSO)
 ----------------------
 
 Also by popular request, some small changes to the way some DSO user
 interface controls operate have been made.

 For full details see the bug fixes file: FIX.txt

 --------------------------------------------------------------------
 DSO 1.2.1                RELEASE FEATURES                 2006-03-24
 --------------------------------------------------------------------

 
 DSO DATA RECORDER                                              (DDR)
 -----------------
 
 This new version adds the "DSO Data Recorder" (aka DDR) to the DSO.
 
 The DDR supports analog waveform and logic data export and import.
 
 It (optionally) listens to enabled capture channels saving waveform
 and logic data to an internal buffer or a user selected DDR file.
 
 Files created with the DDR may be reloaded for subsequent replay and
 comparison with new waveform capture. Files captured on one BitScope
 may be reloaded for playback, review or analysis on another.

 As DDR files are encoded in the ubiquitious CSV file format they may
 be opened in standard spreadsheets (eg, Excel) or numerical analysis
 tools such as MatLab. These tools may also be used to synthesize new
 waveforms to be replayed in the DSO. For more details about DDR see:

 http://www.bitscope.com/software/dso/guide/1.2/?p=recorder


 WAVEFORM INTUITIVE DISPLAY ENGINE                              (DSO)
 ---------------------------------

 This version introduces a new display engine to the DSO (aka WIDE).
 
 Designed for speed and "intuitive" waveform and logic display, WIDE
 updates rendered waveforms and logic traces immediately any capture
 parameters such as timebase or capture mode are changed, even if no
 new data is captured, to show it correctly in the new context.
 
 The new engine is also accelerated; using both a waveform cache and
 faster rendering algorithms it is capable of (re)processing waveform
 and logic data (in response to parameter changes) very quickly. This
 makes measurement using scolling, zooming and rescaling waveform and
 spectrum displays in conjunction the cursors fast and easy.

 For more details about WIDE see:

 http://www.bitscope.com/software/dso/guide/1.2/?p=recorder#wide

 For full details of other bugfixes see the FIX.txt file.

 --------------------------------------------------------------------

 INSTALLATION AND USAGE
 ----------------------
 
 [1] Extract Dso-1.2.05031008.tar.gz in a convenient directory.
     
 [2] Install the libborqt-6.9-qt2.3.so library.
     
     This application  runs under X  Windows and requires  a modified
     QT2  library (libborqt-6.9-qt2.3.so).   If you  don't  have this
     library it is available as an RPM, DEB or TGZ archive:
     
     http://kylixlibs.sourceforge.net/down.html
     
     The library  installs in  its own directory  in /usr/lib,  so it
     will  not interfere  with anything  else already  installed that
     uses your Linux distribution's own version of the Qt library (if
     installed).

[3a] Connect your BitScope to the PC.                           (USB)
     
     If you're using  a USB BitScope with a  Kernel older than 2.4.20
     you may need to install the FTDI USB drivers:
     
     http://ftdi-usb-sio.sourceforge.net/
     
     Otherwise the BitScope should  be detected by the usbmgr process
     (if running) and configured to a device.
     
     BitScope  appears  as a  virtual  serial  device  and should  be
     accessible as /dev/ttyUSB0 or  similar.  If your distibution has
     not created  the USB  serial devices, they  have major  a device
     number  188  and can  be  created  with  a command  like  "mknod
     /dev/ttyUSB0 c 188 0".

[3b] Connect the BitScope hardware to your PC              (Ethernet)
     
     If you have only one Network BitScope and you want to connect it
     directly to your  PC's ethernet port (ie, not  via a switch) use
     the supplied cable (it is a "cross-over" cable, as required).
     
     If you have only one Network BitScope and you want to connect it
     to the same physical Ethernet Local Area Network (LAN) that your
     PC is already connected to,  simply connect the BitScope using a
     standard Ethernet cable (ie, not  the supplied cable) to a spare
     network switch port on the same LAN.
     
     In both cases no device or driver configuration is required.
     
     However, to  connect multiple Network BitScopes on  the same LAN
     or connect  a Network  BitScope on a  different network  to that
     which your PC  is connected to, you first  need configure the IP
     address of the BitScope.
     
     To do  this, install the LIAComms  Network Configuration Utility
     and follow  the instructions therein. This utility  should be on
     your CD-ROM or you can download it from http://www.bitscope.com.
     
 [4] Run Dso (no installation necessary).
     
     Note that the configuration "probe file" BitScope.prb must be in
     the same  directory as the  executable, it must be  writable and
     you should change to this directory start it.

 [5] Optionally click the SETUP button.
     
     This step configures the application  to talk to your device. If
     you have  a USB  BitScope, chances are  that it will  already be
     configured (you can skip this step).
     
     If you have an RS-232 or Ethernet BitScope, or if the USB driver
     installed the  device somewhere  other than at  /dev/ttyUSB0 you
     will need to tell the DSO where it is.
     
     See the software  users guide for more information  about how to
     use SETUP in "Software/Guide.pdf"  on the CD-ROM or check online
     at:

       http://www.bitscope.com/software/dso/guide/

 [6] Click POWER to connect and start the DSO running.
     
     The software should locate your BitScope and report its identity
     and connection status.

 --------------------------------------------------------------------
 
 TROUBLESHOOTING
 ---------------
 
 DSO is built using Borland  Kylix which needs a modified QT2 library
 that is not normally part of many Linux distributions. In some cases
 the library installation does not complete properly but this is easy
 to fix.
 
 If you see references to missing symbols when you try to run DSO the
 problem is most likely a missing library reference; the installation
 script may not have updated the library path correctly. 

 Check the following:

 [1] Have you  run (or did the rpm/deb script  run) ldconfig when you
     installed kylixlibs3-borqt ? If  not, run it to rebuild ld.cache
     and try again.

 [2] Still does not work ? Is there a carriage return after the last
     entry in ld.so.conf ? If not, put one there and go back to [1]

 [3] As root, try adding /usr/lib/kylix3 to /etc/ld.so.conf (if it's
     not already there) and run ldconfig (to update ldcache) before
     trying again.

 [4] Still does not work ? Try running:

     (export LD_LIBRARY_PATH=/usr/lib/kylix3; \
     strace -etrace=open ./Dso 2>/tmp/trace.txt)

 and send usb the trace.txt file so we can get a handle on what might
 be wrong in your case.   ldd does not always uncover missing library
 references from  within the libraries  (as opposed missing  from the
 application itself) but running the  above will show every file open
 attempt (including the one that is failing).

 If ammending  ld.so.conf does  not solve the  problem you can  put a
 symbolic link from /usr/lib to  the location of the library, run DSO
 via a launcher such as:

  LD_LIBRARY_PATH=/usr/lib/kylix3 ./Dso

 or add a line like

  LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:/usr/lib/kylix3"

 to ~/.profile (aka ~/.bash_profile etc).

 The WINE option
 ---------------

 A dedicated Linux user (http://www.pehr.net/) told us he had success
 installing and running  the Windows version of DSO  using Wine under
 Redhat Linux Fedora Core 2:

 > 1. Download a Wine RPM from http://winehq.com
 > 2. Install the RPM for Wine
 >         $ su -
 >         # rpm -Uvh wine-*.686.rpm
 > 3. Configure the serial ports for Wine in your home directory
 >         ### Run wine to create the configuration directory
 >         ### The first time wine runs, it sets up ~/.wine/
 >         $ wine
 > 
 >         $ cd /home/username/.wine/dosdevices/
 >         $ ls -l
 >         ### look for com1, com2, com3, etc
 >         ### Remove any broken links
 >         $ su -
 >         # rm com4
 >         ### Replace with valid links
 >         # ln -s /dev/ttyS3 com4
 >         # ln -s /dev/ttyUSB0 com5
 >         # ln -s /dev/ttyUSB1 com6
 >         # ln -s /dev/ttyUSB2 com7
 >         # ln -s /dev/ttyUSB3 com8
 > 
 > 4. Unpack the Bitscope installer
 >         $ unzip Dso-1.2.04091605.zip
 > 
 > 5. Run the bitscope installer
 >         $ wine InstallDSO.exe
 > 
 > 6. Now you can run the DSO program
 >         $ cd Program\ Files/BitScope
 >         $ wine BitScopeDSO.exe

 Running on 64 bit SuSe systems
 ------------------------------

 A number of SuSe using BitScope owners have reported difficulty
 getting the DSO to run correctly. We don't run SuSe but we have
 received the following very helpful advice from someone who does:

Ken Anderson <ken-anderson@comcast.net> wrote:
>
> After our last email I set up an old AMD K6/550 box with suse
> 9.0. and 9.2, same problems.  So I started looking at what was
> wrong with my setup.  I read on some kylix web page that on some
> systems the kylix libs will link to themselfs.????  and a way
> around it was to copy the libraries using the -d option.
> 
> SO: what works on 32 bit old K6 board, 32 bit intel board with smp
> kernel and amd 64bit is: remove any existing kylix3 files and
> directories and links ( fresh start ).  remove "/usr/lib/kylix3"
> from /etc/ld.so.config remove any files libbor* from /lib Install
> the suse 8.2 rpm from sourceforge, remove "/usr/lib/kylix3" from
> /etc/ld.so.config (then the key is to copy the link and library to
> /lib with no reference) cp -d /usr/lib/kylix3/* /lib cd / sbin
> ./ldconfig /usr/lib/kylix3 can be deleted now if preferred.  Not
> sure of all the why and hows here but it works.
> 
> I have not had any freezes with build 05041501 on any of the 3
> systems.  The pre-trigger feature is really nice.  The display
> speed is a lot better and on the 64 bit system seems almost like an
> analog scope.  Haven't tried it on windows yet.  I already found my
> nitemare glitch on my current microcontroller project which I was
> not able to see without the pre-trigger view of the series of
> events that set up the problem.
> 
> Thank you, Thank you, Thank you.
> :-)    Ken
 
 --------------------------------------------------------------------

 OPERATING INSTRUCTIONS
 ----------------------
 
 You will have received  printed documentation with your BitScope PDF
 copies of  which are  also on the  CD-ROM. For those  who downloaded
 this software refer please to our online operation guide:

   http://www.bitscope.com/software/dso/guide/
   
 A PDF downloadable version is also available.
 

 FEEDBACK
 --------

 This software has undergone  extensive pre-release testing and known
 bugs have  been fixed.  However, no software  is bug free  so please
 send any comments, bug reports, suggestions to dso@bitscope.com !
 
 --------------------------------------------------------------------
                 BitScope Designs. October 1, 2006.
 --------------------------------------------------------------------
