CALL:DATA

CALL:DATA

Last updated: April 27, 2013

GPIB Command Conventions

CALL:DATA:PING[:ALL]?

Function

This command returns the following results: packets transmitted, packets received, percent packets lost, minimum round trip time (in seconds), average round trip time (in seconds), maximum round trip time (in seconds).

This command will return 9.91 E+37 if the ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:ALL?"
ENTER 714;Pxmit,Prcvd,Plost,Min_time,Avg_time,Max_time

CALL:DATA:PING:ICOunt?

Function

This command queries the value that is available when the query is received.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:ICOUNT?"

CALL:DATA:PING:PACKets:RX?

Function

This command queries the number of packets received from the device being tested or from the alternate device if CALL:DATA:PING:SETup:DEVice is set to ALTernate.

This command will return 9.91 E+37 if the ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:PACKETS:RX?"
!Queries the number of packets received from the device being tested.

CALL:DATA:PING:PACKets:TX?

Function

This queries the number of packets transmitted from the test set.

This command will return 9.91 E+37 if the ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:PACKETS:TX?"
!Queries the number of packets transmitted from the test set.

CALL:DATA:PING:PLOSs?

Function

This command queries the percentage of packets lost during the ping session.

This command will return 9.91 E+37 if the ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:PLOSS?" !Queries the percentage of lost packets.

CALL:DATA:PING:SETup:ALTernate:IP:ADDRess[:IP4]

Function

This sets/queries the alternate internet protocol (IP) address. This address will be used as the address to ping instead of the device under test if the CALL:DATA:PING:SETup:DEVice command is set to ALT and the CALL:DATA:PING:SETup:PROTocol is set to IP4.

Setting

Range: IPv4 address in dotted decimal format.

Query

Same as setting.

Requirements

Lab Application Revision: A.01 and above

Lab Application Revision: C.00.08 and above, added [:IP4]

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETUP:ALTERNATE:IP:ADDRESS '192.168.16.57'"

CALL:DATA:PING:SETup:ALTernate:IP:ADDRess:IP6

Function

This sets/queries the Alternate internet protocol version 6(IPv6) pinging address. This address will be used as the alternate address to ping instead of the device under test if the CALL:DATA:PING:SETup:DEVice command is set to ALT and the CALL:DATA:PING:SETup:PROTocol command is set to IP6.

Setting

Range: 0 to 45 characters of an valid IPv6 address, this can be a normal 39- character IPv6 address, a zero compression IPv6 address or a up to 45-character IPv4 address-compatible address (see IPv6 Address Requirements ). Rangs are from

  • "" (blank field) or
  • 2000:0000:0000:0000:0000:0000:0000:0000 to 3FFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF or
  • FC00:0000:0000:0000:0000:0000:0000:0000 to FDFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF or
  • FE80:0000:0000:0000:0000:0000:0000:0000 to FEBF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF

Query

Range: "" (blank field) or 39 characters of IPv6 address with the format: AAAA:BBBB:CCCC:DDDD:EEEE:FFFF:GGGG:HHHH. Each of the A, B, ... H is an hex number ranging from 0 to F.

*RST Setting

FE80:0000:0000:0000:0000:0000:0000:0001
Requirements Lab Application Revision: C.00.08 and above.

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETUP:ALTERNATE:IP:ADDRESS:IP6 '2009::146.208.232.220'"
Sets the alternate Ping6 Address to 2009::146.208.232.220.
 
OUTPUT 714;"CALL:DATA:PING:SETUP:ALTERNATE:IP:ADDRESS:IP6 'FE80::1'"
Sets the alternate Ping6 Address to FE80::1.

CALL:DATA:PING:SETup:COUNt

Function

This command set/queries the number of ping IP messages sent for each uninterrupted invocation of the CALL:DATA:PING:STARt command.

Setting

Range: 1 to 1000

Query

Range: 1 to 1000

Requirements Lab Application Revision: A.01 and above

*RST Setting

10

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETUP:COUNT 20"

CALL:DATA:PING:SETup:DEVice

Function

This command sets/queries which device address is used in the ping IP packets, the address of the device under test, or the address of an alternate device.

Setting

Range: DUT|ALTernate

Query

Range: DUT|ALT

Requirements Lab Application Revision: A.01 and above

*RST Setting

DUT

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETUP:DEVice ALT"

CALL:DATA:PING:SETup:PACKet[:SIZE][:IP4]

Function

This command sets/queries the number of bytes sent by the test set in each ping packet when the CALL:DATA:PING:SETup:PROTocol command is set to IP4.

Setting

Range: 8 to 4076

Resolution: 1

Query

Same as setting
Requirements

Lab Application Revision: A.01 and above

Lab Application Revision: C.00.08 and above, added [:IP4]

*RST Setting

64 bytes

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETup:PACKet 10"

CALL:DATA:PING:SETup:PACKet[:SIZE]:IP6

Function

This command sets/queries the number of bytes sent by the test set in each ping packet with the CALL:DATA:PING:SETup:PROTocol command set to IP6.

Setting

Range: 9 to 8192

Resolution: 1

Query

Same as setting
Requirements Lab Application Revision: C.00.08 and above

*RST Setting

64 bytes

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETup:PACKet:IP6 10"

CALL:DATA:PING:SETup:PROTocol

Function

This command sets/queries the ping protocol to use when pinging the external device.

Setting

IP4 | IP6

Query

Same as setting
Requirements Lab Application Revision: C.00.08 and above

*RST Setting

IP4

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETup:PROTocol IP4"

CALL:DATA:PING:SETup:TIMeout

Function

This command sets or queries how long the test set will wait before ending a ping session.

This command will return 9.91 E+37 if the ping results are not available.

Setting

Range: 1 to 100 seconds

Query

Range: 1 to 100 seconds

Requirements Lab Application Revision: A.01 and above

*RST Setting

5 seconds

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:SETUP:TIMEOUT 10"

CALL:DATA:PING:STARt

Function

This command starts a ping session.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:START"

CALL:DATA:PING:STOP

Function

This command immediately stops a ping session. The ping results will not include counts for any ping message that has not yet received a response.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:STOP"

CALL:DATA:PING:TIME[:AVERage]?

Function

This command queries the average round trip time (in seconds) for a series of pings.

This command will return 9.91 E+37 if ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:TIME:AVERAGE?"

CALL:DATA:PING:TIME:MAXimum?

Function

This command queries the maximum round trip time (in seconds) for a series of pings.

This command will return 9.91 E+37 if ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:TIME:MAXIMUM?"

CALL:DATA:PING:TIME:MINimum?

Function

This command queries the minimum round trip time (in seconds).

This command will return 9.91 E+37 if ping results are not available.

Requirements Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PING:TIME:MINIMUM?"

CALL:DATA:PDSNode:EXTernal:IP:ADDRess

Function

Sets/queries the IP address of external PDSN (MOB-IP-SIM). It will not take effect until the CALL:DATA:PDSNode:EXTernal:STATe is set to ON. See External PDSN IP Address for details.

This setting is stored in the nonvolatile RAM, and will not be changed by a reset or cycling power of the test set.

Setting

Range: 15 characters formatted as follows: A.B.C.D or "" (empty string)
The range of values for A = 0 to 126 and 128 to 223. The range of values for B,C, D = 0 to 255 (no embedded spaces).
("0.0.0.0", "0" or "" (an empty string) will set the external PDSN IP address to be undefined)

Query

Range: same as setting

*RST Setting

  • "" (empty string when shipped from the factory)
  • the value last set and stored in the nonvolatile RAM

Requirements

Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:IP:ADDRess '130.29.179.220'" 
!Sets the External PDSN IP Address to 130.29.179.220.

CALL:DATA:PDNetwork[1]|2|3:APName?

Function

Sets/queries the Access Point Name.

Access Point Name setting idetifies a Packet Data Network (PDN) that an UE will communicate with.

Setting

Range: 0 to 99 ASCII characters

Query

Range: same as setting

*RST Setting

Empty string

Requirements

Lab Application Revision: E.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PDNetwork:3:APName" 
!Sets to use the APName.

CALL:DATA:PDNetwork[1]|2|3:RSYNchronize

Function

VSNCP resynchronization setting is used to initiate a PDN resynchronization to update UE of parameters.

Setting

Range: Immediate Action
Query No Query

Requirements

Lab Application Revision: E.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PDNetwork:3:RESYnchronize" 

CALL:DATA:PDNetwork[1]|2|3:DISConnect

Function

VSNCP termination is used to terminate the PDN connection from the network side.

Setting

Range: Immediate Action
Query No Query

Requirements

Lab Application Revision: E.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PDNetwork:3:DISConnect" 

CALL:DATA:PDSNode:EXTernal:STATe

Function

Sets/queries whether to use the external PDSN simulator (MOB-IP-SIM) or the test set's internal PDSN simulation.

  • On - indicates using external PDSN simulator (MOB-IP-SIM)
  • Off - indicates using test set's internal PDSN

You must specify a valid IP address ( CALL:DATA:PDNetwork[1]|2|3:APName? ) and a valid TCP port ( CALL:DATA:PDSNode:EXTernal:TCP:PORT ) for the external PDSN (MOB-IP-SIM) before changing the external PDSN state to on. See External PDSN State for details.

Setting

Range: 1|ON|0|OFF

Query

same as setting

*RST Setting

0 (OFF)

Requirements

Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:STATe ON" 
!Sets to use the External PDSN.

CALL:DATA:PDSNode:EXTernal:TCP:PORT

Function

Sets/queries the TCP port of the external PDSN (MOB-IP-SIM). It will not take effect until the CALL:DATA:PDSNode:EXTernal:STATe is set to ON. See External PDSN TCP Port .

This setting is stored in nonvolatile RAM, and will not be changed by a reset or cycling power of the test set.

Setting

Range: 0 to 65535
Resolution: 1

Query

Range: same as setting

*RST Setting

  • 53613 (when shipped from the factory)
  • the value last set and stored in the nonvolatile RAM

Requirements

Lab Application Revision: A.01 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:TCP:PORT 53613" 
!Sets the External PDSN TCP port to 53613.

CALL:DATA:PDSNode:EXTernal:TIMeout[:CONNect]

Function

Sets/queries the maximum amount of time the test set will wait to connect to the external PDSN (MOB-IP-SIM). It will not take effect until the CALL:DATA:PDSNode:EXTernal:STATe is set to ON. See External PDSN Connect Timeout for details.

This setting is stored in nonvolatile RAM, and will not be changed by a reset or cycling power of the test set.

Setting

Range: 1 to 19 seconds
Resolution: 1 second

Query

Range: same as setting

*RST Setting

  • 2 (when shipped from the factory)
  • the value last set and stored in the nonvolatile RAM

Requirements

Lab Application Revision: A.01 and above
Lab Application Revision: A.02.10 and above, value range changed from 0 - 19 seconds to 1 - 19 seconds.

Programming Example

 
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:TIMeout 10S" 
!Sets the External PDSN timeout to 10 seconds.

CALL:DATA:MIP:STATe

Function

Sets/queries whether to use the Internal Mobile IP.

  • On - indicates using the Internal Mobile IP
  • Off - indicates not using the Internal Mobile IP

Setting

Range: 1|ON|0|OFF

Query

same as setting

*RST Setting

0 (OFF)

Requirements

Lab Application Revision: B.00 and above

Programming Example

 
OUTPUT 714;"CALL:DATA:MIP:STATe ON" 
!Sets to use the Internal Mobile IP.

CALL:DATA:MIP:HAGent:SECRet

Function

This command sets or queries what is the secret key used at the Home Agent and Mobile.

Setting

Range: 0 to 32 hex char strings. The number of hex digits must be even number.

Query

same as setting

Requirements Lab Application Revision: B.00 and above

*RST Setting

8960

Programming Example

 
OUTPUT 714;"CALL:DATA:MIP:HAGent:SECRet '0123456789ABCDEF'" 
!Sets the secret key 0123456789ABCDEF.