Syntax Overview | HP Sander 16500C specification

Message Communication and System Functions

Syntax Overview

Syntax Overview

This overview is intended to give a quick glance at the syntax defined by IEEE 488.2. It will help you understand many of the things about the syntax you need to know.

IEEE 488.2 defines the blocks used to build messages which are sent to the instrument. A whole string of commands can therefore be broken up into individual components.

Figure 6-1 is an example syntax diagram and figure 6-2 shows a breakdown of an example program message. There are a few key items to notice:

•A semicolon separates commands from one another. Each program message unit serves as a container for one command. The program message units are separated by a semicolon.

•A program message is terminated by a <NL> (new line). The recognition of the program message terminator, or <PMT>, by the parser serves as a signal for the parser to begin execution of commands. The <PMT> also affects command tree traversal.

•Multiple data parameters are separated by a comma.

•The first data parameter is separated from the header with one or more spaces.

•The header SYSTEM:LONGFORM OFF is an example of a compound header. It places the parser in the machine subsystem until the <NL> is encountered.

•A colon preceding the command header returns you to the top of the command tree.

See Also

Chapter 5, "Programming and Documentation Conventions"

6–7

Image 87

HP Sander 16500C manual Syntax Overview

Contents

HP 16500C/16501A Logic Analysis System Page Iii This BookOrganization Guide is organized in three partsPage Contents Contents Truncation Rule Infinity Representation Command Set Organization Subsystems Program ExamplesProtocols 6-3 Syntax Diagrams 6-5 Syntax Overview HP-IB Commands Contents-3 Menu Contents-4 Device Dependent ErrorsInternal Errors Query Errors CLS Clear Status ESE Event Status Enable 10-25 XWINdow Mesen Module Event Status Enable 10-16PURGe 12-20 PWD Present Working Directory Contents-5 RMODe RTC Real-time Clock SELect 10-21 SETColor STARt 10-24 INTermodule Subsystem REName STORe CONFig UPLoad VOLume 15-9 Contents-715-3 Sending Queries to the Logic Analysis System Contents-8 General Information Page Introduction to Programming Introduction Example RS-232-C, or Ethernet LANReturned from a query HP Basic Talking to Individual System Modules Talking to Individual System ModulesInitialization Example See Also Program the Logic Analysis System CommandInitialization Example Exists into the system Program Message Syntax Output CommandInstruction Syntax Instruction Syntax Instruction Header Device AddressInstructions Device Address Instruction Parameters Instruction TerminatorInstruction Terminator White Space Header Types Simple Command HeaderCompound Command Header Header Types Duplicate Keywords Common Command HeaderCombined Commands in the Same Subsystem Duplicate Keywords Query Usage Query Usage Program Header Options Program Header OptionsShort form Numeric data Parameter Data TypesSee Also Example Parameter Data Types Keyword data String data Selecting Multiple Subsystems Selecting Multiple Subsystems Receiving Information from the Logic Analysis System With Header on and Longform OFF Response Header OptionsResponse Header Options With Header OFF Response Data Formats Response Data Formats Used for string concatenation String VariablesString Variables Response Numeric Base Numeric VariablesNumeric Base Definite-Length Block Response Data Definite-Length Block Response Data Multiple Queries Multiple QueriesDefinite-length Block Response Data More Installed modulesSystem Status System StatusPage Programming Over HP-IB Introduction Interface Capabilities Command and Data ConceptsInterface Capabilities Talk/Listen Addressing Instrument Address Selects the Instrument HP-IB Bus AddressingHP-IB Bus Addressing Interface Select Code Selects the Interface Local, Remote, and Local Lockout Local, Remote, and Local Lockout ExampleHint See Also Group Execute Trigger GET Bus CommandsBus Commands Device Clear Programming Over RS-232-C Introduction Interface Operation RS-232-C CablesInterface Operation Minimum Three-Wire Interface with Software Protocol Minimum Three-Wire Interface with Software Protocol Pin Extended Interface with Hardware HandshakeExtended Interface with Hardware Handshake Two bytes Cable Example Cable ExamplesCable Examples HP 9000 Series Pin F to 25-pin M Cable Configuring the Logic Analysis System InterfaceConfiguring the Logic Analysis System Interface HP Vectra Personal Computers and Compatibles Data Bits Protocol HP Vectra Personal Computers or compatibles RS-232-C Bus AddressingRS-232-C Bus Addressing Controller and the HP 16500C Logic Analysis System must be Lockout Command Lockout Command Programming Over LAN Introduction Communicating with the HP 16500C LAN AddressingCommunicating with the HP 16500C Password Protection and File Protection Password Protection and File ProtectionPermission Levels Control and Data Controlling the HP 16500C Controlling the HP 16500CSockets Echoing Commands Echoing Commands Copying Command Files Copying Command Files Resetting the File Pointer Writing to \system\program from a ProgramQueries Directory Writing to \system\program from a Program Socket will eventually close without receiving a response Sending Commands to the HP 16500C SocketSending Commands to the HP 16500C Socket Parser socket Start Lockout Command Page Programming and Documentation Conventions Introduction Truncation Rule Truncation RuleTruncation Examples Long Form Short Form Response Generation Sequential and Overlapped CommandsSyntax Diagrams Infinity Representation Notation Conventions and Definitions Notation Conventions and Definitions Command Tree Command TreeCommand Types HP 16500C Command Tree Tree Traversal Rules Tree Traversal Rules Store command as shown in the second line of this example To the root of the command tree. The parser can then seeTree Traversal Rules Example Command Set Organization Command Set OrganizationSubsystems Command Subsystem Subsystems Alphabetic Command Cross-Reference Keywords in short form, numbers using an exponential format Program ExamplesProgram Examples Message Communication and System Functions Compatible instruments may or may not conform to the Ieee Protocols ProtocolsFunctional Elements Protocol Operation Protocol Overview Protocol Exceptions Syntax Diagrams Example syntax diagram Syntax Overview Syntax Overview Program message Parse Tree Upper/Lower Case Equivalence Suffix multValue Mnemonic Suffix Status Reporting Introduction Status Byte Structures and Concepts Service Request Enable Register Event Status RegisterBit Definitions DDE device specific error PON power onCME command error EXE execution error Operation Complete Key FeaturesLCL remote to local MSB module summary bit Service Request Enabling Using Serial Poll HP-IB Serial PollSerial Poll Parallel Poll Parallel Poll Parallel Poll Data Structure Configuring Parallel Poll Responses Polling HP-IB DevicesPolling HP-IB Devices Conducting a Parallel Poll Conducting a Parallel Poll Disabling Parallel Poll Responses HP-IB CommandsParallel Poll Unconfigure Command Parallel Poll Configure Command Parallel Poll Commands HP-IB CommandsParallel Poll Enable Command Parallel Poll Disable Command Error Messages Introduction Device Dependent Errors Command ErrorsDevice Dependent Errors Execution Errors Internal ErrorsExecution Errors Query Errors Query ErrorsPage Commands Page Common Commands CLS Status Registers Order to re-enter the memory subsystem and store the file Common Commands Syntax Diagram Parameter Values Mask CLS Clear Status Common Command Parameter ValuesCLS Clear Status CLS ESE? ESE Event Status EnableESE Event Status Enable ESE mask String variable Esrevent$ will have bit 5 the CME bit set Bit Position Bit Weight EnablesESR Event Status Register ESR? Bit Position Bit Weight Bit Name Condition ESR Event Status RegisterStandard Event Status Register IDN Identification Number IDN Identification NumberIST Individual Status IST? IST Data Structure IST Individual Status OPC Operation Complete OPC Operation CompleteOPC OPC? OPT Option Identification OPT Option Identification PRE? PRE Parallel Poll Enable Register EnablePRE Parallel Poll Enable Register Enable PRE mask RST Reset HP 16500C Parallel Poll Enable Register RST Reset SRE? SRE Service Request EnableSRE Service Request Enable SRE mask Bits in the status byte STB Status Byte HP 16500C Service Request Enable RegisterSTB Status Byte STB? TRG Trigger TRGTRG Trigger Status Byte Register TST Test Bits Returned by *TST? Query Power-Up Test ResultsTST Test TST? HP 16500C are STARt and Stop WAI WaitWAI WAI WaitPage Mainframe Commands 10-2 Menu 10-3 Mainframe Commands Syntax Diagram 10-4 Mainframe Parameter Values 10-5Parameter Values BEEPer CommandBEEPer ON1OFF0BEEPer BEEPer? HP 16500C Capability Sets CAPabilityCAPability? CAPability CARDcage CARDcage?CARDcage CARDcage Card Identification Numbers 10-9Id Number Card CESE? Cese Combined Event Status EnableCESE? query returns the current setting Cese value Bit Weight Enables Cesr Combined Event Status RegisterValue An integer from 0 to 10-12 Cesr Combined Event Status Register EOI? CommandEOI ON1OFF0EOI End Or Identify LER LCL Event Register LOCKout CommandLOCKout ON1OFF0LOCKout LOCKout? CommandMENU module,menu 10-15Parameter Menu MENU? Mesen Module Event Status EnableCommandMESEN enablevalue Mesen Module Event Status Enable System Menu Values Mesen Module Event Status Enable Example QueryMESEN?10-17 HP 16500C Mainframe Module Event Status Register N=0 Mesrn Module Event Status RegisterMESRN? Mesrn Module Event Status Register RMODe RMODeRMODe SINGleREPetitive RMODe? RTC Real-time Clock RTC Real-time Clock SELect CommandSELect moduleSELect SELect? 10-22 Select Command Tree 10-23 CommandSETColor color,hue,sat,lumDEFaultSETColor SETColor STARt STARtSTARt 10-25 Stop XWINdow XWINdow OFF0 ON1,displayXWINdow SYSTem Subsystem 11-2 Data DSP 11-3 System Subsystem Commands Syntax Diagram 11-4 SYSTem Parameter Values Data CommandSYSTemDATA blockdata DSP Display CommandSYSTemDSP stringDSP Display QuerySYSTemDATA? ERRor SYSTemERRor? NUMericSTRingERRor HEADer CommandSYSTemHEADer ON1OFF0HEADer SYSTemHEADer? LONGform CommandSYSTemLONGform ON1OFF0LONGform SYSTemLONGform? PRINt SYSTemPRINt SCReen,DISK, pathname ,msus, BtifctifpcxepsPRINt 11-11 SYSTemPRINt? SCReenALLThis instruction prints the screen to the printer This instruction prints part of a listing to disk 11-12 SETupCommandSYSTemSETup blockdata SETup 11-13 QuerySYSTemSETup? 11-14 MMEMory Subsystem 12-2 Working directory 12-3 MMEMory Subsystem Commands Syntax Diagram 12-4 12-5 12-6 MMEMory Parameter Values AUToload MMEMoryAUToload?AUToload CATalog MMEMoryCATalog? ALLFULL,msusCATalog 12-9 CommandMMEMoryCD directoryname ,msusCD Change Directory CD Change Directory Copy CommandMMEMoryCOPY name,msus,newname,msus Disk To copy the contents of FILE1 to FILE2DOWNload DOWNload Example File Types 12-12File File Type CommandMMEMoryIDENtify? msus IDENtifyIDENtify Drive INITializeMMEMoryINITialize LIFDOS,msus INITialize 12-15 LOADCONFigCommandMMEMoryLOADCONfig name,msus,module LOADCONFig 12-16 CommandMMEMoryLOADIASSembler IAname,msus,12 ,moduleLoad IASSembler Load IASSembler 12-17 CommandMMEMoryMKDir directoryname ,msusMKDir Make Directory MKDir Make Directory MSI Mass Storage Is CommandMMEMoryMSI msusMSI Mass Storage Is QueryMMEMoryMSI? Pack CommandMMEMoryPACK msus CommandMMEMoryPURGe name,msus PURGePURGe PWD Present Working Directory MMEMoryPWD? msusPWD Present Working Directory 12-22 CommandMMEMoryREName name,msus,newnameREName REName Description,module STORe CONFigMMEMorySTOReCONfig name,msus STORe CONFig Instrument in block data form UPLoadMMEMoryUPLoad? name,msus UPLoad 12-25 VOLumeMMEMoryVOLume? msus VOLume 12-26 INTermodule Subsystem 13-2 Portedge Portlev Skew Tree 13-3 Intermodule Subsystem Commands Syntax Diagram 13-4 13-5 INTermoduleINTermodule INTermodule INTermodule Parameter Values 13-6 DELeteINTermoduleDELete ALLOUTmodule DELete ValueX Skew for module in slot X real number HTIMeQueryINTermoduleHTIMe? HTIMe INPort INPortINTermoduleINPort ON1OFF0 INTermoduleINPort? INSert INTermoduleINSert ModuleOUT,GROUPmoduleINSert INTermoduleOUTDrive? CommandINTermoduleOUTDrive 0NORMal1OPENcllctrOUTDrive OUTPolar INTermoduleOUTType? CommandINTermoduleOUTType 0FEEDthru 1LATChed 2PULseOUTType QueryINTermoduleOUTPolar? 13-12 Portedge query returns the current edge settingINTermodulePORTEDGE edgespec INTermodulePORTEDGE? This statement sets the BNC threshold to -2.3 volts PORTlev query returns the current BNC threshold settingINTermodulePORTLEV TTLECLuserlev QueryINTermodulePORTLEV? 13-14 CommandINTermoduleSKEWN settingQuery returns the user defined skew setting INTermoduleSKEWN? 13-15 Tree 13-16 QueryINTermoduleTREE? Module Trigger time for module real number TTIMeQueryINTermoduleTTIMe? TTIMe 13-18 TGTctrl Subsystem 14-2 Type 14-3 Targetcontrol Subsystem Commands Syntax Diagram 14-4 14-5 TGTctrlTGTctrl TGTctrl TGTctrlALLN? AVAILable TGTctrlAVAILable?AVAILable CommandTGTctrlBITSN mask QueryTGTctrlBITSN?14-8 TGTctrlCURSTateN? CommandTGTctrlDRIVeN NORMal0OPENcllctr1CURSTate DRIVe LASTstate CommandTGTctrlLASTstateN stateLASTstate QueryTGTctrlLASTstateN? NAMe CommandTGTctrlNAMeN nameNAMe QueryTGTctrlNAMeN? TGTctrlSIGNalN? SIGNalCommandTGTctrlPULseN TGTctrlSIGNalN OFF0ON1 14-13 SIGSTatusQueryTGTctrlSIGSTatusN? SIGSTatus TGTctrlSTATEsN? STATEsTGTctrlSTATEsN value0,value1 Value7 14-15 CommandTGTctrlSTEPNCommandTGTctrlTOGgleN TOGgle TYPe CommandTGTctrlTYPeN TOGgle0 PULse1 SEQuence2TYPe QueryTGTctrlTYPeN? Programming Examples Page Programming Examples 15-2 Transferring the Mainframe Configuration Transferring the Mainframe Configuration Output 707SYSTEMHEADER on Output 707SYSTEMLONGFORM on 15-4 15-5 Checking for Intermodule Measurement Completion Checking for Intermodule Measurement Completion15-6 Sending Queries to the Logic Analysis System Sending Queries to the Logic Analysis System15-7 15-8 Getting Ascii Data with PRINt? ALL Query Getting Ascii Data with PRINt? ALL Query 15-10 Reading the disk with the CATalog? ALL queryReading the disk with the CATalog? ALL query CATALOG? ALL query with DOS disks Reading the Disk with the CATalog? Query Reading the Disk with the CATalog? QueryTruncated at 51 characters Printing to the disk Printing to the disk15-12 Index-1 Index Index-2 Index Portedge Index-3 Index-4 Document Warranty Product Warranty