Status byte register................... Standard Event Status Register................Instrument Status Register .................. Event markers and TDMA........................................Error messages and codes ..................Execution errors....................Query errors ....................Device specific errors ..................File system errors .................... Parsing errors....................TSG4100A Series Programmer Manual...
Page 4
Table of Contents Communication errors..................Other errors ....................Appendices Appendix A: Character Charts ................. Appendix B: GPIB Interface Specification ..............Interface Functions ..................Interface Messages ..................TSG4100A Series Programmer Manual...
Preface This programmer manual covers the TSG4100A Series RF Signal Generators. It provides information on operating your generator using LAN, the General Purpose Interface Bus (GPIB), and RS-232. This manual is composed of the following sections Getting Started outlines how to use LAN, the GPIB interface, and RS-232.
Page 6
Preface TSG4100A Series Programmer Manual...
Connecting the interface You can use the LAN connector or the GPIB or RS-232 interfaces to send/receive remote commands. When using a GPIB or RS-232 interface, remember the following: TSG4100A Series Programmer Manual...
Installation Use an internet browser to access the National Instruments Web site and download the current version of NI-VISA to your PC. Unzip the downloaded file in a temporary directory of your choice and run Setup.exe. TSG4100A Series Programmer Manual...
Command Syntax This section contains information on the Standard Commands for Programmable Instruments (SCPI) and IEEE 488.2 Common Commands you can use to program your TSG4100A Series generator. The information is organized in the following subsections: Backus-Naur Form Definition Syntax IEEE 488.2 Common Commands...
Page 11
3 parameters per command. If the command buffer overflows, both the input and output buffers will be flushed and reset. If a parameter buffer overflows, a command error will be generated and the offending command discarded. TSG4100A Series Programmer Manual...
Page 12
Note that you can use either lower or upper case units and prefixes. The following examples have the same result, respectively. 170mhz, 170mHz, 170MHz, etc. 250mv, 250mV, 250MV, etc. Numeric conventions Floating point values may be decimal (‘123.45’) or scientific (‘1.2345e2’). Integer values may be decimal (‘12345’) or hexadecimal (‘0x3039’). TSG4100A Series Programmer Manual...
IEEE 488.2 Common Commands Description ANSI/IEEE Standard 488.2 defines the codes, formats, protocols, and usage of common commands and queries used on the interface between the controller and the instruments. The generator complies with this standard. TSG4100A Series Programmer Manual...
Page 14
All of the common commands and queries are listed in the last part of the Syntax and Commands section. The following are examples of common commands: *ESE 16 *CLS The following are examples of common queries: *ESR? *IDN? TSG4100A Series Programmer Manual...
Conforms to the IEEE Std 488.2. Status Controls the status and event registers. Signal Synthesis Controls signal parameters. Modulation Controls the modulation settings and parameters. Interface Controls interface settings and parameters. The following section lists the commands by group. TSG4100A Series Programmer Manual...
Sets or queries the bits in the SRER register. (?){i} *STB? Returns the contents of the SBR using the MSS bit. *TRG Generates a trigger. *TST? Self test. *WAI Prevents the generator from executing further commands. TSG4100A Series Programmer Manual...
Reset interface. IPCF? Query active TCP/IP configuration parameter. LOCK? Request the instrument lock. UNLK? Release the instrument lock previously acquired by the LOCK? command. XTRM Set the interface terminator that is appended to each response. i{,j,k} TSG4100A Series Programmer Manual...
Set (query) the ΦM deviation in degrees. PDTY Set (query) the duty factor for pulse modulation in percent. PFNC Set (query) the modulation function for pulse modulation. PNDV Set (query) the ΦM noise deviation in degrees. TSG4100A Series Programmer Manual...
Although not shown in this table, analog modulation also supports user waveforms downloaded by the user. This is achieved by setting the modulation function (MFNC or PFNC) to user waveform and selecting the desired user waveform with the WAVF command. TSG4100A Series Programmer Manual 2-10...
Thus, instead of a waveform frequency or period, there is a symbol rate (SYMR command). The digital symbols are also typically played back through pulse shaping filter characterized through the FLTR command. 2-11 TSG4100A Series Programmer Manual...
Page 21
QFNC, WAVF Pulse shaping filter FLTR, ALPH, BTEE Symbol rate SYMR Modulation index MODI Select VSB modulation TYPE 9 Select constellation STYP Modulation function QFNC, WAVF FLTR, ALPH, BTEE Pulse shaping filter Symbol rate SYMR TSG4100A Series Programmer Manual 2-12...
Basic signal configuration can be achieved by following the steps as outlined in the following table. Table 2-11: Basic signal configuration Action Relevant commands Set frequency FREQ Set amplitude AMPL, AMPR Set offset OFSL Adjust phase PHAS, RPHS 2-13 TSG4100A Series Programmer Manual...
ORNG? Query whether specified output is over its specified range. TEMP? Query the current temperature of the RF output block in degrees TIMB? Query the current timebase. TSG4100A Series Programmer Manual 2-14...
The Output Queue always contains the response message to the most recent query command. You can use the MAV bit of the Status Byte Register (SBR) to check whether the Output Queue contains a response message. For details, refer to Status Byte Register (SBR). 2-15 TSG4100A Series Programmer Manual...
Page 25
Sets or queries the excess bandwidth factor, α, for the nyquist and root-nyquist filters. Conditions Range: 0.1 to 1.0 Group Modulation commands Syntax ALPH {d} ALPH Arguments {d} is a floating point value. Returns A floating point value. TSG4100A Series Programmer Manual 2-16...
Page 26
Conditions If omitted, units default to dBm. Group Signal synthesis commands Syntax AMPR {v}[u] AMPR Arguments {v} = amplitude value as a floating point value without an exponent. [u] = unit of measure (RMS, dBm) 2-17 TSG4100A Series Programmer Manual...
Page 27
9.0, indicating that the rms noise depth is 9%. ANDP? AWGN Sets or queries the current configuration for AWGN {i}. Group Modulation commands Syntax AWGN AWGN Related Commands NPWR to configure the noise power. TSG4100A Series Programmer Manual 2-18...
Page 28
An integer. Examples might return 16, indicating that the current bits/symbol is 16. BITS? BTEE Sets or queries the current bandwidth symbol time product (BT) for Gaussian filters. Conditions Range: 0.1 to 1.0 Group Modulation commands 2-19 TSG4100A Series Programmer Manual...
Page 29
16-bit words for new waveforms is appended to the list. Group Modulation commands Syntax CATL? Returns Delta marker amplitude for the selected marker. See Examples. Examples might return 0,512,1,0,2,128,3,0,4,0,5,0,6,0,7,0,8,0,9,0,10,173696,11, CATL? 720,12,128,13,79,14,235,15,76800,1044480. In this example, SRAM has a TSG4100A Series Programmer Manual 2-20...
Page 30
The value, 0, identifies the constellation stored in SRAM. Values 1 to 9 identify user constellations stored in nonvolatile memory using the SAVC command. Group Modulation commands Syntax CNST {i} CNST? Related Commands STYP SAVC? Arguments {i} is a constellation identified as 0 through 9. 2-21 TSG4100A Series Programmer Manual...
Page 31
16-bit words. Factory loaded, read-only waveforms cannot be deleted with this command. CAUTION. Once deleted, a user waveform cannot be recovered. Conditions Range for i: 0 to 9. Group Modulation commands Syntax DELW?{i} Related Commands SAVW? TSG4100A Series Programmer Manual 2-22...
Page 32
ENBL {i} ENBL Arguments 0 = the output is disabled and turned off. 1 = the output is enabled and operating at the programmed amplitude for the output. Returns 0 when the output is disabled. 2-23 TSG4100A Series Programmer Manual...
Page 33
0 may be returned even if a 1 was sent if the output is not active at the current frequency (i.e., F <950 kHz). carrier Examples will enable the output. ENBR1 might return 0, indicating that the output is disabled. ENBR? EPHY Sets or queries the Ethernet link speed. Group Interface commands TSG4100A Series Programmer Manual 2-24...
Page 34
*ESE Sets or queries the Standard Event Status Enable register. Bits set in this register cause ESB (in STB) to be set when the corresponding bit is set in the ESR register. Group Common commands 2-25 TSG4100A Series Programmer Manual...
Page 35
ESR register. (See page 3-2.) Examples might return 176, indicating that PON, CME, and EXE are set. *ESR? FDEV Sets or queries the FM deviation. If omitted, units default to Hz. Group Modulation commands Syntax FDEV {f} FDEV? TSG4100A Series Programmer Manual 2-26...
Page 36
User filters stored in nonvolatile memory. Raised cosine filter. Root-raised cosine filter. Gaussian filter. Rectangular filter. Triangular filter (simple, linear interpolation). Kaiser windowed sinc filter. Linearized Gaussian filter (used in GSM EDGE modulation). C4FM (used in APCO 25 modulation). 2-27 TSG4100A Series Programmer Manual...
Page 37
1000, indicating the rms FM noise deviation is 1 kHz. FNDV? sets the rms FM noise deviation to 1 kHz. FNDV 1 kHz FREQ Sets or queries the carrier frequency. Conditions If omitted, units default to Hz. TSG4100A Series Programmer Manual 2-28...
Page 38
*IDN? Returns String indicating the instrument manufacturer, model, serial number, and firmware version. Examples might return *IDN? Tektronix,TSG4106A,s/nQ000001,ver2.03.26 IFCF Sets or queries the interface configuration i {to j}. Group Interface commands Syntax IFCF i{,j} IFCF? 2-29 TSG4100A Series Programmer Manual...
Page 39
RS-232 baud rate to 19200. IFCF 1,19200 sets the primary GPIB address to 16. IFCF 3,16 sets IP Address to 192.168.10.5. IFCF 11,192.168.10.5 IFRS (No Query Form) Resets the specified interface. Group Interface commands TSG4100A Series Programmer Manual 2-30...
Page 40
1 GHz PLL unlocked. 4GHZ_UNLK 4 GHz PLL unlocked. NO_TIMEBASE Installed timebase is not oscillating. RB_UNLOCK The installed Rubidium oscillator is unlocked. — Reserved MOD_OVLD Modulation overloaded. IQ_OVLD IQ modulation overloaded. — 10-15 Reserved Returns See Arguments. 2-31 TSG4100A Series Programmer Manual...
Page 41
10-15 Reserved Examples might return 08, indicating that a modulation overload was detected and INSR? the 20 MHz PLL came unlocked. IPCF? (Query Only) Queries the active TCP/IP configuration. Group Interface commands Syntax IPCF? i TSG4100A Series Programmer Manual 2-32...
Page 42
Requests the instrument lock and returns the result. When the lock is granted, no other instrument interface, including the front panel interface, may alter instrument settings until the lock is released with the UNLK command. Group Interface commands Syntax LOCK? Related Commands UNLK? 2-33 TSG4100A Series Programmer Manual...
Page 43
Sets or queries the modulation index for CPM. The modulation index is stored as a 3 digit floating point decimal. However, when applied to the modulation, it will be rounded to the nearest rational factor, n/512, where n is an integer. TSG4100A Series Programmer Manual 2-34...
Page 44
Syntax MODL MODL Arguments 0 disables modulation. 1 enables modulation. Returns 0 means modulation is disabled. 1 means modulation is enabled. Examples enables modulation. MODL 1 might return 0, indicating that modulation is disabled. MODL? 2-35 TSG4100A Series Programmer Manual...
Page 45
GSM EDGE. MPRE 8 MODL enables the GSM EDGE modulation set in the previous command. NOIS Sets or queries the RF PLL loop filter mode for the instrument. Group Signal synthesis commands Syntax NOIS NOIS? TSG4100A Series Programmer Manual 2-36...
Page 46
OFSI Sets or queries the current offset for I in IQ modulation in percent. IQ offsets only apply to internally generated IQ waveforms Conditions Offset range: –5.0% to +5.0% 2-37 TSG4100A Series Programmer Manual...
Page 47
–0.5, indicating the offset voltage. OFSL? OFSQ Sets or queries the current offset for Q in IQ modulation in percent. IQ offsets only apply to internally generated IQ waveforms. Conditions Offset range: –5.0% to +5.0% TSG4100A Series Programmer Manual 2-38...
Page 48
ESR register. Group Common commands Syntax *OPC *OPC? Arguments None. Returns 1 means all prior commands have completed. ORNG? (Query Only) Queries whether output i is over its specified range. Group Status commands Syntax ORNG? {i} 2-39 TSG4100A Series Programmer Manual...
Page 49
Sets queries the duty factor for pulse modulation in percent. This value controls pulse modulation when the selected waveform is square (see ). Use PFNC PWID? determine the actual pulse width in time. Group Modulation commands Syntax PDTY {d} PDTY? TSG4100A Series Programmer Manual 2-40...
Page 50
The parameter {i} may be set to one of the following values: Modulation function Square Noise (PRBS) External User waveform Returns See Arguments. Examples sets the modulation function to Square. PFNC 3 might return 5, indicating that the modulation function is External. PFNC? 2-41 TSG4100A Series Programmer Manual...
Page 51
PDEV Group Modulation commands Syntax PNDV {p} PNDV? Related Commands PDEV for all modulation functions other than noise. Arguments {p} is a floating point value. Returns A floating point value. TSG4100A Series Programmer Manual 2-42...
Page 52
Sets or queries the PRBS length for pulse modulation. This value controls pulse modulation when the selected waveform is noise (see PFNC Conditions Range: 5 to 32 Group Modulation commands Syntax PRBS {i} PRBS? Related Commands PFNC 2-43 TSG4100A Series Programmer Manual...
Page 53
0 means the SRE and ESE are stored. 1 means the SRE and ESE are cleared at power-cycle. Examples sets the power-on status clear to 1. *PSC 1 might return 1, indicating that the power-on status clear is set to 1. *PSC? TSG4100A Series Programmer Manual 2-44...
Page 54
Arguments {t} is a floating point value. [u] (If omitted, units default to seconds.) Returns A floating point value that is the pulse width in seconds. Examples sets the pulse width to 1 μs. PWID1e–6 2-45 TSG4100A Series Programmer Manual...
Page 55
Sets or queries the modulation rate. If units are omitted, units default to Hz. This command also controls the noise bandwidth if a noise function is selected for the given type of modulation. Group Modulation commands TSG4100A Series Programmer Manual 2-46...
Page 56
Examples recalls instruments settings from location 3. *RCL 3 RPER Sets or queries the PRBS period for pulse modulation. This value controls pulse modulation when the selected waveform is noise (see PFNC Group Modulation commands 2-47 TSG4100A Series Programmer Manual...
Page 57
None *RST (No Query Form) Reset the instrument to default settings. This is equivalent to *RCL 0. You can read more about default settings in the TSG4100A Series RF Signal Generator User Manual available for download at www.tektronix.com/manuals. Group Common commands...
Page 58
SRAM to location 3 in nonvolatile SAVC? 3 memory. SAVF? (Query Only) Saves the user filter stored in SRAM to the specified location in nonvolatile memory and returns an error code when complete. 2-49 TSG4100A Series Programmer Manual...
Page 59
As the scale factor is decreased, the amplitude of the waveform will be decreased, but it will also be more susceptible to quantization noise. TSG4100A Series Programmer Manual 2-50...
Page 60
{i} corresponds to the bits in the Status Byte register (STB), defined as follows: Name Meaning INSB An unmasked bit in the instrument status register (INSR) has been set. Reserved Not used. Reserved Not used. Reserved Not used. The interface output buffer is non-empty. 2-51 TSG4100A Series Programmer Manual...
Page 61
Queries the standard IEEE 488.2 serial poll status byte. Group Common commands Syntax *STB? Returns The bits in the STB register have the following meaning: Name Meaning INSB INSR summary bit — Reserved — Reserved — Reserved Message available TSG4100A Series Programmer Manual 2-52...
Page 62
Modulation commands Syntax STYP {i} STYP? Arguments The parameter i may be set to one of the following values: Modulation subtype Analog (no constellation mapping) Vector (no constellation mapping) Default 1-bit constellation Default 2-bit constellation 2-53 TSG4100A Series Programmer Manual...
Page 63
{i} is a floating point value. (If omitted, units [u] default to Hz.) Returns A floating point value. Examples sets the symbol rate to 270.833 kHz. SYMR 270.833e3 set the symbol rate to 10 kHz. SYMR10 kHz TSG4100A Series Programmer Manual 2-54...
Page 64
TDMA is enabled; bits 11-8 indicate a ramp period of 2 symbols; and bits 17-16 indicate that the RF power is controlled by event marker #3. TEMP? (Query Only) Queries the current temperature of the RF output block in degrees C. Group Status commands Syntax TEMP? 2-55 TSG4100A Series Programmer Manual...
Page 65
Crystal timebase OCXO timebase Rubidium timebase External timebase *TRG (No Query Form) This command initiates a trigger. Group Common commands Syntax *TRG Arguments None. *TST? (Query Only) Runs the instrument self test. Group Common commands TSG4100A Series Programmer Manual 2-56...
Page 66
The parameter i may be set to one of the following values: Modulation type AM/ASK FM/FSK ΦM/PSK Pulse Returns See Arguments. Examples The following sequence would configure the modulation. sets the modulation type to phase modulation. TYPE 2 2-57 TSG4100A Series Programmer Manual...
Page 67
*WAI continuing. WAVF Sets or queries the current user waveform. Note that the user waveform is only active when the modulation function is set to user waveform (11). Group Modulation commands TSG4100A Series Programmer Manual 2-58...
Page 68
( MPRE command). Examples selects user waveform 2 for modulation. WAVF 2 WRTC (No Query Form) Writes the given user constellation to SRAM. Group Modulation commands Syntax WRTC i,j,<arb data> 2-59 TSG4100A Series Programmer Manual...
Page 69
filter. <arb data> = a definite arbitrary block of binary data defining the event marker for the configuration. WRTW (No Query Form) Write the given user waveform to SRAM. Group Modulation commands TSG4100A Series Programmer Manual 2-60...
Page 70
13, 10, which is a carriage return followed by a line feed. Group Interface commands Syntax XTRM i,j,k Arguments The default terminator is 13, 10, which is a carriage return followed by a line feed. 2-61 TSG4100A Series Programmer Manual...
An unmasked bit in the instrument status register (INSR) has been set. Reserved Not used. Reserved Not used. Reserved Not used. The interface output buffer is non-empty. An unmasked bit in the standard event status register (*ESR) has been set. TSG4100A Series Programmer Manual...
Command error. The parser detected a syntax error. Execution error. A command failed to execute correctly because a parameter was invalid. Device dependent error occurred. Query error occurred. Reserved Not used. Operation complete. All previous commands have completed. See command *OPC. TSG4100A Series Programmer Manual...
After each successful symbol count comparison, the next configuration word is loaded, until the repeat bit is set, at which point the symbol counter is reset and the first configuration word TSG4100A Series Programmer Manual...
Page 75
Marker 3. The individual event configuration words are defined in the first table in the Event Markers and TDMA section. Each 32-bit configuration word must be formatted as big-endian for the transmission. (See page 3-3.) TSG4100A Series Programmer Manual...
The requested action failed because the rear RF doubler option is not installed. No IQ option The requested action failed because the rear IQ option is not installed. Failed self test This value is returned by the *TST? command when the self test fails. TSG4100A Series Programmer Manual...
Failed 100 MHz PLL The test of the 100 MHz PLL failed. Failed 19 MHz PLL The test of the 19 MHz PLL failed. Failed 1 GHz PLL The test of the 1 GHz PLL failed. TSG4100A Series Programmer Manual...
File has been corrupted. End of file Cannot read passed the end of the file. File locked Cannot access a file because it is locked by another user. Parsing errors These error codes occur when commands are improperly parsed. TSG4100A Series Programmer Manual...
Page 79
The parser detected a syntax error in the command. Illegal units The units supplied with the command are not allowed. Missing units The units required to execute the command were missing. Communication errors These error codes occur when communication is disrupted for some reason. TSG4100A Series Programmer Manual...
Page 80
flushed. Other errors These error codes occur for various reasons. Table 3-10: Other errors Error code Error message Too many errors The error buffer is full. Subsequent errors have been dropped. TSG4100A Series Programmer Manual...
Page 83
Appendix A: Character Charts TSG4100A Series Programmer Manual...
Page 84
Appendix A: Character Charts TSG4100A Series Programmer Manual...
Page 85
Unaddress if my talk address (MTA) No Listen Only mode Service Request (SR) Complete Remote/Local (RL) None Parallel Poll (PP) None Device Clear (DC) Complete Device Trigger (DT) None Controller (C) None Electrical Interface Three-state driver TSG4100A Series Programmer Manual...
Page 86
E1 means the electrical interface uses open collector drivers, E2 means the electrical interface uses three-state drivers. Interface Messages Table B-2: Standard interface messages Message Type Implemented Device Clear (DCL) Local Lockout (LLO) Serial Poll Disable (SPD) Serial Poll Enable (SPE) TSG4100A Series Programmer Manual...
Page 87
Disable (PPD), which are placed on the bus following the PPC command. PPE enables a device with parallel poll capability to respond on a particular data line. PPD disables the device from responding to the parallel poll. TSG4100A Series Programmer Manual...
Need help?
Do you have a question about the TSG4100A Series and is the answer not in the manual?
Questions and answers