SemComponentCarrierConfiguration

class nirfmxnr.sem_component_carrier_configuration.SemComponentCarrierConfiguration(signal_obj)[source]

Bases: object

configure_rated_output_power(selector_string, component_carrier_rated_output_power)[source]

Configures the rated output power (Prated, x) of the component carrier.

Use “carrier<k>” or “subblock<n>/carrier<k>” as the selector string to configure this method.

Note

This method is valid when you set the LINK_DIRECTION attribute to Downlink, SEM_DOWNLINK_MASK_TYPE attribute to Standard, and GNODEB_CATEGORY attribute to Medium Range Base Station. For more details please refer to section 6.6.4 of 3GPP 38.104 specification.

Parameters:

  • selector_string (string) –

    This parameter specifies a Selector String comprising of subblock number and carrier number.

    Example:

    ”subblock0/carrier0”

    You can use the build_carrier_string() method to build the selector string.

  • component_carrier_rated_output_power (float) – This parameter specifies the rated output power (Prated, x), which is used only to choose the limit table for medium range base station, FR2 Category A and FR2 Category B. This value is expressed in dBm. This parameter will be considered when you set the LINK_DIRECTION attribute to Downlink, SEM_DOWNLINK_MASK_TYPE attribute to Standard, and GNODEB_CATEGORY attribute to Medium Range Base Station or FR2 Category A or FR2 Category B. For more details please refer to section 6.6.4 and section 9.7.4 of 3GPP 38.104 specification. The default value is 0.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_rated_output_power_array(selector_string, component_carrier_rated_output_power)[source]

Configures an array of the rated output power (Prated, x) of the component carrier.

Use “subblock<n>” as the selector string to read results from this method.

Note

This method is valid when you set the LINK_DIRECTION attribute to Downlink, SEM_DOWNLINK_MASK_TYPE attribute to Standard, and GNODEB_CATEGORY attribute to Medium Range Base Station. For more details please refer to section 6.6.4 of 3GPP 38.104 specification.

Parameters:

  • selector_string (string) –

    This parameter specifies a Selector String comprising of the subblock number.

    Example:

    ”subblock0”

    You can use the build_result_string() method to build the selector string.

  • component_carrier_rated_output_power (float) – This parameter specifies an array of the rated output power (Prated, x), which is used only to choose the limit table for medium range base station, FR2 Category A and FR2 Category B. This value is expressed in dBm. This parameter will be considered when you set the LINK_DIRECTION attribute to Downlink, SEM_DOWNLINK_MASK_TYPE attribute to Standard, and GNODEB_CATEGORY attribute to Medium Range Base Station or FR2 Category A or FR2 Category B. For more details please refer to section 6.6.4 of 3GPP 38.104 specification. The default value is 0.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

get_integration_bandwidth(selector_string)[source]

Gets the integration bandwidth of a component carrier. This value is expressed in Hz.

Use “carrier<k>” or “subblock<n>” or “subblock<n>/carrier<k>” as the Selector String to read this result.

The default value is 9 MHz.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the integration bandwidth of a component carrier. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rated_output_power(selector_string)[source]

Gets the rated output power (Prated, x), which is used to select the limit table and calculate the limits for FR1 medium range base station, FR2 Category A and FR2 Category B, and also for NTN supported masks. This value is expressed in dBm.

In the case of FR1, this control is considered when the LINK_DIRECTION attribute is set to Downlink, SEM_DOWNLINK_MASK_TYPE attribute to Standard, and GNODEB_CATEGORY attribute to Medium Range Base Station. For more details please refer to section 6.6.4.2.3 of 3GPP 38.104 specification. In the case of FR2, this control is considered when the LINK_DIRECTION attribute is set to Downlink and SEM_DOWNLINK_MASK_TYPE attribute to Standard. For more details please refer to section 9.7.4.3 of 3GPP 38.104 specification.

If the BAND attribute is set to any NTN (Non-Terrestrial Network) band values 254, 255, 256, FREQUENCY_RANGE attribute to FR1, LINK_DIRECTION to Downlink and SEM_DOWNLINK_MASK_TYPE attribute to Standard, then the Rated Output Power (P:sub:`rated, C, SYS)`specifies the sum of rated output powers for all TAB connectors of the carrier for the configured SATELLITE_ACCESS_NODE_CLASS. For more details, please refer to section 6.6.4.2 of 3GPP 38.108 specification.

If the BAND attribute is set to any NTN (Non-Terrestrial Network) band values 512, 511, 510, 509, 508, FREQUENCY_RANGE attribute to FR2, and LINK_DIRECTION to Uplink, then the Rated Output Power (TRP:sub:`rated)`specifies the rated TRP output power. For more details, please refer to section 9.5.2.2 of 3GPP 38.101-5 specification.

Use “carrier<k>” or “subblock<n>” or “subblock<n>/carrier<k>” as the Selector String to read this result.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Specifies the rated output power (Prated, x), which is used to select the limit table and calculate the limits for FR1 medium range base station, FR2 Category A and FR2 Category B, and also for NTN supported masks. This value is expressed in dBm.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

set_rated_output_power(selector_string, value)[source]

Sets the rated output power (Prated, x), which is used to select the limit table and calculate the limits for FR1 medium range base station, FR2 Category A and FR2 Category B, and also for NTN supported masks. This value is expressed in dBm.

In the case of FR1, this control is considered when the LINK_DIRECTION attribute is set to Downlink, SEM_DOWNLINK_MASK_TYPE attribute to Standard, and GNODEB_CATEGORY attribute to Medium Range Base Station. For more details please refer to section 6.6.4.2.3 of 3GPP 38.104 specification. In the case of FR2, this control is considered when the LINK_DIRECTION attribute is set to Downlink and SEM_DOWNLINK_MASK_TYPE attribute to Standard. For more details please refer to section 9.7.4.3 of 3GPP 38.104 specification.

If the BAND attribute is set to any NTN (Non-Terrestrial Network) band values 254, 255, 256, FREQUENCY_RANGE attribute to FR1, LINK_DIRECTION to Downlink and SEM_DOWNLINK_MASK_TYPE attribute to Standard, then the Rated Output Power (P:sub:`rated, C, SYS)`specifies the sum of rated output powers for all TAB connectors of the carrier for the configured SATELLITE_ACCESS_NODE_CLASS. For more details, please refer to section 6.6.4.2 of 3GPP 38.108 specification.

If the BAND attribute is set to any NTN (Non-Terrestrial Network) band values 512, 511, 510, 509, 508, FREQUENCY_RANGE attribute to FR2, and LINK_DIRECTION to Uplink, then the Rated Output Power (TRP:sub:`rated)`specifies the rated TRP output power. For more details, please refer to section 9.5.2.2 of 3GPP 38.101-5 specification.

Use “carrier<k>” or “subblock<n>” or “subblock<n>/carrier<k>” as the Selector String to read this result.

The default value is 0.

Parameters:

  • selector_string (string) – Pass an empty string.

  • value (float) – Specifies the rated output power (Prated, x), which is used to select the limit table and calculate the limits for FR1 medium range base station, FR2 Category A and FR2 Category B, and also for NTN supported masks. This value is expressed in dBm.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int