Structure to hold the parameters for BLE periodic advertising transmission.

Public Attributes#

uint8_t

Command ID

  • Takes per BLE_TRANSMIT_CMD_ID of value 0x13.

uint8_t

Enables/disables the BLE per transmit mode

  • 1 PER Transmit Enable

  • 0 PER Transmit Disable.

uint8_t

Access address with which packets are transmitted.

uint8_t

Phy rate at which packets are transmitted

  • 1 1Mbps

  • 2 2 Mbps

  • 4 125 Kbps Coded

  • 8 500 Kbps Coded.

uint8_t

Rx channel number (0 - 39)

uint8_t

Tx channel number (0 - 39)

uint8_t

Initial seed to be used for whitening.

uint8_t

LE channel type (data or advertise channel)

  • 0x00 Advertise Channel

  • 0x01 Data Channel (to be used by Default)

uint8_t

Frequency hopping type to be used

  • 0 No Hopping

  • 1 Fixed Hopping

  • 2 Random Hopping (rx_chnl_num, tx_chnl_num parameters are unused in this mode)

uint8_t

Select the antenna to be used.

uint8_t

pll_mode type to be used

uint8_t

Selection of RF type (internal/external)

  • 0 BT_EXTERNAL_RF

  • 1 BT_INTERNAL_RF (to be used by Default)

uint8_t

Selection of RF Chain (HP/LP) to be used

  • 2 BT_HP_CHAIN

  • 3 BT_LP_CHAIN.

uint8_t

Length of the packet to be transmitted.

uint8_t

Type of payload data sequence

  • 0x00 PRBS9 sequence �11111111100000111101...

  • 0x01 Repeated �11110000�

  • 0x02 Repeated �10101010�

  • 0x03 PRBS15

  • 0x04 Repeated �11111111�

  • 0x05 Repeated �00000000�

  • 0x06 Repeated '00001111'

  • 0x07 Repeated '01010101'.

uint8_t

Transmit Power.

uint8_t

Transmit mode to be used either Burst/Continuous

  • 0 BURST_MODE

  • 1 CONTINUOUS_MODE

  • 2 CONTINUOUS_WAVE_MODE (CW_MODE)

uint8_t

This field takes the value of inter packet gap.

uint8_t

This field defines the number of packets to be transmitted, default to zero for continuous transmission.

Public Attribute Documentation#

cmd_ix#

uint8_t rsi_ble_per_transmit_s::cmd_ix

Command ID

  • Takes per BLE_TRANSMIT_CMD_ID of value 0x13.


Definition at line 1367 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

transmit_enable#

uint8_t rsi_ble_per_transmit_s::transmit_enable

Enables/disables the BLE per transmit mode

  • 1 PER Transmit Enable

  • 0 PER Transmit Disable.


Definition at line 1373 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

access_addr#

uint8_t rsi_ble_per_transmit_s::access_addr[4]

Access address with which packets are transmitted.


Definition at line 1375 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

phy_rate#

uint8_t rsi_ble_per_transmit_s::phy_rate

Phy rate at which packets are transmitted

  • 1 1Mbps

  • 2 2 Mbps

  • 4 125 Kbps Coded

  • 8 500 Kbps Coded.


Definition at line 1385 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

rx_chnl_num#

uint8_t rsi_ble_per_transmit_s::rx_chnl_num

Rx channel number (0 - 39)

Note

  • Removed the BLE packet transmission on channel-39 (2480 MHz) at a 2 Mbps data rate


Definition at line 1388 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

tx_chnl_num#

uint8_t rsi_ble_per_transmit_s::tx_chnl_num

Tx channel number (0 - 39)

Note

  • Removed the BLE packet transmission on channel-39 (2480 MHz) at a 2 Mbps data rate


Definition at line 1391 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

scrambler_seed#

uint8_t rsi_ble_per_transmit_s::scrambler_seed

Initial seed to be used for whitening.

It should be set to 0 in order to disable whitening.

  • In order to enable, one should give the scrambler seed value which is used on the receive side


Definition at line 1395 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

le_chnl_type#

uint8_t rsi_ble_per_transmit_s::le_chnl_type

LE channel type (data or advertise channel)

  • 0x00 Advertise Channel

  • 0x01 Data Channel (to be used by Default)


Definition at line 1401 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

freq_hop_en#

uint8_t rsi_ble_per_transmit_s::freq_hop_en

Frequency hopping type to be used

  • 0 No Hopping

  • 1 Fixed Hopping

  • 2 Random Hopping (rx_chnl_num, tx_chnl_num parameters are unused in this mode)


Definition at line 1409 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

ant_sel#

uint8_t rsi_ble_per_transmit_s::ant_sel

Select the antenna to be used.

Refer to the data sheet for your hardware to check whether or not it contains an onboard antenna.

  • 2 ONBOARD_ANT_SEL

  • 3 EXT_ANT_SEL


Definition at line 1415 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

pll_mode#

uint8_t rsi_ble_per_transmit_s::pll_mode

pll_mode type to be used

  • 0 PLL_MODE0 (to be used by Default)

  • 1 PLL_MODE1


Definition at line 1421 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

rf_type#

uint8_t rsi_ble_per_transmit_s::rf_type

Selection of RF type (internal/external)

  • 0 BT_EXTERNAL_RF

  • 1 BT_INTERNAL_RF (to be used by Default)

Note

  • The above macros are applicable for both BT and BLE


Definition at line 1428 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

rf_chain#

uint8_t rsi_ble_per_transmit_s::rf_chain

Selection of RF Chain (HP/LP) to be used

  • 2 BT_HP_CHAIN

  • 3 BT_LP_CHAIN.

Note

  • The above macros are applicable for both BT and BLE


Definition at line 1435 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

pkt_len#

uint8_t rsi_ble_per_transmit_s::pkt_len[2]

Length of the packet to be transmitted.


Definition at line 1437 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

payload_type#

uint8_t rsi_ble_per_transmit_s::payload_type

Type of payload data sequence

  • 0x00 PRBS9 sequence �11111111100000111101...

  • 0x01 Repeated �11110000�

  • 0x02 Repeated �10101010�

  • 0x03 PRBS15

  • 0x04 Repeated �11111111�

  • 0x05 Repeated �00000000�

  • 0x06 Repeated '00001111'

  • 0x07 Repeated '01010101'.


Definition at line 1455 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

tx_power#

uint8_t rsi_ble_per_transmit_s::tx_power

Transmit Power.

  • Default Value for BLE TX Power Index is 31, The range for the BLE TX Power Index is 1 to 127 (0, 32 indexes are invalid).

  • TX power index for the BLE LP Chain : 1 to 31 (0 dBm Mode), 33 to 63 ( 10 dBm Mode)

  • TX power index for the BLE HP Chain : 1 to 127

  • Note

    • For the LP Chain - Power index vs Outpt power in dBm.


    Power Index

    Output Power in dBm

    1

    -22.3054959

    2

    -16.59332574

    3

    -13.38278365

    4

    -11.19804718

    5

    -9.576522466

    6

    -8.312070432

    7

    -7.294640362

    8

    -6.458448154

    9

    -5.760963318

    10

    -5.173042366

    11

    -4.673788189

    12

    -4.247653993

    13

    -3.882708784

    14

    -3.569545894

    15

    -3.300567503

    16

    -3.069499167

    17

    -2.871050592

    18

    -2.700672503

    19

    -2.554378603

    20

    -2.428612817

    21

    -2.32014891

    22

    -2.226013876

    23

    -2.143429275

    24

    -2.069766557

    25

    -2.002513642

    26

    -1.939250859

    27

    -1.87763493

    28

    -1.815390046

    29

    -1.750305305

    30

    -1.680237892

    31

    -1.603121401

    32

    NA

    33

    -10.4822997

    34

    -4.9531679

    35

    -1.931961022

    36

    0.057132993

    37

    1.476764101

    38

    2.5332116

    39

    3.336771823

    40

    3.953605265

    41

    4.426779615

    42

    4.786171523

    43

    5.053647759

    44

    5.246007208

    45

    5.37676618

    46

    5.457304255

    47

    5.497635316

    48

    5.506945838

    49

    5.493978354

    50

    5.467302132

    51

    5.435491631

    52

    5.407220119

    53

    5.391268248

    54

    5.396444507

    55

    5.431416481

    56

    5.504458826

    57

    5.62313521

    58

    5.793945208

    59

    6.02197959

    60

    6.310634089

    61

    6.661428559

    62

    7.073964236

    63

    7.546029076


  • Note

    • For the HP Chain - Power index vs Outpt power in dBm.


    Power Index

    Output Power in dBm

    1

    1

    2

    2

    3

    3

    4

    4

    5

    5

    6

    6

    7

    7

    8

    8

    9

    9

    10

    10

    -

    -

    -

    -

    -

    -

    -

    -

    41

    0.5

    42

    1

    43

    1.5

    44

    2

    45

    2.5

    46

    3

    47

    3.5

    48

    4

    49

    4.5

    50

    5

    -

    -

    -

    -

    127

    (Max Power Supported by Country region)

    -------------------—

    ----------------------------------------------------------------—


Definition at line 1569 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

transmit_mode#

uint8_t rsi_ble_per_transmit_s::transmit_mode

Transmit mode to be used either Burst/Continuous

  • 0 BURST_MODE

  • 1 CONTINUOUS_MODE

  • 2 CONTINUOUS_WAVE_MODE (CW_MODE)


Definition at line 1577 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

inter_pkt_gap#

uint8_t rsi_ble_per_transmit_s::inter_pkt_gap

This field takes the value of inter packet gap.

  • Number of slots to be skipped between two packets - Each slot will be 1250 usec


Definition at line 1581 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h

num_pkts#

uint8_t rsi_ble_per_transmit_s::num_pkts[4]

This field defines the number of packets to be transmitted, default to zero for continuous transmission.


Definition at line 1583 of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h