SemComponentCarrierConfiguration

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

Bases: object

configure_maximum_output_power(selector_string, component_carrier_maximum_output_power)[source]

Configures the maximum output power of the component carrier.

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

Note

This method is considered only when you set the LINK_DIRECTION attribute to Downlink, ENODEB_CATEGORY attribute to Medium Range Base Station, and SEM_DOWNLINK_MASK_TYPE attribute to eNodeB Category Based.

Parameters:

  • selector_string (string) –

    This parameter specifies a Selector String comprising of subblock number and carrier number. The default value is “subblock0/carrier0”.

    Example:

    ”subblock0/carrier0”

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

  • component_carrier_maximum_output_power (float) – This parameter specifies the maximum output power per carrier, which is used only to choose the limit table for Medium Range Base Station. This value is expressed in dBm. Refer to the section 6.6.3 of the 3GPP 36.141 specification for more details. The default value is 0. Valid values are 0 to 38, inclusive.

Returns:

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

Return type:

int

configure_maximum_output_power_array(selector_string, component_carrier_maximum_output_power)[source]

Configures the array of maximum output power of the component carrier.

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

Note

This method is considered only when you set the LINK_DIRECTION attribute to Downlink, ENODEB_CATEGORY attribute to Medium Range Base Station, and SEM_DOWNLINK_MASK_TYPE attribute to eNodeB Category Based.

Parameters:

  • selector_string (string) –

    This parameter specifies a Selector String comprising of the subblock number. The default is “” (empty string).

    Example:

    ”subblock0”

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

  • component_carrier_maximum_output_power (float) – This parameter specifies the array of maximum output power per carrier, which is used only to choose the limit table for Medium Range Base Station. This value is expressed in dBm. Refer to the section 6.6.3 of the 3GPP 36.141 specification for more details. The default value is 0. Valid values are 0 to 38, inclusive.

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>/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_maximum_output_power(selector_string)[source]

Gets the maximum output power, Pmax,c, per carrier when you set the SEM_COMPONENT_CARRIER_OUTPUT_POWER_TYPE attribute to Maximum Output Power. For more details, please refer to the section 6.6.3 of 3GPP 36.141 Release 14 and lower specifications.

Specifies the rated output power, Prated,c, per carrier when you set the SEM_COMPONENT_CARRIER_OUTPUT_POWER_TYPE attribute to Rated Output Power. For more details, please refer to the section 6.6.3 of 3GPP 36.141 Release 15 and Higher specifications.

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

The default value is 0. Valid values are within 38, inclusive.

Note

Pmax,cis considered only when you set the LINK_DIRECTION attribute to Downlink, ENODEB_CATEGORY attribute to Medium Range Base Station, and SEM_DOWNLINK_MASK_TYPE attribute to eNodeB Category Based.

Prated,cis considered only when you set the LINK_DIRECTION attribute to Downlink, ENODEB_CATEGORY attribute to Medium Range Base Station, and SEM_DOWNLINK_MASK_TYPE attribute to eNodeB Category Based or SEM_DOWNLINK_MASK_TYPE attribute to Band 46 and ENODEB_CATEGORY attribute to Medium Range Base Station or Local Area Base Station. When you set Bandwidth to 200k the maximum output power used to choose limit table and to calculate the mask.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Specifies the maximum output power, Pmax,c, per carrier when you set the SEM_COMPONENT_CARRIER_OUTPUT_POWER_TYPE attribute to Maximum Output Power. For more details, please refer to the section 6.6.3 of 3GPP 36.141 Release 14 and lower specifications.

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_output_power_type(selector_string)[source]

Gets the method of calculating the mask limits as specified in the section 6.6.3 of 3GPP 36.141 specification.

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

The default value is Maximum Output Power.

Note

This attribute is ignored when you set Bandwidth to 200k.

Name (Value)

Description

Maximum Output Power (0)

The configured value in the SEM CC Max Output Power (dBm) attribute is considered to be Pmax,c, per carrier specified in the section 6.6.3 of 3GPP 36.141 specification and is used only to choose the applicable SEM mask limit table.

Rated Output Power (1)

The configured value in the SEM CC Max Output Power (dBm) attribute is considered to be Prated,c, per carrier specified in the section 6.6.3 of 3GPP 36.141 specification. This Prated,cvalue is used to choose the applicable SEM mask limit table and to calculate the mask limits. This is the recommended setting for 3GPP Release 15 and above.
Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.SemComponentCarrierOutputPowerType):

Specifies the method of calculating the mask limits as specified in the section 6.6.3 of 3GPP 36.141 specification.

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_maximum_output_power(selector_string, value)[source]

Sets the maximum output power, Pmax,c, per carrier when you set the SEM_COMPONENT_CARRIER_OUTPUT_POWER_TYPE attribute to Maximum Output Power. For more details, please refer to the section 6.6.3 of 3GPP 36.141 Release 14 and lower specifications.

Specifies the rated output power, Prated,c, per carrier when you set the SEM_COMPONENT_CARRIER_OUTPUT_POWER_TYPE attribute to Rated Output Power. For more details, please refer to the section 6.6.3 of 3GPP 36.141 Release 15 and Higher specifications.

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

The default value is 0. Valid values are within 38, inclusive.

Note

Pmax,cis considered only when you set the LINK_DIRECTION attribute to Downlink, ENODEB_CATEGORY attribute to Medium Range Base Station, and SEM_DOWNLINK_MASK_TYPE attribute to eNodeB Category Based.

Prated,cis considered only when you set the LINK_DIRECTION attribute to Downlink, ENODEB_CATEGORY attribute to Medium Range Base Station, and SEM_DOWNLINK_MASK_TYPE attribute to eNodeB Category Based or SEM_DOWNLINK_MASK_TYPE attribute to Band 46 and ENODEB_CATEGORY attribute to Medium Range Base Station or Local Area Base Station. When you set Bandwidth to 200k the maximum output power used to choose limit table and to calculate the mask.

Parameters:

  • selector_string (string) – Pass an empty string.

  • value (float) – Specifies the maximum output power, Pmax,c, per carrier when you set the SEM_COMPONENT_CARRIER_OUTPUT_POWER_TYPE attribute to Maximum Output Power. For more details, please refer to the section 6.6.3 of 3GPP 36.141 Release 14 and lower specifications.

Returns:

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

Return type:

int

set_output_power_type(selector_string, value)[source]

Sets the method of calculating the mask limits as specified in the section 6.6.3 of 3GPP 36.141 specification.

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

The default value is Maximum Output Power.

Note

This attribute is ignored when you set Bandwidth to 200k.

Name (Value)

Description

Maximum Output Power (0)

The configured value in the SEM CC Max Output Power (dBm) attribute is considered to be Pmax,c, per carrier specified in the section 6.6.3 of 3GPP 36.141 specification and is used only to choose the applicable SEM mask limit table.

Rated Output Power (1)

The configured value in the SEM CC Max Output Power (dBm) attribute is considered to be Prated,c, per carrier specified in the section 6.6.3 of 3GPP 36.141 specification. This Prated,cvalue is used to choose the applicable SEM mask limit table and to calculate the mask limits. This is the recommended setting for 3GPP Release 15 and above.
Parameters:

  • selector_string (string) – Pass an empty string.

  • value (enums.SemComponentCarrierOutputPowerType, int) – Specifies the method of calculating the mask limits as specified in the section 6.6.3 of 3GPP 36.141 specification.

Returns:

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

Return type:

int