Application Revisions and Licenses

Application Revisions and Licenses

Last updated: April 29, 2009

Description

Different revisions of the applications in your test set provide different capabilities. The selected application revision is loaded after the next application switch or power cycle of the test set. Once you select a revision the revision does not change unless you select another revision.

You can query the selected revision, all available revisions, and the total count of available revisions for a selected application. These queries are helpful when selecting revisions but are not usually necessary when switching applications.

   
NOTE
The Keysight E1960A GSM Mobile Test Application revisions prior to A.04.00 do not support application switching. If you select a revision prior to A.04.00 you will not have a path to switch back to later revisions.

If you accidentally switch to a non-supported revision, use the firmware upgrade process to load firmware with the correct revision.


   

Application Revision Queries and Commands

These are commands to query revision information or select a revision.

  • To query a selected application revision (running or not) use this GPIB command:
     
    OUTPUT 714;"SYSTEM:APPLICATION:SELECT:REVISION? `AMPS/136 MOBILE TEST'"
  • To query the revision of the application currently running use this GPIB command:
     
    OUTPUT 714;"SYSTEM:APPLICATION:CURRENT:REVISION?"
  • To query all of the revisions available for a application use this GPIB command:
     
    OUTPUT 714;"SYSTEM:APPLICATION:CATALOG:REVISION? `AMPS/136 MOBILE TEST'"
  • To select a revision of an application use this GPIB command:
     
    OUTPUT 714;"SYSTEM:APPLICATION:SELECT:REVISION `GSM mobile test','A.04.01'"

    After switching to a different revision of your application, you may need to calibrate the test set. See the on-line reference guide for your application for more information.

  • To query the number of revisions for a specified application:
     
    OUTPUT 714;"SYSTEM:APPLICATION:CATALOG:REVISION:COUNT? `GSM MOBILE TEST'"

Application License Status Query

The application license status can be queried for a particular application and revision using the following GPIB query:

 
OUTPUT 714;"SYSTEM:APPLICATION:CATALOG:LICENSE? `GSM mobile test','A.04.01'"

This query returns one of the following:

  • "LIC" - This revision of application appears to have a LICense. The application may have been developed before licensing and therefore needs no license.
  • "NLIC" - This application does not appear to have a license. Selecting a Not LICensed revision will result in an error +130.
  • "PART" - Some PART of the application does not appear to have a license.
  • "UNKN" - This application has UNKNown license status.

You can also query a list of all licensed applications, formats and features using the following GPIB query:

 
OUTPUT 714;"SYSTem:APPLication:CATalog:LICense:APPLication:ALL?"

   
NOTE
If you switch to a not licensed revision the test set will reboot to the SYSTEM CONFIG screen. You will be unable to select any other screen or make any measurements. Query or view the Application Setup menu to determine the licensed versions of applications available.

   

Revision and license information can be viewed and selected from the SYSTEM CONFIG screen, by selecting the Application Setup menu. Revisions are shown with their license status. After the revision number is a letter. That letter indicates the revision license status; Licensed "L", Not Licensed "N", or Unknown "U".

  • "L"- This revision of application appears to have a License. The application may have been developed before licensing and therefore needs no license.
  • "N" - This application does not appear to have a license. Selecting a Not licensed revision will result in an error +130.
  • "P" - Some Part of the application does not appear to have a license.
  • "U" - This application has Unknown license status.

Test Application Revision To Current (R2C) license

Keysight Revision To Current (R2C) is an keysight service to provide licensing for general test application functionalities added to the test set through a specified timeframe. R2C license information is displayed in the Instrument Information and License Status window after you press the SYSTEM CONFIG hardkey, or you can continue to press ( F10 ) License Status Detail and then ( F9 ) R2C License Coverage Info to get a display of the R2C license information.

  • Revision To Current (R2C) license coverage: The R2C license coverage is associated with a timeframe indicating that all test application functionalities before that timeframe are licensed.
  • Revision To Current (R2C) license status: indicates the status or authority of the R2C license installed in the test set.
    • L: Fully licensed. Installed R2C license enables access to all installed R2C licensed functionalities.
    • N: Not Licensed. No R2C license is installed on the test set. Access to R2C licensed functionalities will be restricted.
    • P: Installed R2C license enables access to some installed R2C-licensed functionalities.Access will be restricted for the R2C functionalities added after the R2C license coverage date.

These are commands to query the Revision To Current (R2C) license information.

  • To query the R2C license status, use this GPIB command:
     
    OUTPUT 714;"SYSTem:APPLication:CATalog:R2Current:STATus?"
  • To query the coverage date of the installed R2C license, use this GPIB command:
     
    OUTPUT 714;"SYSTem:APPLication:CATalog:R2Current:COVerage?"