The tds3000 device support is a general purpose facility for interfacing to all the oscilloscopes in the TDS 3000 series. The intent of this device support is to provide an interface though EPICS that had a simple user interface. All of the main controls on the these scopes are provided with an easy to use displays. These displays have been developed with MEDM which has been a proven and reliable display manager for EPICS.

Interfacing to these scopes can be accomplished though GPIB, Serial and Ethernet. All three can use the new  asynDriver which is a general purpose facility for interfacing device specific code to low level communication drivers.

This version provides

• TDS3000 device  support for GPIB, serial and ethernet though the asynManager, i.e. the software layer between device support and drivers.
• Three models in the 3000 series has been tested, TDS3034B, TDS3014B and TDS3054 with an TDS3EM ethernet module.
• EPICS version R3.14.7 and higher.
• Device support is configured for 10k data points.

History

Eric Norum

Who had helped me convert the TDS3054 device support, which only supported GPIB, to the TDS3000 device support which uses the asynDriver.

Scope time settings.

Scopes trigger settings.

Scopes acquisition control and waveform readbacks.
Note: n is 1 to 4.

Scopes misc functions.

Scopes print commands and print status, front panel display controls.
Note: These pvs are also used in the AutoPrint SNL program.

Waveform data in raw format, not scaled.
By default, these pvs are disabled.

Waveform preamble information
Note: These fields are provided for diagnostics. All other pvs must stop scanning. Then the DAT:SOURCE
command must issued to select the channel to view.

Back

Generic MEDM displays were created to mimic the TDS3000 series front panel scope controls. Most of the basic functions of the scope will be found in these display. Each display is shown below with a brief description.

STATUS Display:
This display shows the status for all four channels. Each channel is color matched to the scope traces.
In this display a Multi waveform mode is displayed to allow each channel to have its own vertical
scale. A single waveform display mode can be selected by selecting the SCOPE DISPLAY menu.
This mode is not shown.

VERTICAL Display:
This display gives the user access to each channels vertical settings. Each channel can be turned ON
or OFF in addition to changing the characteristics of each channel.

HORIZONTAL Display:
This display has a reduced set of commands to control the horizontal settings. If finer adjustments are
needed or other options need to be set, then the user needs to make the adjustments via the local scope
front panel or other remote options. See Other Remote Option for more details.

TRIGGER Display:
This display provides the basic trigger function of the scope.

ACQUIRE Display:
This display controls the acquisition of the scope. Two modes are provided, single sequence and normal
mode. In Single Sequence mode, the Normal acquisition controls are disabled to prevent the user from
interferring with single sequence operation. To place the scope in single sequence mode, select
SEQUENCE and then click on "Single SQ" button. The single sequence armed indicator should come
on in about 5 seconds. Once a trigger is received, the displays will update in about 5 to 10 seconds. This
is due to the scan rate being set to 5 seconds. In most cases this will not be an issue since single sequence
mode is used to capture a very inferquent event. If however a faster update is desired, change pv
$(scope)readScaledWfsCC.SCAN field to a faster rate. SRQs would be nicer, but this was originaly
developed using the EPICS GPIB support interfacing to an NI-1014 VME module. The SRQ never realy
worked for the Tektronic scopes, so this scope package just simply polls the Acquire and Trigger
status. Once the scope has triggered, the waveforms are acquired and then the MEDM display is updated.

Normal mode has a RUN and STOP buttons to control the waveform acquisition. A scan rate menu
is provided to control the update rate of the waveforms. An old legacy function called Stop/Read/Run
is provided to pause the update cycle to insure all four waveforms are read with the same trigger event.
The number below the Erase button is the delay value in seconds from the time the last waveform is read
from the scope to the time the scope is set to RUN state again.

The Erase button will only erase the MEDM waveforms being displayed. This function will not erase the
waveforms at the scope.

The AutoSet button will change the vertical and horizontal setting to match the current channel input
signals.

The Reset button will issue the *RST command followed by $(scope)initBO pv which will reconfigure
the scopes operating parameters. This command will not change the vertical or horizontal settings.

UTILITY Display:
This display provides access printer functions and configuration functions. The Configure Printer
button does the following: Ink saver ON, landscape, color waveforms, ethernet port and format set to
EPSCOLOR. The first three parameter is set by $(scope)printerSetupBO record. The ethernet port is
selected by $(scope)printerPortMO and the format is selected by $(scope)printerFormatMO. Use these
records to change the default settings.

Also, a network printer must be configured on the scope if a network printer is used.

A special record type call asynRecord is provided. It is recommended to use this record as shown in the st.cmd file.  Details are described in asynRecord. This section provides a brief description of how to use it.

Each IOC can load one or more instances of asynRecord. An example is:

cd ${ASYN}
dbLoadRecords("db/asynRecord.db","P=asyn,R=Test,PORT=L0,ADDR=15,IMAX=0,OMAX=0")

The example creates a record with name "asynTest" (formed from the concatenation of the P and R macros) that will connect to port "L0" and addr 15. After the ioc is started, it is possible to change PORT and/or ADDR. Thus a single record can be used to access all asyn devices connected to the IOC. Multiple records are only needed if one or more devices need a dedicated record.

An medm display is available for accessing an asynRecord. It is started as follows:

cd <asyn>/medm
medm -x -macro "P=asyn,R=Test" asynRecord.adl

The following medm display appears.

Copyright (c) 2005 University of Chicago All rights reserved.
tds3000 is distributed subject to the following license conditions:

SOFTWARE LICENSE AGREEMENT
Software: tds3000

 1. The "Software", below, refers to tds3000 (in either source code, or
    binary form and accompanying documentation). Each licensee is
    addressed as "you" or "Licensee."

 2. The copyright holders shown above and their third-party licensors
    hereby grant Licensee a royalty-free nonexclusive license, subject to
    the limitations stated herein and U.S. Government license rights.

 3. You may modify and make a copy or copies of the Software for use
    within your organization, if you meet the following conditions:
      a. Copies in source code must include the copyright notice and this
         Software License Agreement.
      b. Copies in binary form must include the copyright notice and this
         Software License Agreement in the documentation and/or other
         materials provided with the copy.

 4. You may modify a copy or copies of the Software or any portion of it,
    thus forming a work based on the Software, and distribute copies of
    such work outside your organization, if you meet all of the following
    conditions:
      a. Copies in source code must include the copyright notice and this
         Software License Agreement;
      b. Copies in binary form must include the copyright notice and this
         Software License Agreement in the documentation and/or other
         materials provided with the copy;
      c. Modified copies and works based on the Software must carry
         prominent notices stating that you changed specified portions of
         the Software.

 5. Portions of the Software resulted from work developed under a U.S.
    Government contract and are subject to the following license: the
    Government is granted for itself and others acting on its behalf a
    paid-up, nonexclusive, irrevocable worldwide license in this computer
    software to reproduce, prepare derivative works, and perform publicly
    and display publicly.

 6. WARRANTY DISCLAIMER. THE SOFTWARE IS SUPPLIED "AS IS" WITHOUT WARRANTY
    OF ANY KIND. THE COPYRIGHT HOLDERS, THEIR THIRD PARTY LICENSORS, THE
    UNITED STATES, THE UNITED STATES DEPARTMENT OF ENERGY, AND THEIR
    EMPLOYEES: (1) DISCLAIM ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
    BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
    FOR A PARTICULAR PURPOSE, TITLE OR NON-INFRINGEMENT, (2) DO NOT ASSUME
    ANY LEGAL LIABILITY OR RESPONSIBILITY FOR THE ACCURACY, COMPLETENESS,
    OR USEFULNESS OF THE SOFTWARE, (3) DO NOT REPRESENT THAT USE OF THE
    SOFTWARE WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS, (4) DO NOT WARRANT
    THAT THE SOFTWARE WILL FUNCTION UNINTERRUPTED, THAT IT IS ERROR-FREE
    OR THAT ANY ERRORS WILL BE CORRECTED.

 7. LIMITATION OF LIABILITY. IN NO EVENT WILL THE COPYRIGHT HOLDERS, THEIR
    THIRD PARTY LICENSORS, THE UNITED STATES, THE UNITED STATES DEPARTMENT
    OF ENERGY, OR THEIR EMPLOYEES: BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
    CONSEQUENTIAL, SPECIAL OR PUNITIVE DAMAGES OF ANY KIND OR NATURE,
    INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS OR LOSS OF DATA, FOR ANY
    REASON WHATSOEVER, WHETHER SUCH LIABILITY IS ASSERTED ON THE BASIS OF
    CONTRACT, TORT (INCLUDING NEGLIGENCE OR STRICT LIABILITY), OR
    OTHERWISE, EVEN IF ANY OF SAID PARTIES HAS BEEN WARNED OF THE
    POSSIBILITY OF SUCH LOSS OR DAMAGES.

Back