parameter

Configurable parameter names and organization

General Principles

• Singular/plural indicates singleton vs. list.
• If defined in the default config, the field must be defined in all other configs (and failure to do so is a configuration error). Lists may be empty if allowed by the test spec.

SAS-CBSD

Variations on request, using registration as an example:

• registrationRequest -- used when there is only one CBSD being registered in the test case.

The value is a dictionary representing a single registration request.

The test code itself is responsible for adding the wrapper, e.g.:
    request = {'registrationRequest': [config[‘registrationRequest’]]}

• registrationRequests -- used if there are multiple CBSDs registering.
• registrationRequestsN1 -- used if there are multiple registration request steps; “N1” matches the test spec for clarity.

The value is a list of registration requests, e.g.:
    request = {'registrationRequest': config[‘registrationRequests’]}

CBSD ID

• Within the test body, CBSD IDs will be filled in all but the registration request according to the following rules:
  • If ID already exists:
    • If equal to “REMOVE”: delete the field.
    • If equal to an integer, use the CBSD ID at that index.
  • Else fill with the CBSD ID at the same index in the array.

Miscellaneous

• conditionalRegistrationData -- if present and nonempty, this conditional registration data will be injected directly into the SAS UUT.

PAL/PPA

• palRecords -- array of PAL records which will be injected one at a time.

for pal_record in config['palRecords']:
    self._sas_admin.InjectPalDatabaseRecord(pal_record)

• ppaRecords -- list of dictionaries, each with the following fields:
  • ppaRecord -- single PPA record to be injected into the SAS UUT after adding cluster list information.

self._sas_admin.InjectZoneData({'record': config[‘ppaRecord’]})

• ppaClusterList -- list of CBSDs (must be present but may be empty); values are indices into the CBSD IDs array (corresponding to the registration requests).

Peer SAS

• sasTestHarnessConfig -- dictionary with the following key/value pairs:
  • sasTestHarnessName -- locally unique string to identify this SAS TH
  • hostName -- IP address/URL for the SAS TH (without leading https://)
  • port -- port number for the SAS TH
  • serverCert -- relative path to certificate file
  • serverKey -- relative path to the key file

Other protected entities

• gwpzRecords -- list of GWPZ records which will be injected one at a time.
• fssRecords -- list of FSS records which will be injected one at a time.

for fss_record in config[‘fssRecords’]:
	self._sas_admin.InjectFss(fss_record)

• escSensorRecords -- list of ESC sensor records which will be injected one at a time.

for esc_sensor in config['escSensorRecords']:
   self._sas_admin.InjectEscSensorDataRecord({'record': esc_sensor})