Program Header Options, Short form | HP Sander 16500C instruction

Example

Introduction to Programming

Program Header Options

Program headers can be sent using any combination of uppercase or lowercase ASCII characters. System responses, however, are always returned in uppercase.

Both program command and query headers may be sent in either long form (complete spelling), short form (abbreviated spelling), or any combination of long form and short form.

Programs written in long form are easily read and are almost self- documenting. The short form syntax conserves the amount of controller memory needed for program storage and reduces the amount of I/O activity.

The rules for short form syntax are discussed in chapter 5, "Programming and Documentation Conventions."

Either of the following examples turns on the headers and long form.

Long form:

OUTPUT XXX;":SYSTEM:HEADER ON;LONGFORM ON"

Short form:

OUTPUT XXX;":SYST:HEAD ON;LONG ON"

1–12

Page 26

Image 26

HP Sander 16500C manual Program Header Options, Short form

Contents

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