Structure for updating gain table offset or max power in Bluetooth commands.

Public Attributes#

uint8_t
uint8_t

Public Attribute Documentation#

node_id#

uint8_t rsi_bt_cmd_update_gain_table_offset_or_maxpower_s::node_id

Node id

  • 0 - BLE


update_gain_table_type#

uint8_t rsi_bt_cmd_update_gain_table_offset_or_maxpower_s::update_gain_table_type

Request type to select appropriate gain table

  • 0 - Update gain table with max power values

  • 1 - Update gain table with offset values


payload_len#

uint8_t rsi_bt_cmd_update_gain_table_offset_or_maxpower_s::payload_len
  • Gain table payload length


payload#

uint8_t rsi_bt_cmd_update_gain_table_offset_or_maxpower_s::payload[128]
  • The Gain table payload data consists of channel Tx power values for different regions in the format mentioned below.

  • The Gain table holding maximum Tx power values: (Each entry in the table is 1 byte.)

    <TABLE NAME>[] = {
        <REGION NAME 1>, <MAX POWER>,
        <REGION NAME 2>, <MAX POWER>,
        .
        .
        <REGION NAME N>, <MAX POWER>
    };
    
  • The Gain table with offset values: (Each entry in the table is 1 byte.)

    <TABLE NAME>[] = {
      <Number Of Regions - 'r'>,
        <REGION NAME 1>, <Number Of Channels - 'n'>,
          <cha_num_1>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
          <cha_num_2>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
          .
          .
          <cha_num_n>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
        <REGION NAME 2>, <Number Of Channels - 'n'>,
          <cha_num_1>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
          <cha_num_2>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
          .
          .
          <cha_num_n>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
        .
        .
        <REGION NAME r>, <Number Of Channels - 'n'>,
          <cha_num_1>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
          <cha_num_2>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
          .
          .
          <cha_num_n>,    <1Mbps_offset>, <2Mbps_offset>, <125kbps_offset>, <500kbps_offset>
    };
    
  • Supported Region names: FCC, ETSI, TELEC, WORLDWIDE, and KCC.

  • The following table lists the regions and their corresponding values to pass:

Value

Region

0

FCC

1

ETSI

2

TELEC

3

WORLDWIDE

4

KCC

  • If Tx power varies by channel, specify the number of applicable channels and provide the Tx power value for each channel. For channels that do not require a change, use channel 255 with a Tx power offset of 0.

Note

  • When using user gain tables, define gain tables for both the high-power (HP) chain and the low-power (LP) chain at 0 dBm and 8 dBm. Use the ble_per application as a reference implementation.