Last update: 17 Aug 2000

Commands:

• all commands are terminated with CR (ENTER)
• responses are terminated by CRLF
• Note: for power controlling commands, 0 = ON and 1 = OFF

ALLOFF - kill all power to modules

• responds with OFF

H - request brief HELP menu

STAT - request HEX status byte (power control bits - 0 = ON)

• status bits:
  • bit 0 - Wind Power
  • bit 1 - Met Power
  • bit 2 - RF Link Power
  • bit 3 - XRF PC Power
  • bit 4 - XRF Main Power Relay
  • bit 5 - Sample Handler Power
  • bit 6 - Inlet Power
  • bit 7 - unused (set to 0)

• Example 1: status byte will be 7F after ALLOFF command
• Example 2: status byte will be 5C if Wind, Met, and Sample Handler power ON

PINL[=0,1] - request current status or power ON/OFF for sample inlet

• eg: PINL=1 turns OFF power for sample inlet
• connector-pins: P14-1,3 => +15VDC-MET
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

PMET[=0,1] - request current status or power ON/OFF for MET package

• eg: PMET=1 turns OFF power for MET package
• connector-pins: P11-4 => +15VDC-MET
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

PRFL[=0,1] - request current status or power ON/OFF for RF link package

• eg: PRFL=1 turns OFF power for RF link package
• connector-pins: P6-7 => +15VDC-MAIN
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

PSMP[=0,1] - request current status or power ON/OFF for sample handler

• eg: PSMP=1 turns OFF power for sample handler
• connector-pins: P13-7 => +15VDC-MET
• connector-pins: P13-1 => +28VDC-PV
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

PWND[=0,1] - request current status or power ON/OFF for WND module

• eg: PWND=1 turns OFF power for WND module
• connector-pins: P12-2 => +15VDC-MET
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

PXRF[=0,1] - request current status or power ON/OFF for XRF (relay control)

• eg: PXRF=1 turns OFF power for XRF (by disabling relay)
• connector-pins: P8-1,2 => +15VDC-PC
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

PXPC[=0,1] - request current status or power ON/OFF for XRF PC

• eg: PXPC=1 turns OFF power for XRF PC
• connector-pins: P7-7 => +15VDC-PC
• returns current setting (i.e. 0 or 1) after request or power ON/OFF

RMSG - request response from last Sxxx command

• NOTE: this command will STOP any ongoing return from device (kills receive interrupt)
• this command will dump whatever is in the big receive buffer up to 8191 characters.
• an embedded NULL (0) will stop the return prematurely (so it goes!)
• CRLF will be automatically appended to the response;
• if no response was received, "NO RESPONSE" will be returned.

SINLstring - send 'string' to INLET comm port (uart1)

• returns CRLF only
• 'string' may be up to 250 characters long
• receive MUX will automatically be set to INLET
• after transmission complete, this comm port will remain in receive until a RMSG command (or any Sxxx command) is received.
• connector: P14 - RS485 only

SMETstring - send 'string' to MET comm port (uart1)

• returns CRLF only
• 'string' may be up to 250 characters long
• receive MUX will automatically be set to MET
• after transmission complete, this comm port will remain in receive until a RMSG command (or any Sxxx command) is received.
• connector: P11 - RS485 only

SRFLstring - send 'string' to RF link comm port (uart3)

• returns CRLF only
• 'string' may be up to 250 characters long
• after transmission complete, this comm port will remain in receive until a RMSG command (or any Sxxx command) is received.
• connector: P6 - RS232 or RS485

SSMPstring - send 'string' to sample handler comm port (uart1)

• returns CRLF only
• 'string' may be up to 250 characters long
• receive MUX will automatically be set to sample handler
• after transmission complete, this comm port will remain in receive until a RMSG command (or any Sxxx command) is received.
• connector: P13 - RS485 only

SWNDstring - send 'string' to WND comm port (uart1)

• returns CRLF only
• 'string' may be up to 250 characters long
• receive MUX will automatically be set to WND
• after transmission complete, this comm port will remain in receive until a RMSG command (or any Sxxx command) is received.
• connector: P12 - RS485 only

SXcommand-string - send 'command-string', via MAINCPU command processor, to XRF PC comm port (uart2)

• The following command-strings are interpreted and repackaged in JV binary comms format:

  • RBf,b runs the Batch b in Folder f ( f and b must exist - XRF-PC will hang on error :-( )
    • responds with:
      RBOK on success
      RBNRsss,www on NotReady where sss = status # and www = warning #
      RBUN on unknown response
      RBTO on timeout - NO comms

  • RBRR to get results (requests transmission of exwin.btc result file)
    • returns in about 1 second; allow about 1 second per 500 bytes in exwin.btc bfore requesting dump with XMSG command (see below)
    • responds with:
      RROK on success
      RRUN on unknown response
      RRTO on timeout - NO comms

  • RS to request latest status/warning values
    • responds with:
      RSsss,www on success, where sss = status # and www = warning #
      RSUN on unknown response
      RSTO on timeout - NO comms

  • CC to check comms link
    • responds with:
      CCOK on success - comms OK
      CCUN on unknown response
      CCTO on timeout - NO comms

  • OG to optimize Gain DAC (see JV docs)
    • responds with:
      OGOK on success
      OGUN on unknown response
      OGTO on timeout - NO comms

  • SD to shutdown Windows on XRF-PC for clean power-down
    • responds withSD Sent... - there is no response from XRF-PC
    • wait about 10 seconds before killing power (see PXPC=1 above)

• connector: P7 - RS232 only

UOK - handle BBRAM; check or update values

• Q - quit without update
• WOK - write new values to BBRAM then quit
• A[=addr] - request or set address (currently unused)
• D[=text] - request or set setup/cal date

XMSG[K] - request response from last SXRR command to the XRF-PC

• the XMSG command (unlike RMSG above) may be polled - it will not kill receive automatically
• typical return times for exwin.btc file transfer are 500 char per second; files are usually less than a couple of thousand char, so 5 seconds is a reasonable wait time; send XMSGK to TOP the receive process.
• XMSGK command will STOP any ongoing return from device (kills receive interrupt)
• this command will dump whatever is in the big receive buffer up to 8191 characters.
• an embedded NULL (0) will stop the return prematurely (so it goes!)
• CRLF will be automatically appended to the response;
• if no response was received, "NO RESPONSE" will be returned.