HP 16500C - Manual

2 Programming Over HP-IB Interface Capabilities 2–3Command and Data Concepts 2–3Talk/Listen Addressing 2–3HP-IB Bus Addressing 2–4Local, Remote, and Local Lockout 2–5Bus Commands 2–6 3 Programming Over RS-232-C Interface Operation 3–3RS-232-C Cables 3–3Minimum Three-Wire Interface with Software Prot...

5 Programming and Documentation Conventions Truncation Rule 5–3Infinity Representation 5–4Sequential and Overlapped Commands 5–4Response Generation 5–4Syntax Diagrams 5–4Notation Conventions and Definitions 5–5The Command Tree 5–6Tree Traversal Rules 5–8Command Set Organization 5–10Subsystems 5–10Pr...

8 Error Messages Device Dependent Errors 8–3Command Errors 8–3Execution Errors 8–4Internal Errors 8–4Query Errors 8–5 Part 2 Commands 9 Common Commands *CLS (Clear Status) 9–5*ESE (Event Status Enable) 9–6*ESR (Event Status Register) 9–7*IDN (Identification Number) 9–9*IST (Individual Status) 9–9*OP...

MESE<N> (Module Event Status Enable) 10–16MESR<N> (Module Event Status Register) 10–18RMODe 10–19RTC (Real-time Clock) 10–20SELect 10–21SETColor 10–23STARt 10–24STOP 10–25XWINdow 10–26 11 SYSTem Subsystem DATA 11–5DSP (Display) 11–6ERRor 11–7HEADer 11–8LONGform 11–9PRINt 11–10SETup 11–12...

REName 12–22STORe [:CONFig] 12–23UPLoad 12–24VOLume 12–25 13 INTermodule Subsystem :INTermodule 13–5DELete 13–6HTIMe 13–7INPort 13–8INSert 13–9OUTDrive 13–10OUTPolar 13–10OUTType 13–11PORTEDGE 13–12PORTLEV 13–13SKEW<N> 13–14TREE 13–15TTIMe 13–17 14 TGTctrl Subsystem :TGTctrl 14–5ALL 14–6AVAILa...

Part 3 Programming Examples 15 Programming Examples Transferring the Mainframe Configuration 15–3Checking for Intermodule Measurement Completion 15–6Sending Queries to the Logic Analysis System 15–7Getting ASCII Data with PRINt? ALL Query 15–9Reading the disk with the CATalog? ALL query 15–10Reading...

Part 1 1 Introduction to Programming 1-1 2 Programming Over HP-IB 2-1 3 Programming Over RS-232-C 3-1 4 Programming Over LAN 4-1 5 Programming and Documentation Conventions 5-1 6 Message Communication and System Functions 6-1 7 Status Reporting 7-1 8 Error Messages 8-1 General Information

Introduction This chapter introduces you to the basics of remote programming andis organized in two sections. The first section, "Talking to the LogicAnalysis System," concentrates on initializing the bus, program syntaxand the elements of instruction syntax. The second section,"Receivin...

Talking to the Logic Analysis System In general, computers acting as controllers communicate with the instrumentby sending and receiving messages over a remote interface, such as HP-IB,RS-232-C, or Ethernet LAN. When programming the HP 16500C with the HP 16501A Expansion Frameconnected, most of the ...

Talking to Individual System Modules Talking to individual system modules within the HP 16500C Logic AnalysisSystem is done by preceding the module commands with the SELECTcommand and the number of the slot in which the desired module is installed.The mainframe is selected in the same way as an inst...

Instruction Syntax To program the system remotely, you must have an understanding of thecommand format and structure. The IEEE 488.2 standard governs syntaxrules pertaining to how individual elements, such as headers, separators,parameters and terminators, may be grouped together to form completeins...

Device Address The location where the device address must be specified also depends on thehost language that you are using. In some languages, this could be specifiedoutside the output command. In BASIC, this is always specified after thekeyword OUTPUT. The examples in this manual use a generic addr...

When you look up a query in this programmer’s reference, you’ll find aparagraph labeled "Returned Format" under the one labeled "Query." Thesyntax definition by "Returned Format" will always show the instructionheader in square brackets, like [:SYSTem:MENU] , which means the ...

Header Types There are three types of headers: simple command, compound command,and common command. Simple Command Header Simple command headers contain a single keyword. START and STOP areexamples of simple command headers. The syntax is: <function><terminator> When parameters (indicate...

Common Command Header Common command headers control IEEE 488.2 functions within the logicanalyzer such as clear status. The syntax is: *<command header><terminator> No white space or separator is allowed between the asterisk and thecommand header. Example *CLS Combined Commands in the S...

Query Usage Logic analysis system instructions that are immediately followed by aquestion mark (?) are queries. After receiving a query, the Logic AnalysisSystem parser places the response in the output buffer. The output messageremains in the buffer until it is read or until another instruction is ...

Program Header Options Program headers can be sent using any combination of uppercase orlowercase ASCII characters. System responses, however, are alwaysreturned in uppercase. Both program command and query headers may be sent in either long form(complete spelling), short form (abbreviated spelling)...

Parameter Data Types There are three main types of data which are used in parameters. The typesare numeric, string, and keyword. A fourth type, block data, is used only for afew instructions: the DATA and SETup instructions in the SYSTem subsystem (see chapter 11); the CATalog , UPLoad , and DOWNloa...

Selecting Multiple Subsystems You can send multiple program commands and program queries for differentsubsystems within the same selected module on the same line by separatingeach command with a semicolon. The colon following the semicolon enablesyou to enter a new subsystem. <instruction header&...

Receiving Information from the Logic AnalysisSystem After receiving a query (logic analysis system instruction followed bya question mark), the system interrogates the requested function andplaces the answer in its output queue. The answer remains in theoutput queue until it is read or until another...

Response Header Options The format of the returned ASCII string depends on the current settings ofthe SYSTEM HEADER and LONGFORM commands. The general format is <instruction_header><space><data><terminator> The header identifies the data that follows (the parameters) and is c...

Response Data Formats Both numbers and strings are returned as a series of ASCII characters, asdescribed in the following sections. Keywords in the data are returned in thesame format as the header, as specified by the LONGform command. Likethe headers, the keywords will always be in uppercase. Exam...

String Variables Because there are so many ways to code numbers, the HP 16500C LogicAnalysis System handles almost all data as ASCII strings. Depending on yourhost language, you may be able to use other types when reading in responses. Sometimes it is helpful to use string variables in place of cons...

Example The following example shows logic analyzer module data being returned to astring variable with headers off: 10 OUTPUT XXX;":SYSTEM:HEADER OFF" 20 DIM Rang$[30] 30 OUTPUT XXX;":SELECT 2:MACHINE1:TWAVEFORM:RANGE?" 40 ENTER XXX;Rang$ 50 PRINT Rang$ 60 END After running this prog...

Example The following example shows logic analyzer module data being returned to anumeric variable. 10 OUTPUT XXX;":SYSTEM:HEADER OFF" 20 OUTPUT XXX;":SELECT 2:MACHINE1:TWAVEFORM:RANGE?" 30 ENTER XXX;Rang 40 PRINT Rang 50 END This time the format of the number (whether or not exponen...

For example, for transmitting 80 bytes of data, the syntax would be: Figure 1-2 Definite-length Block Response Data The "8" states the number of digits that follow, and "00000080" states thenumber of bytes to be transmitted, which is 80. Multiple Queries You can send multiple queries...

Example The response of the query :SYSTEM:HEADER?:LONGFORM? with HEADERand LONGFORM turned on is: :SYSTEM:HEADER 1;:SYSTEM:LONGFORM 1 If you do not need to see the headers when the numeric values are returned,then you could use numeric variables. When you are receiving numeric datainto numeric varia...

Interface Capabilities The interface capabilities of the HP 16500C, as defined by IEEE 488.1 areSH1, AH1, T5, TE0, L3, LE0, SR1, RL1, PP0, DC1, DT1, C0, and E2. Command and Data Concepts The HP-IB has two modes of operation: command mode and data mode. Thebus is in command mode when the ATN line is ...

Bus Commands The following commands are IEEE 488.1 bus commands (ATN true). IEEE488.2 defines many of the actions which are taken when these commands arereceived by the system. Device Clear The device clear (DCL) or selected device clear (SDC) commands clear theinput and output buffers, reset the pa...

Introduction This chapter describes the interface functions and some generalconcepts of RS-232-C. The RS-232-C interface on this instrumentis Hewlett-Packard’s implementation of EIA Recommended StandardRS-232-C, Interface Between Data Terminal Equipment and Data Communications Equipment Employing Se...

Interface Operation The HP 16500C Logic Analysis System can be programmed by a controllerover RS-232-C using either a minimum three-wire or extended hardwireinterface. The operation and exact connections for these interfaces aredescribed in more detail in the following sections. When you are control...

Minimum Three-Wire Interface with Software Protocol With a three-wire interface, the software (as compared to interfacehardware) controls the data flow between the Logic Analysis System and thecontroller. Because the three-wire interface provides no hardware means tocontrol data flow between the con...

Extended Interface with Hardware Handshake With the extended interface, both the software and the hardware can controlthe data flow between the Logic Analysis System and the controller. TheLogic Analysis System uses the following connections on its RS-232-Cinterface for extended interface communicat...

lines will disable the Logic Analysis System data transmission. Pulling theCTS line low during data transmission will stop Logic Analysis System datatransmission immediately. Pulling either the DSR or DCD line low duringdata transmission will stop Logic Analysis System data transmission, but asmany ...

HP Vectra Personal Computers and Compatibles Figure 3-2 gives an example of a cable that will work for the extendedinterface with hardware handshake. Keep in mind that this cable shouldwork if your computer’s serial interface supports the four common RS-232-Chandshake signals as defined by the RS-23...

Interface Capabilities The baud rate, stop bits, parity, protocol, and data bits must be configuredexactly the same for both the controller and the Logic Analysis System toproperly communicate over the RS-232-C bus. The RS-232-C interfacecapabilities of the HP 16500C Logic Analysis System are listed...

The controller and the HP 16500C Logic Analysis System must be in thesame bit mode to properly communicate over the RS-232-C. This means thatthe controller must have the capability to send and receive 8-bit data. See Also For more information on the RS-232-C interface, refer to the HP 16500C Logic A...

Lockout Command To lockout the front-panel controls, use the SYSTem command LOCKout.When this function is on, all controls (except the power switch) are entirelylocked out. Local control can only be restored by sending the :LOCKout OFF command. Hint Cycling the power will also restore local control,...

Communicating with the HP 16500C You can communicate with the HP 16500C in several ways. If you NFSmount your logic analysis system, it behaves like a disk drive on your LANand programs control it by writing to the \system\program file. The other common way to control the instrument is through telne...

Password Protection and File Protection There is no protection or security built into the HP 16500C. If you attempt toconnect to the logic analysis system via FTP, and you are prompted for apassword, leave the password field blank. The operating system files, which are stored in the \system director...

Controlling the HP 16500C To control the HP 16500C Logic Analysis System with programmingcommands, you can either write the commands to \system\program , or open a socket in a C program. Either way, the controller in the SystemConfiguration menu must be set to LAN. In order to send programming comma...

Echoing Commands To send a command directly from the command line or prompt of your PC orworkstation to the HP 16500C system, echo a text string containing thecommand to the file location \system\program . In order to send commands to the HP 16500C system parser, you must beconnected to the system a...

Copying Command Files To control the HP 16500C system with longer sets of commands, you can firsttype the commands into an ASCII file. You then copy the file to the HP 16500program file, at location \system\program . Files copied to this file location are passed on to the HP 16500C system’s command ...

Writing to \system\program from a Program You can send commands to the HP 16500C program file from a programrunning on your PC or workstation. The basic procedure is to open theprogram file and send text strings containing the commands to the file. In C,you can use the fwrite or putstr commands to w...

Example The following example in C opens the \system\program file and sends several commands and queries. Responses to queries appear as text stringsin \system\program . The HP 16500C has been NFS-mounted in the \users directory. #include <stdio.h> #include <unistd.h> #define STR_LEN 80 ...

Sending Commands to the HP 16500C Socket If you are programming in C, you can use a socket to communicate with theHP 16500 system. By opening a socket connection, you can send programcommands directly to the command parser. The HP 16500C system socketport identification number is 5025. You can also ...

Truncation Rule The truncation rule for the keywords used in headers and parameters is: • If the long form has four or fewer characters, there is no change in theshort form. When the long form has more than four characters the shortform is just the first four characters, unless the fourth character ...

Infinity Representation The representation of infinity is 9.9E+37 for real numbers and 32767 forintegers. This is also the value returned when a measurement cannot bemade. Sequential and Overlapped Commands IEEE 488.2 makes the distinction between sequential and overlappedcommands. Sequential comman...

on the entry line. Any combination of commands and arguments that can begenerated by following the lines in the proper direction is syntacticallycorrect. An argument is optional if there is a path around it. When there is arectangle which contains the word "space," a white space character mu...

The Command Tree The command tree (figure 5-1) shows all commands in the HP 16500C LogicAnalysis System and the relationship of the commands to each other. Youshould notice that the common commands are not actually connected to theother commands in the command tree. After a <NL> (linefeed - AS...

Tree Traversal Rules Command headers are created by traversing down the command tree. Alegal command header from the command tree in figure 5-1 would be :MMEMORY:INITIALIZE . This is referred to as a compound header. As shown on the tree, branches are always preceded by colons. Do not addspaces arou...

Command Set Organization The command set for the HP 16500C Logic Analysis System mainframe isdivided into 6 separate groups as shown in figure 5-1. The command groupsare: common commands, mainframe commands, and 4 sets of subsystemcommands. In addition to the command tree in figure 5-1, a command to...

Table 5-1 Alphabetic Command Cross-Reference Command Subsystem Command Subsystem Command Subsystem *CLS Common DATA SYSTem PORTEDGE INTermodule *ESE Common DELete INTermodule PORTLEV INTermodule *ESR Common DOWNload MMEMory PRINt SYSTem *IDN Common DRIVe TGTctrl PULSe TGTctrl *IST Common DSP SYSTem ...

Program Examples The program examples in chapter 15, "Programming Examples," were writtenon an HP 9000 Series 300 controller using the HP BASIC 6.2 language. Theprograms always assume a generic address for the HP 16500C Logic AnalysisSystem of 707. The shorter examples given in the reference...

Protocols The protocols of IEEE 488.2 define the overall scheme used by the controllerand the instrument to communicate. This includes defining when it isappropriate for devices to talk or listen, and what happens when the protocolis not followed. Functional Elements Before proceeding with the descr...

Protocol Overview The instrument and controller communicate using program messages andresponse messages. These messages serve as the containers into which setsof program commands or instrument responses are placed. Programmessages are sent by the controller to the instrument, and responsemessages ar...

Protocol Exceptions If an error occurs during the information exchange, the exchange may not becompleted in a normal manner. Some of the protocol exceptions are shownbelow. Command Error A command error will be reported if the instrument detects a syntax error or an unrecognized command header. Exec...

Figure 6-1 Example syntax diagram Message Communication and System Functions Syntax Diagrams 6–6

Syntax Overview This overview is intended to give a quick glance at the syntax defined byIEEE 488.2. It will help you understand many of the things about the syntaxyou need to know. IEEE 488.2 defines the blocks used to build messages which are sent to theinstrument. A whole string of commands can t...

Upper/Lower Case Equivalence Upper and lower case letters are equivalent. The mnemonic SINGLE has the same semantic meaning as the mnemonic single . <white space> <white space> is defined to be one or more characters from the ASCII set of 0 – 32 decimal, excluding 10 decimal (NL). <wh...

Suffix Unit The suffix units that the instrument will accept are shown in table 6-2. Table 6-2 <suffix unit> Suffix Referenced Unit V Volt S Second Example To specify 3 ns, you might enter 3NS or 3E-9 S in your program. Message Communication and System Functions Syntax Overview 6–10

Introduction Status reporting allows you to use information about the instrument inyour programs, so that you have better control of the measurementprocess. For example, you can use status reporting to determinewhen a measurement is complete, thus controlling your program, sothat it does not get ahe...

Figure 7-1 Status Byte Structures and Concepts Status Reporting 7–3

Event Status Register The Event Status Register is an IEEE 488.2 defined register. The bits in thisregister are "latched." That is, once an event happens which sets a bit, thatbit will only be cleared if the register is read. Service Request Enable Register The Service Request Enable Registe...

MSG - message Indicates whether there is a message in the message queue (Notimplemented in the HP 16500C Logic Analysis System). PON - power on Indicates power has been turned on. URQ - user request Always returns a 0 from the HP 16500C Logic Analysis System. CME - command error Indicates whether th...

LCL - remote to local Indicates whether a remote to local transition has occurred. MSB - module summary bit Indicates that an enable event in one of the module Status registers hasoccurred. Key Features A few of the most important features of Status Reporting are listed in thefollowing paragraphs. O...

Figure 7-2 Service Request Enabling Status Reporting Key Features 7–7

Serial Poll The HP 16500C Logic Analysis System supports the IEEE 488.1 serial pollfeature. When a serial poll of the instrument is requested, the RQS bit isreturned on bit 6 of the status byte. Using Serial Poll (HP-IB) This example will show how to use the service request by conducting a serialpol...

After the serial poll is completed, the RQS bit in the Status Byte Register ofthe HP 16500C Logic Analysis System will be reset if it was set. Once a bit inthe Status Byte Register is set, it will remain set until the status is clearedwith a *CLS command, or the instrument is reset. Parallel Poll Pa...

Figure 7-3 Parallel Poll Data Structure Status Reporting Parallel Poll 7–10

Polling HP-IB Devices Parallel poll is the fastest means of gathering device status when severaldevices are connected to the bus. Each device (with this capability) can beprogrammed to respond with one bit of status when parallel polled. Thismakes it possible to obtain the status of several devices ...

The value of Mask (any numeric expression can be specified) is first roundedand then used to configure the device’s parallel response. The leastsignificant 3 bits (bits 0 through 2) of the expression are used to determinewhich data line the device is to respond on (place its status on). Bit 3specifi...

Disabling Parallel Poll Responses The PPU (Parallel Poll Unconfigure) statement gives the controller thecapability of disabling the parallel poll responses of one or more devices onthe bus. Example The following statement disables device 5 only: PPOLL UNCONFIGURE 705 This statement disables all devi...

Parallel Poll Enable Command The parallel poll enable secondary command (PPE) configures the deviceswhich have received the PPC command to respond to a parallel poll on aparticular HP-IB DIO line with a particular level. Parallel Poll Disable Command The parallel poll disable secondary command (PPD)...

Device Dependent Errors 200 Label not found 201 Pattern string invalid 202 Qualifier invalid 203 Data not available 300 RS-232-C error Command Errors –100 Command error (unknown command)(generic error) –101 Invalid character received –110 Command header error –111 Header delimiter error –120 Numeric...

Execution Errors –200 Can not do (generic execution error) –201 Not executable in local mode –202 Settings lost due to return-to-local or power on –203 Trigger ignored –211 Legal command, but settings conflict –212 Argument out of range –221 Busy doing something else –222 Insufficient capability or ...

–320 ROM error –321 ROM checksum –322 Hardware and firmware incompatible –330 Power on test failed –340 Self Test failed –350 Too many errors (error queue overflow) Query Errors –400 Query error (generic) –410 Query interrupted –420 Query unterminated –421 Query received. Indefinite block response i...

Part 2 9 Common Commands 9-1 10 Mainframe Commands 10-1 11 SYSTem Subsystem 11-1 12 MMEMory Subsystem 12-1 13 INTermodule Subsystem 13-1 14 TGTctrl Subsystem 14-1 Commands

Figure 9-1 Common Commands Syntax Diagram Common Commands 9–4

Table 9-1 Common Command Parameter Values Parameter Values mask An integer, 0 through 255. pre_mask An integer, 0 through 65535. *CLS (Clear Status) Command *CLS The *CLS common command clears all event status registers, queues, anddata structures, including the device defined error queue and status...

*ESE (Event Status Enable) Command *ESE <mask> The *ESE command sets the Standard Event Status Enable Register bits.The Standard Event Status Enable Register contains a bit to enable thestatus indicators detailed in table 9-2. A 1 in any bit position of the StandardEvent Status Enable Register...

Table 9-2 Standard Event Status Enable Register Bit Position Bit Weight Enables 7 128 PON - Power On 6 64 URQ - User Request 5 32 CME - Command Error 4 16 EXE - Execution Error 3 8 DDE - Device Dependent Error 2 4 QYE - Query Error 1 2 RQC - Request Control 0 1 OPC - Operation Complete *ESR (Event S...

Table 9-3 shows the Standard Event Status Register. The table details themeaning of each bit position in the Standard Event Status Register and thebit weight. When you read Standard Event Status Register, the valuereturned is the total bit weight of all the bits that are high at the time youread the...

Table 9-4 HP 16500C Parallel Poll Enable Register Bit Position Bit Weight Enables 15 -8 Not used 7 128 Not used 6 64 MSS - Master Summary Status 5 32 ESB - Event Status 4 16 MAV - Message Available 3 8 LCL - Local 2 4 Not used 1 2 Not used 0 1 MSB - Module Summary *RST (Reset) The *RST command is no...

Table 9-5 HP 16500C Service Request Enable Register Bit Position Bit Weight Enables 15-8 not used 7 128 not used 6 64 MSS - Master Summary Status (always 0) 5 32 ESB - Event Status 4 16 MAV - Message Available 3 8 LCL- Local 2 4 not used 1 2 not used 0 1 MSB - Module Summary *STB (Status Byte) Query...

Table 9-6 The Status Byte Register Bit Position Bit Weight Bit Name Condition 7 128 not used 6 64 MSS 0 = instrument has no reason for service1 = instrument is requesting service 5 32 ESB 0 = no event status conditions have occurred1 = an enabled event status condition has occurred 4 16 MAV 0 = no o...

Introduction Mainframe commands control the basic operation of the instrumentfor both the HP 16500C mainframe alone or with the HP 16501Aexpansion frame connected. Mainframe commands can be called atanytime, and from any module. The only difference in mainframecommands with an HP 16501A connected is...

Figure 10-1 Mainframe Commands Syntax Diagram Mainframe Commands 10–3

Figure 10-1 (continued) Mainframe Commands Syntax Diagram (continued) Mainframe Commands 10–4

Table 10-1 Mainframe Parameter Values Parameter Values value An integer from 0 to 65535 module An integer from –2 through 5 for an HP 16500C alone or from–2 through 10 with an HP 16501A connected menu An integer enable_value An integer from 0 to 255 index An integer from 0 to 5 for an HP 16500C alon...

BEEPer Command :BEEPer [{ON|1}|{OFF|0}] The BEEPer command sets the beeper mode, which turns the beeper soundof the instrument on and off. When BEEPer is sent with no argument, thebeeper will be sounded without affecting the current mode. Example OUTPUT XXX;":BEEPER" OUTPUT XXX;":BEEP ON...

CAPability Query :CAPability? The CAPability query returns the IEEE 488.1 "Interface Requirements forDevices" capability sets implemented in the device. Table 10-2 lists the capability sets implemented in the HP 16500C. Returned Format [:CAPability] IEEE488,1987,SH1,AH1,T5,L4,SR1,RL1,PP1,DC1...

CARDcage Query :CARDcage? The CARDcage query returns a series of integers which identify the modulesthat are installed in the mainframe. For an HP 16500C alone, the first fivenumbers returned are the card identification numbers (–1 means no card isin the slot). The remaining five numbers returned in...

Table 10-3 Card Identification Numbers Id Number Card 1 HP 16515A 1GHz Timing Master Card 2 HP 16516A 1GHz Timing Expansion Card 4 HP 16517A 4GHz Timing/1GHz State Analyzer Master Card 5 HP 16518A 4GHz Timing/1GHz State Analyzer Expansion Card 11 HP 16530A 400 MSa/s Oscilloscope Timebase Card 12 HP ...

Table 10-4 HP 16500C Combined Event Status Enable Register Bit Weight Enables 11-15 not used 10 1024 Module in slot J 9 512 Module in slot I 8 256 Module in slot H 7 128 Module in slot G 6 64 Module in slot F 5 32 Module in slot E 4 16 Module in slot D 3 8 Module in slot C 2 4 Module in slot B 1 2 M...

Table 10-5 HP 16500C Combined Event Status Register Bit Bit Weight Bit Name Condition 11-15 not used 10 1024 Module J 0 = No new status1 = Status to report 9 512 Module I 0 = No new status1 = Status to report 8 256 Module H 0 = No new status1 = Status to report 7 128 Module G 0 = No new status1 = St...

EOI (End Or Identify) Command :EOI {{ON|1}|{OFF|0}} The EOI command specifies whether the last byte of a reply from theHP 16500C is to be sent with the EOI bus control line set true. If EOI isturned off, the logic analyzer responses will not be IEEE 488.2 compliant. Example OUTPUT XXX;":EOI ON&#...

LOCKout Command :LOCKout {{ON|1}|{OFF|0}} The LOCKout command locks out or restores front panel operation. Whenthis function is on, all controls (except the power switch) are entirely lockedout. Example OUTPUT XXX;":LOCKOUT ON" Query :LOCKout? The LOCKout query returns the current status of ...

MENU Command :MENU <module>[,<menu>] The MENU command puts a menu on the display. The first parameterspecifies the desired module. The optional second parameter specifies thedesired menu in the module (defaults to 0). Table 10-6 lists the moduleparameters. The mainframe menus and paramet...

Table 10-7 System Menu Values Menu Command Parameters Menu MENU 0,0 System Configuration menu MENU 0,1 Hard disk menu MENU 0,2 Flexible disk menu MENU 0,3 Utilities menu MENU 0,4 Test menu MENU 0,5 Intermodule menu Query :MENU? The MENU query returns the current menu selection. Returned Format [:MEN...

MESR<N> (Module Event Status Register) Query :MESR<N>? The MESR query returns the contents of the Module Event Status register.The <N> index specifies the module. For the HP 16500C alone, the <N>index 0 through 5 refers to system and modules 1 through 5 respectively.With an H...

RMODe Command :RMODe {SINGle|REPetitive} The RMODe command specifies the run mode for the selected module (orIntermodule). If the selected module is in the intermodule configuration,then the intermodule run mode will be set by this command. After specifying the run mode, use the STARt command to sta...

SELect Command :SELect <module> The SELect command selects which module (or system) will have parsercontrol. The appropriate module (or system) must be selected before anymodule (or system) specific commands can be sent. SELECT 0 selectsSystem, SELECT 1 through 5 selects modules A through E in...

Figure 10-2 Select Command Tree Only available whenan HP 16501A isconnected Mainframe Commands SELect 10–22

SETColor Command :SETColor {<color>,<hue>,<sat>,<lum>|DEFault} The SETColor command is used to change one of the color selections on theCRT, or to return to the default screen colors. Four parameters are sent withthe command to change a color: • Color Number (first parameter)...

XWINdow Command :XWINdow {{OFF|0} | {ON|1}[,<display>]} The XWINdow command opens or closes a window on an X Window displayserver, that is, a networked workstation or personal computer. TheXWINdow ON command opens a window. If no display is specified, thedisplay already stored in the HP 16500C...

Figure 11-1 System Subsystem Commands Syntax Diagram SYSTem Subsystem 11–3

Table 11-1 SYSTem Parameter Values Parameter Values block_data Data in IEEE 488.2 format. string A string of up to 68 alphanumeric characters. pathname A string of up to 10 alphanumeric characters for LIF in thefollowing form: NNNNNNNNNN orA string of up to 64 alphanumeric characters for DOS in one ...

DATA Command :SYSTem:DATA <block_data> The DATA command allows you to send and receive acquired data to andfrom a controller in block form. This helps saving block data for: • Reloading the logic analysis system • Processing data later in the logic analysis system • Processing data in the cont...

Query :SYSTem:DATA? The SYSTem:DATA query returns the block data. The data sent by theSYSTem:DATA query reflects the configuration of the selected module whenthe last acquisition was performed. Any changes made since then througheither front-panel operations or programming commands do not affect the...

ERRor Query :SYSTem:ERRor? [NUMeric|STRing] The ERRor query returns the oldest error from the error queue. The optionalparameter determines whether the error string should be returned along withthe error number. If no parameter is received, or if the parameter isNUMeric, then only the error number i...

PRINt Commands :SYSTem:PRINt ALL[,DISK, <pathname>[,<msus>]]:SYSTem:PRINt PARTial,<start>,<end>[,DISK, <pathname>[,<msus>]]:SYSTem:PRINt SCReen[,DISK, <pathname> [,<msus>],{BTIF|CTIF|PCX|EPS}] The PRINt command initiates a print of the screen or listin...

Example This instruction prints the screen to the printer: OUTPUT XXX;":SYSTEM:PRINT SCREEN" This instruction prints the entire state listing to a file named STATE: OUTPUT 707;":SYSTEM:PRINT ALL, DISK,’STATE’" This instruction prints part of a listing to disk: OUTPUT XXX;":SYSTEM...

SETup Command :SYSTem:SETup <block_data> The :SYSTem:SETup command configures the logic analysis system asdefined by the block data sent by the controller. This chapter describesbriefly the syntax of the Setup command and query for the mainframe.Because of the capabilities and importance of th...

Figure 12-1 MMEMory Subsystem Commands Syntax Diagram MMEMory Subsystem 12–3

Figure 12-1 (Continued) MMEMory Subsystem Commands Syntax Diagram (Continued) MMEMory Subsystem 12–4

Table 12-1 MMEMory Parameter Values Parameter Values auto_file A string of up to 10 alphanumeric characters for LIF in thefollowing form: "NNNNNNNNNN"orA string of up to 12 alphanumeric characters for DOS in thefollowing form: "NNNNNNNN.NNN" msus Mass Storage Unit specifier. INTernal...

AUToload Command :MMEMory:AUToload {{OFF|0}|{<auto_file>}}[,<msus>] The AUToload command controls the autoload feature which designates a setof configuration files to be loaded automatically the next time the instrumentis turned on. The OFF parameter (or 0) disables the autoload feature....

CATalog Query :MMEMory:CATalog? [[ALL|FULL][,<msus>]] The FULL option is available with version 1.01 or higher of the HP 16500Coperating system only. Version 1.00 does not recognize this option. The CATalog query returns the directory of the disk in one of three blockdata formats. When no opti...

COPY Command :MMEMory:COPY <name>[,<msus>],<new_name>[,<msus>] The COPY command copies one file to a new file. Wildcards are supported.The two <name> parameters are the filenames. The first pair of parameters specifies the source file. The second pair specifies the dest...

Example To copy the contents of "FILE1" to "FILE2": OUTPUT XXX;":MMEMORY:COPY ’FILE1’,’FILE2’" To copy the contents of "FILE1" on the hard disk to "FILE2" on the flexibledisk: OUTPUT XXX;":MMEMORY:COPY ’FILE1’,INTERNAL0,’FILE2’,INTERNAL1" To copy the c...

Example OUTPUT XXX;":MMEMORY:DOWNLOAD ’SETUP ’,INTERNAL0,’FILE CREATED FROM SETUP QUERY’,-16127,#800000643..." Table 12-2 File Types File File Type Autoload File –15615 Inverse Assembler –15614 DOS file ( from Print to Disk) –5813 HP 16500B System Software –15603 HP 16500B Option Software –1...

IDENtify Command :MMEMory:IDENtify? [<msus>] The IDENtify query is available with version 1.01 or higher of the HP 16500Coperating system only. Version 1.00 does not recognize this query. The IDENtify query returns the serial number of the disk in the specifieddrive. This number is unique for ...

INITialize Command :MMEMory:INITialize [{LIF|DOS}[,<msus>]] The INITialize command formats the disk in DOS (Disk Operating System) onthe hard drive or either DOS or LIF (Logical Information Format) on theflexible drive. If no format is specified, then the initialize command willformat the disk...

PACK Command :MMEMory:PACK [<msus>] The PACK command packs the files on the LIF disk the disk in the drive. If aDOS disk is in the drive when the PACK command is sent, no action is taken. <msus> Mass Storage Unit specifier. INTernal0 for the hard disk drive and INTernal1 for the flexible...

PURGe Command :MMEMory:PURGe <name>[,<msus>] The PURGe command deletes files and directories from the disk in thespecified drive. The PURge command only purges directories when thedirectory is empty. If the PURge command is sent with a directory name andthe directory contains files, the ...

REName Command :MMEMory:REName <name>[,<msus>],<new_name> The REName command renames a file on the drive. The <name> parameter specifies the filename to be changed and the <new_name> parameter specifies the new filename. You cannot use REName to move a file from onedriv...

UPLoad Query :MMEMory:UPLoad? <name>[,<msus>] The UPLoad query uploads a file. The <name> parameter specifies the file to be uploaded from the disk. The contents of the file are sent out of theinstrument in block data form. This command should only be used for HP 16550A configurati...

VOLume Query :MMEMory:VOLume? [<msus>] The VOLume query returns the volume type of the disk. The volume typesare DOS or LIF. Question marks (???) are returned if there is no disk, if thedisk is not formatted, or if a disk has a format other than DOS or LIF. <msus> Mass Storage Unit speci...

Figure 13-1 Intermodule Subsystem Commands Syntax Diagram INTermodule Subsystem 13–3

Figure 13-1 (continued) Intermodule Subsystem Commands Syntax Diagram (continued) INTermodule Subsystem 13–4

Table 13-1 INTermodule Parameter Values Parameter Value module An integer, 1 through 5 for HP 16500C alone. 1 through 10with the HP 16501A connected. user_lev A real number from –4.0 to +5.0 volts in 0.02 volt increments index An integer, 1 through 5 for HP 16500C alone. 1 through 10with the HP 1650...

DELete Command :INTermodule:DELete {ALL|OUT|<module>} The DELete command is used to remove a module, PORT OUT, or an entireintermodule tree from a Group Run. The <module> parameter sent with the delete command refers to the slot location of the module. <module> An integer, 1 throug...

HTIMe Query :INTermodule:HTIMe? The HTIMe query returns a value representing the internal hardware skew inthe Intermodule configuration. If there is no internal skew, 9.9E37 isreturned. The internal hardware skew is only a display adjustment for time-correlatedwaveforms. The value returned is the av...

INPort Command :INTermodule:INPort {{ON|1}|{OFF|0}} The INPort command causes intermodule acquisitions to be armed from thePort In, the same as Group Run Armed from PORT IN in the Intermodulemenu. A value of 0 removes Port In from the Group Run. In version 1.02 and later of the operating system soft...

INSert Command :INTermodule:INSert{<module>|OUT},{GROUP|<module>} The INSert command adds a module or PORT OUT to the Intermoduleconfiguration. The first parameter selects the module or PORT OUT to beadded to the intermodule configuration, and the second parameter tells theinstrument whe...

OUTDrive Command :INTermodule:OUTDrive {{0|NORMal}|{1|OPENcllctr}} The OUTDrive command sets the Port Out BNC to put out either a normal(TTL-type) or open-collector signal. This corresponds to the Output field inthe PORT IN/OUT Setup menu under the Intermodule menu. See Also The HP 16500C User’s Ref...

Query :INTermodule:OUTPolar? The OUTPolar query returns the current Port Out polarity setting. Returned Format [:INTermodule:OUTPolar] {1|0}<NL> Example OUTPUT XXX;":INTERMODULE:OUTPolar?" OUTType Command :INTermodule:OUTType {{0|FEEDthru} | {1|LATChed}| {2|PULse}} The OUTType command ...

PORTEDGE Command :INTermodule:PORTEDGE <edge_spec> This command does not obey the truncation rules. The PORTEDGE command sets the Port In BNC to respond to either a risingedge of falling edge for a trigger from an external source. The threshold levelof the input signal is set by the PORTLEV co...

PORTLEV Command :INTermodule:PORTLEV {TTL|ECL|<user_lev>} This command does not obey the truncation rules. The PORTLEV (port level) command sets the threshold level at which theinput BNC responds and produces an intermodule trigger. The preset levelsare TTL and ECL. The user-defined level is –...

TREE Command :INTermodule:TREE <module>,<module>,<module>,<module>,<module>[,<module>,<module>,<module>,<module>,<module>],<port_out> The TREE command allows an intermodule setup to be specified in onecommand. The first five (or ten, ...

TTIMe Query :INTermodule:TTIMe? The TTIMe query returns five values for the HP 16500C alone or ten with anHP 16501A connected representing the absolute intermodule trigger time forall of the modules in the Intermodule configuration. The first value is thetrigger time for the module in slot A, the se...

Figure 14-1 Targetcontrol Subsystem Commands Syntax Diagram TGTctrl Subsystem 14–3

Table 14-1 TGTctrl Parameter Values Parameter Value N An integer, 0 through 7, indicating signal bits An integer, 0 though 255 state An integer, 0 through 7 name A string of up to 14 characters :TGTctrl Selector :TGTctrl This command does not obey the truncation rule. The TGTctrl selector specifies ...

AVAILable Query :TGTctrl:AVAILable? This command does not obey the truncation rule. The AVAILable query returns an integer whose binary form indicatesunassigned bits. If a signal is turned off, any bits assigned to it are available.A 0 indicates that the bit is NOT available. Returned Format [:TGTct...

BITS Command :TGTctrl:BITS<N> <mask> The BITS command assigns bits to a signal. A 1 in the mask’s bit positionassigns the bit to the signal. The mask overwrites any previous assignments. <N> An integer, 0 through 7, specifying signal. <mask> An integer, 0 through 255. Example...

CURSTate Query :TGTctrl:CURSTate<N>? This command does not obey the truncation rule. The CURSTate query returns the current state of the specified signal. Fortoggle and pulse signals, this will be either 0 or 1. For sequence signals, itwill be between 0 and the last state. Returned Format [:TG...

LASTstate Command :TGTctrl:LASTstate<N> <state> The LASTstate command sets a signal’s last state. LASTstate has no effectunless the signal type is sequence. <N> An integer, 0 through 7, specifying signal. <state> An integer, 1 through 7. Example OUTPUT XXX;":TGTCTRL:LAST2...

NAMe Command :TGTctrl:NAMe<N> <name> The LASTstate command sets a signal name. <N> An integer, 0 through 7, specifying signal. <name> A string of up to 14 characters. Example OUTPUT XXX;":TGTCTRL:NAME0 ’Reset’" Query :TGTctrl:NAMe<N>? The NAMe query returns the ...

PULse Command :TGTctrl:PULse<N> This command does not obey the truncation rule. The PULse command pulses the specified signal. If the signal type is toggleor sequence, it sets the signal to the next state. This command works thesame as STEP and TOGgle. <N> An integer, 0 through 7, specif...

SIGSTatus Query :TGTctrl:SIGSTatus<N>? This command does not obey the truncation rule. The SIGSTatus query returns two values. The first is the current state on thetarget control lines assigned to the signal. The second is an activity indicatoron the signal. A signal that is off will always re...

STATEs Command :TGTctrl:STATEs<N> <value_0>[,<value_1>,<value_2>,<value_3>,<value_4>,<value_5>,<value_6>, <value_7>] This command does not obey the truncation rule. The STATEs command sets the state values of the specified signal. Thevalue is int...

STEP Command :TGTctrl:STEP<N> The STEP command sets the specified signal to the next state. If the signaltype is pulse, it briefly pulses the signal. STEP can be used with any type ofsignal. This command has the same effect as PULse and TOGgle. <N> An integer, 0 through 7, specifying sig...

TYPe Command :TGTctrl:TYPe<N> {{TOGgle|0} | {PULse|1} |{SEQuence|2}} The TYPe command sets the signal type for the specified signal. It does notturn on the signal. <N> An integer, 0 through 7, specifying signal. Example OUTPUT XXX;":TGT:TYP2 SEQ" Query :TGTctrl:TYPe<N>? The...

Part 3 15 Programming Examples 15-1 Programming Examples

Introduction This chapter contains short, usable, and tested program examplesthat cover the most frequently requested examples. The examplesare written in HP BASIC 6.2. • Transferring the mainframe configuration between the mainframeand the controller • Checking for intermodule measurement completio...

Transferring the Mainframe Configuration This program uses the SYSTem:SETup? query to transfer the configuration of the mainframe to your controller. This program also uses the SYSTem:SETup command to transfer a mainframe configuration from the controller back to the mainframe. The configuration dat...

Checking for Intermodule Measurement Completion This program can be appended to or inserted into another program when youneed to know when an intermodule measurement is complete. If it is at theend of a program it will tell you when measurement is complete. If you insertit into a program, it will ha...

Sending Queries to the Logic Analysis System This program example contains the steps required to send a query to thelogic analysis system. Sending the query alone only puts the requestedinformation in an output buffer of the logic analysis system. You must followthe query with an ENTER statement to ...

Getting ASCII Data with PRINt? ALL Query This program example shows you how to get ASCII data from a listingdisplay, like the disk catalog or state listing, using the PRINt? ALL query. There are two things you must keep in mind: • You must select the mainframe, which is always SELECT 0 for the HP 16...

Reading the disk with the CATalog? ALL query The following example program reads the catalog of the currently selecteddisk drive. The CATALOG? ALL query returns the entire 70-character field. Because DOS directory entries are 70 characters long, you should use the CATALOG? ALL query with DOS disks. ...

Reading the Disk with the CATalog? Query This example program uses the CATALOG? query without the ALL option to read the catalog of the currently selected disk drive. However, if you donot use the ALL option, the query only returns a 51-character field. Keep in mind if you use this program with a DO...

Printing to the disk This program prints acquired data to a disk file. The file can be either on aLIF or DOS disk. If you print the file to a flexible disk in the DOS format, youwill be able to view the file on a DOS compatible computer using any numberof file utility programs. 10 ! ********* PRINTI...

Index *CLS command, 9–5*ESE command, 9–6*ESR command, 9–7*IDN command, 9–9*IST command, 9–9*OPC command, 9–11*OPT command, 9–12*PRE command, 9–13*RST command, 9–14*SRE command, 9–15*STB command, 9–16*TRG command, 9–17*TST command, 9–18*WAI command, 9–19..., 5–532767, 5–49.9E+37, 5–4::=, 5–5 , 5–5 , ...

D DATA, 11–5Data bits, 3–8level, 4–4mode, 2–3types, 1–13 to 1–14 Data Carrier Detect (DCD), 3–5DATA command/query, 11–5Data Communications Equipment, see DCE Data Set Ready (DSR), 3–5Data Terminal Equipment, 3–3Data Terminal Ready (DTR), 3–5DCE, 3–3DCL, 2–6DDE, 7–5Decimal numbers, 1–13Definite-lengt...

Module identification number, 10–9Mounting, 4–4MSB, 7–6MSG, 7–5MSI, 12–18MSS, 7–4, 9–16Msus, 12–2Multiple numeric variables, 1–22program commands, 1–15queries, 1–22subsystems, 1–15 N NAMe, 14–11Negative numbers, 1–14New Line character, 1–8NL, 1–8, 5–5Notation conventions, 5–5Numbers, 1–13, 1–19 base...

R Real numbers, 1–14Real-time clock, 10–20Receive Data (RD), 3–4 to 3–5Remote enable (REN), 2–5REName, 12–22Request To Send (RTS), 3–5Response data, 1–21Responses, 1–17, 5–4RMODe, 10–19Root, 5–8RQC, 7–5RQS, 7–4, 9–16RS-232-C, 3–2, 3–9, 6–2RTC (real-time clock), 10–20 S Scientific notation, 1–13SDC, ...