Structure to hold the parameters for BLE periodic advertising transmission.
Public Attributes#
Command ID
Takes per BLE_TRANSMIT_CMD_ID of value 0x13.
Enables/disables the BLE per transmit mode
1 PER Transmit Enable
0 PER Transmit Disable.
Access address with which packets are transmitted.
Phy rate at which packets are transmitted
1 1Mbps
2 2 Mbps
4 125 Kbps Coded
8 500 Kbps Coded.
Rx channel number (0 - 39)
Tx channel number (0 - 39)
Initial seed to be used for whitening.
LE channel type (data or advertise channel)
0x00 Advertise Channel
0x01 Data Channel (to be used by Default)
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)
Select the antenna to be used.
pll_mode type to be used
Selection of RF type (internal/external)
0 BT_EXTERNAL_RF
1 BT_INTERNAL_RF (to be used by Default)
Selection of RF Chain (HP/LP) to be used
2 BT_HP_CHAIN
3 BT_LP_CHAIN.
Length of the packet to be transmitted.
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'.
Transmit Power.
Transmit mode to be used either Burst/Continuous
0 BURST_MODE
1 CONTINUOUS_MODE
2 CONTINUOUS_WAVE_MODE (CW_MODE)
This field takes the value of inter packet gap.
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.
1388
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.
1394
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.
1396
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.
1406
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)
1408
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)
1410
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
1414
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)
1420
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)
1428
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
1434
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
1440
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
1447
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
1454
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.
1456
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'.
1474
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 (0dBm Mode), 33 to 63 ( 10dBm 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)
-------------------—
----------------------------------------------------------------—
1588
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)
1596
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
1600
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.
1602
of file components/device/silabs/si91x/wireless/ble/inc/rsi_ble_apis.h