CALL:SECurity

Last updated: 2010-05-05

For more information on the GPIB Command conventions, see GPIB Command conventions

CALL:SECurity:AUTHenticate:ALGorithm

Function

Sets/queries the authentication algorithm.

Setting

Range: TEST34108 | MILenage

Query

Range: TEST34108 | MILenage

*RST Setting

TEST34108

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:ALGorithm MILenage"

CALL:SECurity:AUTHenticate:AMF

Function

Sets/queries the AMF value.

Setting

Range: 0 to FFFF

(String of 4 characters from the set 0123456789aAbBcCdDeEfF)

Query

Range: "0000" to "FFFF"

*RST Setting

"0000"

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:AMF '0000'"

CALL:SECurity:AUTHenticate:[KEY]  

Function

Sets/queries the authentication key.

Setting

Range: 0 to FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF

(String of 32 characters from the set 0123456789aAbBcCdDeEfF)

Query

Range: "00000000:00000000:00000000:00000000" to "FFFFFFFF:FFFFFFFF:FFFFFFFF:FFFFFFFF" (The return string is enclosed by double quotes and is always four colon separated groups in the order of upper, upper middle, lower middle and lower, each group with 8 characters from the set 0123456789ABCDEF)

*RST Setting

"4147494C:454E5420:54454348:4E4F0000"

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate '4147494C454E5420544543484E4F0000'"

CALL:SECurity:AUTHenticate:OPVariant:PTYPe

Function

Sets/queries whether the operator variant authentication algorithm contains the OP or Opc.

Setting

Range: OP|OPC  

Query

Range: OP|OPC  

*RST Setting

OPC

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:OPVariant:PTYPe  OPC"

CALL:SECurity:AUTHenticate:OPVariant:PVALue

Function

Sets/queries the value of the operator variant authentication algorithm.

Setting

Range: 0 to FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF

(String of 32 characters from the set 0123456789aAbBcCdDeEfF)

Query

Range: "00000000:00000000:00000000:00000000" to "FFFFFFFF:FFFFFFFF:FFFFFFFF:FFFFFFFF"

*RST Setting

"00000000:00000000:00000000:00000000"

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:OPVariant:PVALue  '00000000:00000000:00000000:00000000'"

CALL:SECurity:AUTHenticate:RANDom:TDSCdma

Function

Sets/queries the random (RAND) value when the current format is TD-SCDMA.

Setting

Range: 0 to FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF

(String of 32 characters from the set 0123456789aAbBcCdDeEfF)

Query

Range: "00000000:00000000:00000000:00000000" to "FFFFFFFF:FFFFFFFF:FFFFFFFF:FFFFFFFF" (The return string is enclosed by double quotes and is always four colon separated groups in the order of upper, upper middle, lower middle and lower, each group with 8 characters from the set 0123456789ABCDEF)

*RST Setting

"00000000:00000000:00000000:00000001"

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:RANDom:TDSCdma '00000000:00000000:00000000:00000001'"

CALL:SECurity:AUTHenticate:RESult:GMM:TDSCdma?

Function

Queries the authentication result in GMM when using TD-SCDMA application:

  • SUCCess - MS Authentication Success

  • MSFAILMAC - MS Authentication Failure, with a reject cause of MAC Does not Match

  • MSFAILSYNC - MS Authentication Failure, with a reject cause of Synch Failure

  • MSFAILUNKNOWN - MS Authentication Failure, with a reject cause of Unknown

  • RESLENERR - MS Authentication Failure, with a reject cause of Incorrect RES Length

  • RESNOTMATCH - MS Authentication Failure, with a reject cause of RES does not Match

  • NULL - No results is available

Query

Range: SUCCess| MSFAILMAC | MSFAILSYNC | MSFAILUNKNOWN | RESLENERR | RESNOTMATCH | NULL

*RST Setting

NULL

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:RESult:GMM:TDSCdma?"

CALL:SECurity:AUTHenticate:RESult:MM:TDSCdma?

Function

Queries the authentication result in MM when using TD-SCDMA application:

  • SUCCess - MS Authentication Success

  • MSFAILMAC - MS Authentication Failure, with a reject cause of MAC Does not Match

  • MSFAILSYNC - MS Authentication Failure, with a reject cause of Synch Failure

  • MSFAILUNKNOWN - MS Authentication Failure, with a reject cause of Unknown

  • RESLENERR - MS Authentication Failure, with a reject cause of Incorrect RES Length

  • RESNOTMATCH - MS Authentication Failure, with a reject cause of RES does not Match

  • NULL - No results is available

Query

Range: SUCC| MSFAILMAC | MSFAILSYNC | MSFAILUNKNOWN | RESLENERR | RESNOTMATCH | NULL

*RST Setting

NULL

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:RESult:MM:TDSCdma?"

CALL:SECurity:AUTHenticate:SQN:RESet:[IMMediate]

Function

Resets the authentication sequence number (SQN) to zero.

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:AUTHenticate:SQN:RESet"

CALL:SECurity:OPERation

Function

Sets/queries the security operations setting:

  • NONE: No security procedures are performed

  • AUTHONLY : Authentication only

  • AUTHINT:  Authentication and integrity protection

Setting

Range: NONE|AUTHONLY|AUTHINT

Query

Range: NONE|AUTHONLY|AUTHINT

*RST Setting

AUTHINT

Requirements

Test Application Revision: A.02.00 and above

Programming Example

"CALL:SECurity:OPERation AUTHINT"