Programming and Documentation Conventions | HP Sander 16500C

5

Programming and Documentation Conventions

Image 69

HP Sander 16500C manual Programming and Documentation Conventions

Contents

HP 16500C/16501A Logic Analysis System Page Organization This BookGuide is organized in three parts IiiPage Contents Contents Protocols 6-3 Syntax Diagrams 6-5 Syntax Overview Command Set Organization Subsystems Program ExamplesHP-IB Commands Contents-3 Truncation Rule Infinity Representation Internal Errors Query Errors Device Dependent ErrorsCLS Clear Status ESE Event Status Enable Menu Contents-4 PURGe 12-20 PWD Present Working Directory Contents-5 Mesen Module Event Status Enable 10-16RMODe RTC Real-time Clock SELect 10-21 SETColor STARt 10-24 10-25 XWINdow INTermodule Subsystem REName STORe CONFig UPLoad VOLume 15-3 Contents-7Sending Queries to the Logic Analysis System 15-9 Contents-8 General Information Page Introduction to Programming Introduction Returned from a query RS-232-C, or Ethernet LANHP Basic Example Initialization Talking to Individual System ModulesExample See Also Talking to Individual System Modules Initialization Example CommandExists into the system Program the Logic Analysis System Instruction Syntax Output CommandInstruction Syntax Program Message Syntax Instructions Device AddressDevice Address Instruction Header Instruction Terminator Instruction TerminatorWhite Space Instruction Parameters Compound Command Header Simple Command HeaderHeader Types Header Types Combined Commands in the Same Subsystem Common Command HeaderDuplicate Keywords Duplicate Keywords Query Usage Query Usage Program Header Options Program Header OptionsShort form See Also Example Parameter Data TypesParameter Data Types Numeric data Keyword data String data Selecting Multiple Subsystems Selecting Multiple Subsystems Receiving Information from the Logic Analysis System Response Header Options Response Header OptionsWith Header OFF With Header on and Longform OFF Response Data Formats Response Data Formats String Variables String VariablesResponse Used for string concatenation Numeric Base Numeric VariablesNumeric Base Definite-Length Block Response Data Definite-Length Block Response Data Multiple Queries Multiple QueriesDefinite-length Block Response Data System Status Installed modulesSystem Status MorePage Programming Over HP-IB Introduction Interface Capabilities Command and Data ConceptsTalk/Listen Addressing Interface Capabilities HP-IB Bus Addressing HP-IB Bus AddressingInterface Select Code Selects the Interface Instrument Address Selects the Instrument Local, Remote, and Local Lockout Local, Remote, and Local Lockout ExampleHint See Also Bus Commands Bus CommandsDevice Clear Group Execute Trigger GET 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 Extended Interface with Hardware Handshake Extended Interface with Hardware HandshakeTwo bytes Pin Cable Examples Cable ExamplesHP 9000 Series Cable Example Configuring the Logic Analysis System Interface Configuring the Logic Analysis System InterfaceHP Vectra Personal Computers and Compatibles Pin F to 25-pin M Cable Data Bits Protocol RS-232-C Bus Addressing RS-232-C Bus AddressingController and the HP 16500C Logic Analysis System must be HP Vectra Personal Computers or compatibles 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 Sending Commands to the HP 16500C Socket Sending Commands to the HP 16500C SocketParser socket Socket will eventually close without receiving a response Start Lockout Command Page Programming and Documentation Conventions Introduction Truncation Rule Truncation RuleTruncation Examples Long Form Short Form Syntax Diagrams Sequential and Overlapped CommandsInfinity Representation Response Generation 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 CME command error PON power onEXE execution error DDE device specific error LCL remote to local Key FeaturesMSB module summary bit Operation Complete 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 Parallel Poll Unconfigure Command HP-IB CommandsParallel Poll Configure Command Disabling Parallel Poll Responses Parallel Poll Enable Command HP-IB CommandsParallel Poll Disable Command Parallel Poll Commands 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 CLS Clear Status CLS Clear Status Common Command Parameter ValuesCLS Parameter Values Mask ESE Event Status Enable ESE Event Status EnableESE mask ESE? ESR Event Status Register Bit Position Bit Weight EnablesESR? String variable Esrevent$ will have bit 5 the CME bit set Bit Position Bit Weight Bit Name Condition ESR Event Status RegisterStandard Event Status Register IST Individual Status IDN Identification NumberIST? IDN Identification Number IST Data Structure IST Individual Status OPC OPC Operation CompleteOPC? OPC Operation Complete OPT Option Identification OPT Option Identification PRE Parallel Poll Enable Register Enable PRE Parallel Poll Enable Register EnablePRE mask PRE? RST Reset HP 16500C Parallel Poll Enable Register RST Reset SRE Service Request Enable SRE Service Request EnableSRE mask SRE? STB Status Byte STB Status Byte HP 16500C Service Request Enable RegisterSTB? Bits in the status byte TRG Trigger TRGTRG Trigger Status Byte Register TST Test Bits Returned by *TST? Query Power-Up Test ResultsTST? TST Test WAI WAI WaitWAI Wait HP 16500C are STARt and StopPage Mainframe Commands 10-2 Menu 10-3 Mainframe Commands Syntax Diagram 10-4 Mainframe Parameter Values 10-5Parameter Values BEEPer CommandBEEPer ON1OFF0BEEPer? BEEPer CAPability? CAPabilityCAPability HP 16500C Capability Sets CARDcage CARDcage?CARDcage CARDcage Card Identification Numbers 10-9Id Number Card CESE? query returns the current setting Cese Combined Event Status EnableCese value CESE? Bit Weight Enables Cesr Combined Event Status RegisterValue An integer from 0 to 10-12 Cesr Combined Event Status Register EOI End Or Identify CommandEOI ON1OFF0LER LCL Event Register EOI? LOCKout CommandLOCKout ON1OFF0LOCKout? LOCKout CommandMENU module,menu 10-15Parameter Menu CommandMESEN enablevalue Mesen Module Event Status EnableMesen Module Event Status Enable System Menu Values MENU? Mesen Module Event Status Enable Example QueryMESEN?10-17 MESRN? Mesrn Module Event Status RegisterMesrn Module Event Status Register HP 16500C Mainframe Module Event Status Register N=0 RMODe SINGleREPetitive RMODeRMODe? RMODe RTC Real-time Clock RTC Real-time Clock SELect CommandSELect moduleSELect? SELect 10-22 Select Command Tree SETColor CommandSETColor color,hue,sat,lumDEFaultSETColor 10-23 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 stringQuerySYSTemDATA? DSP Display ERRor SYSTemERRor? NUMericSTRingERRor HEADer CommandSYSTemHEADer ON1OFF0SYSTemHEADer? HEADer LONGform CommandSYSTemLONGform ON1OFF0SYSTemLONGform? LONGform PRINt SYSTemPRINt SCReen,DISK, pathname ,msus, BtifctifpcxepsPRINt This instruction prints the screen to the printer SYSTemPRINt? SCReenALLThis instruction prints part of a listing to disk 11-11 CommandSYSTemSETup blockdata SETupSETup 11-12 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 CD Change Directory CommandMMEMoryCD directoryname ,msusCD Change Directory 12-9 Copy CommandMMEMoryCOPY name,msus,newname,msus DOWNload To copy the contents of FILE1 to FILE2DOWNload Example Disk File Types 12-12File File Type CommandMMEMoryIDENtify? msus IDENtifyIDENtify MMEMoryINITialize LIFDOS,msus INITializeINITialize Drive CommandMMEMoryLOADCONfig name,msus,module LOADCONFigLOADCONFig 12-15 Load IASSembler CommandMMEMoryLOADIASSembler IAname,msus,12 ,moduleLoad IASSembler 12-16 MKDir Make Directory CommandMMEMoryMKDir directoryname ,msusMKDir Make Directory 12-17 MSI Mass Storage Is CommandMMEMoryMSI msusQueryMMEMoryMSI? MSI Mass Storage Is Pack CommandMMEMoryPACK msus CommandMMEMoryPURGe name,msus PURGePURGe PWD Present Working Directory MMEMoryPWD? msusPWD Present Working Directory REName CommandMMEMoryREName name,msus,newnameREName 12-22 MMEMorySTOReCONfig name,msus STORe CONFigSTORe CONFig Description,module MMEMoryUPLoad? name,msus UPLoadUPLoad Instrument in block data form MMEMoryVOLume? msus VOLumeVOLume 12-25 12-26 INTermodule Subsystem 13-2 Portedge Portlev Skew Tree 13-3 Intermodule Subsystem Commands Syntax Diagram 13-4 INTermodule INTermoduleINTermodule INTermodule Parameter Values 13-5 INTermoduleDELete ALLOUTmodule DELeteDELete 13-6 QueryINTermoduleHTIMe? HTIMeHTIMe ValueX Skew for module in slot X real number INTermoduleINPort ON1OFF0 INPortINTermoduleINPort? INPort INSert INTermoduleINSert ModuleOUT,GROUPmoduleINSert OUTDrive CommandINTermoduleOUTDrive 0NORMal1OPENcllctrOUTPolar INTermoduleOUTDrive? OUTType CommandINTermoduleOUTType 0FEEDthru 1LATChed 2PULseQueryINTermoduleOUTPolar? INTermoduleOUTType? INTermodulePORTEDGE edgespec Portedge query returns the current edge settingINTermodulePORTEDGE? 13-12 INTermodulePORTLEV TTLECLuserlev PORTlev query returns the current BNC threshold settingQueryINTermodulePORTLEV? This statement sets the BNC threshold to -2.3 volts Query returns the user defined skew setting CommandINTermoduleSKEWN settingINTermoduleSKEWN? 13-14 13-15 Tree 13-16 QueryINTermoduleTREE? QueryINTermoduleTTIMe? TTIMeTTIMe Module Trigger time for module real number 13-18 TGTctrl Subsystem 14-2 Type 14-3 Targetcontrol Subsystem Commands Syntax Diagram 14-4 TGTctrl TGTctrlTGTctrl 14-5 TGTctrlALLN? AVAILable TGTctrlAVAILable?AVAILable CommandTGTctrlBITSN mask QueryTGTctrlBITSN?14-8 CURSTate CommandTGTctrlDRIVeN NORMal0OPENcllctr1DRIVe TGTctrlCURSTateN? LASTstate CommandTGTctrlLASTstateN stateQueryTGTctrlLASTstateN? LASTstate NAMe CommandTGTctrlNAMeN nameQueryTGTctrlNAMeN? NAMe CommandTGTctrlPULseN SIGNalTGTctrlSIGNalN OFF0ON1 TGTctrlSIGNalN? QueryTGTctrlSIGSTatusN? SIGSTatusSIGSTatus 14-13 TGTctrlSTATEsN value0,value1 STATEsValue7 TGTctrlSTATEsN? CommandTGTctrlTOGgleN CommandTGTctrlSTEPNTOGgle 14-15 TYPe CommandTGTctrlTYPeN TOGgle0 PULse1 SEQuence2QueryTGTctrlTYPeN? TYPe 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 Reading the disk with the CATalog? ALL query Reading the disk with the CATalog? ALL queryCATALOG? ALL query with DOS disks 15-10 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