TRACe[:DATA]:DIGital:FUNCtion

34980A

TRACe[:DATA]:DIGital:FUNCtion

Syntax

TRACe[:DATA]:DIGital:FUNCtion (@<channel>), <type>, <name>, <points>

Description

This command generates and downloads one of two built-in traces to the specified bank on the 34950A Digital I/O Module. Choose from a "count up" pattern (0, 1, 2, 3, ...) or a "walking ones" pattern (00000001, 00000010, 00000100, ...).

You can generate a "count down" or "walking zero" pattern by inverting the data line polarity (see CONFigure:DIGital:POLarity command).

Parameters

Name

Type

Range of Values

Default Value

<channel>

Numeric

One channel in the form (@sccc).
Select from s101 or s201.

This is a required parameter

<type>

Discrete

{COUNt|WONes}

This is a required parameter

<name>

ASCII String

A trace name consisting of up to 12 characters. The first character must be a letter (A-Z), but the remaining 11 characters can be letters, numbers (0-9), or an underscore ( _ ). Blank spaces are not allowed.

The name must be unique to the specified channel (bank).

This is a required parameter

<points>

Numeric

The length of the trace in number of samples, and must fit in the available space.

1,000 sample points

Remarks

  • Each bank has its own memory (64K bytes each) for use in buffered output transfers. You can download up to 32 traces into each bank. Use the TRACe:DELete[:NAME] command to delete traces from memory.

  • The direction and width of memory operations are determined by the first channel on the bank.

  • If the specified number of samples is greater than the amount of available memory on the module, an error will be generated.

  • If you change the width of a bank (see CONFigure:DIGital:WIDTh command), all traces in memory are cleared.

  • Downloading a trace to the module while memory is enabled is not allowed (see SOURce:DIGital:MEMory:ENABle command).

  • After downloading the trace to memory, use the SOURce:DIGital:MEMory:TRACe command to select the active trace and the SOURce:DIGital:MEMory:ENABle command to enable the trace mode.

  • If a trace is not currently assigned to the specified bank, the downloaded trace will become the assigned trace.

  • A Factory Reset (*RST command), Instrument Preset (SYSTem:PRESet command), and Card Reset (SYSTem:CPON command) deletes the trace from memory and removes all trace name associations. In addition, storing the instrument state (*SAV command) will delete the trace from memory and remove all trace name associations.

Example

The following program segment downloads and outputs a "walking ones" pattern from channel 101 on the module in slot 3. The length of the trace is set to 32 samples. In addition, the cycle count is set to output the complete trace three times. Once memory is enabled, a software trigger is used to trigger the memory output.  

SOUR:DIG:DATA:WORD #HFFFF,(@3101)  !Set initial output pattern
SOUR:DIG:MEM:NCYC 3,(@3101)  !Output complete trace 3 times
TRAC:DIG:FUNC (@3101),WONES,PATTERN_1,32
 !Download "walking ones" pattern
SOUR:DIG:MEM:TRAC PATTERN_1,(@3101)  !Assign trace to channel 101
SOUR:DIG:MEM:ENAB ON,(@3101)  !Enable memory on channel 101
SOUR:DIG:MEM:START (@3101)  !Trigger memory output

See Also

SOURce:DIGital:MEMory:CYCLes

SOURce:DIGital:MEMory:ENABle

SOURce:DIGital:MEMory:TRACe

TRACe:CATalog?

TRACe[:DATA]:DIGital[:<width>]

TRACe:DELete[:NAME]