TI BLE-Stack for Bluetooth 4.2 API Documentation  3.01.00.07
Macros
Multi GAPRole Parameters

Macros

#define GAPROLE_ADV_CHANNEL_MAP   0x30C
 Which channels to advertise on (Read/Write) More...
 
#define GAPROLE_ADV_DIRECT_ADDR   0x30B
 Direct Advertisement Address (Read/Write) More...
 
#define GAPROLE_ADV_DIRECT_TYPE   0x30A
 Direct Advertisement Type (Read/Write) More...
 
#define GAPROLE_ADV_EVENT_TYPE   0x309
 Advertisement Types (Read/Write) More...
 
#define GAPROLE_ADV_FILTER_POLICY   0x30D
 Policy for filtering advertisements (Read/Write) More...
 
#define GAPROLE_ADV_NONCONN_ENABLED   0x31B
 Enable / Disable non-connectable advertising (Read/Write) More...
 
#define GAPROLE_ADVERT_DATA   0x307
 Advertisement data (Read/Write) More...
 
#define GAPROLE_ADVERT_ENABLED   0x305
 Enable/Disable Connectable Advertising (Read/Write) More...
 
#define GAPROLE_ADVERT_OFF_TIME   0x306
 How long to remain off (in sec) after advertising stops before starting again (Read/Write) More...
 
#define GAPROLE_BD_ADDR   0x304
 Device Address read from the controller (Read-only) More...
 
#define GAPROLE_IRK   0x301
 Identity Resolving Key (Read/Write) Size is uint8_t[KEYLEN]. More...
 
#define GAPROLE_MAX_CONN_INTERVAL   0x312
 Maximum connection interval (n * 1.25 ms) to use when performing param update (Read/Write) More...
 
#define GAPROLE_MAX_SCAN_RES   0x404
 Maximmum number of scan reports to store from GAPCentralRole_StartDiscovery (Read/Write) More...
 
#define GAPROLE_MIN_CONN_INTERVAL   0x311
 Minimum connection interval (n * 1.25 ms) to use when performing param update (Read/Write) More...
 
#define GAPROLE_PROFILEROLE   0x300
 This parameter will return GAP Role type (Read-only) More...
 
#define GAPROLE_SCAN_RSP_DATA   0x308
 Scan Response Data (Read/Write) More...
 
#define GAPROLE_SIGNCOUNTER   0x303
 Sign Counter (Read/Write) More...
 
#define GAPROLE_SLAVE_LATENCY   0x313
 Slave latency to use when performing param update (Read/Write) More...
 
#define GAPROLE_SRK   0x302
 Signature Resolving Key (Read/Write) More...
 
#define GAPROLE_TIMEOUT_MULTIPLIER   0x314
 Supervision timeout (n x 10 ms) to use when performing param update (Read/Write) More...
 

Detailed Description

Parameters set via GAPRole_SetParameter

Macro Definition Documentation

§ GAPROLE_ADV_CHANNEL_MAP

#define GAPROLE_ADV_CHANNEL_MAP   0x30C

Which channels to advertise on (Read/Write)

Multiple channels can be selected by ORing the bit values below.

size: uint8_t

default: GAP_ADVCHAN_ALL

range: GAP Advertisement Channel Map

§ GAPROLE_ADV_DIRECT_ADDR

#define GAPROLE_ADV_DIRECT_ADDR   0x30B

Direct Advertisement Address (Read/Write)

size: uint8_t[6]

default: NULL

range: 0x000000000000 - 0xFFFFFFFFFFFE

§ GAPROLE_ADV_DIRECT_TYPE

#define GAPROLE_ADV_DIRECT_TYPE   0x30A

Direct Advertisement Type (Read/Write)

size: uint8_t

default: ADDRMODE_PUBLIC

range: GAP Addressing Modes

§ GAPROLE_ADV_EVENT_TYPE

#define GAPROLE_ADV_EVENT_TYPE   0x309

Advertisement Types (Read/Write)

size: uint8_t

default: GAP_ADTYPE_ADV_IND

range: GAP Advertising Event Types

§ GAPROLE_ADV_FILTER_POLICY

#define GAPROLE_ADV_FILTER_POLICY   0x30D

Policy for filtering advertisements (Read/Write)

Note
This is ignored for direct advertising.

size: uint8_t

default: GAP_FILTER_POLICY_ALL

range: GAP Advertiser Filter Scan Parameters

§ GAPROLE_ADV_NONCONN_ENABLED

#define GAPROLE_ADV_NONCONN_ENABLED   0x31B

Enable / Disable non-connectable advertising (Read/Write)

Warning
GAPROLE_ADVERT_ENABLED must be set to FALSE in order to enable this

size: uint8_t

default: FALSE

range: TRUE (enable) or FALSE (disable)

§ GAPROLE_ADVERT_DATA

#define GAPROLE_ADVERT_DATA   0x307

Advertisement data (Read/Write)

Note
The third byte sets limited / general advertising as defined in Vol 3, Part C, section 11.1.3 of the BT 4.2 Core Spec.

size: a uint8_t array of up to 31 bytes

default: 02:01:01 (general advertising)

§ GAPROLE_ADVERT_ENABLED

#define GAPROLE_ADVERT_ENABLED   0x305

Enable/Disable Connectable Advertising (Read/Write)

Warning
GAPROLE_ADV_NONCONN_ENABLED must be set to FALSE in order to enable this

size: uint8_t

default: TRUE

range: TRUE (enabled) or FALSE (disabled)

§ GAPROLE_ADVERT_OFF_TIME

#define GAPROLE_ADVERT_OFF_TIME   0x306

How long to remain off (in sec) after advertising stops before starting again (Read/Write)

If set to 0, advertising will not start again.

size: uint16

default: 30

range: 0-65535

§ GAPROLE_BD_ADDR

#define GAPROLE_BD_ADDR   0x304

Device Address read from the controller (Read-only)

The BDADDR is read, in increasing order of priortiy, from the info page, secondary address from flash, or set from HCI_ReadBDADDRCmd

size: uint8_t[6]

default: BDADDR from info page

range: 0x000000000000 - 0xFFFFFFFFFFFE

§ GAPROLE_IRK

#define GAPROLE_IRK   0x301

Identity Resolving Key (Read/Write) Size is uint8_t[KEYLEN].

Note
If this is set to all 0x00's, the IRK will be randomly generated

size: uint8_t[16]

default: 0x00000000000000000000000000000000

range: 0x00000000000000000000000000000000 - 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

§ GAPROLE_MAX_CONN_INTERVAL

#define GAPROLE_MAX_CONN_INTERVAL   0x312

Maximum connection interval (n * 1.25 ms) to use when performing param update (Read/Write)

size: uint16_t

default: 3200

range: GAPROLE_MIN_CONN_INTERVAL - 3200

§ GAPROLE_MAX_SCAN_RES

#define GAPROLE_MAX_SCAN_RES   0x404

Maximmum number of scan reports to store from GAPCentralRole_StartDiscovery (Read/Write)

size: uint8_t

default: 8

range: 0-256 but this will be constrained by available RAM

§ GAPROLE_MIN_CONN_INTERVAL

#define GAPROLE_MIN_CONN_INTERVAL   0x311

Minimum connection interval (n * 1.25 ms) to use when performing param update (Read/Write)

size: uint16_t

default: 6

range: 6 - GAPROLE_MAX_CONN_INTERVAL

§ GAPROLE_PROFILEROLE

#define GAPROLE_PROFILEROLE   0x300

This parameter will return GAP Role type (Read-only)

size: uint8_t

range: GAP Profile Roles

§ GAPROLE_SCAN_RSP_DATA

#define GAPROLE_SCAN_RSP_DATA   0x308

Scan Response Data (Read/Write)

Note
This should be formatted as define d in Vol 3, Part C, section 11.1.3 of the BT 4.2 Core Spec.

size: a uint8_t array of up to 31 bytes

default: all 0x00's

§ GAPROLE_SIGNCOUNTER

#define GAPROLE_SIGNCOUNTER   0x303

Sign Counter (Read/Write)

size: uint32_t

default: 0x0000

range: 0x0000 - 0xFFFF

§ GAPROLE_SLAVE_LATENCY

#define GAPROLE_SLAVE_LATENCY   0x313

Slave latency to use when performing param update (Read/Write)

size: uint16_t

default: 0

range: 0 - 499

§ GAPROLE_SRK

#define GAPROLE_SRK   0x302

Signature Resolving Key (Read/Write)

Note
If this is set to all 0x00's, the SRK will be randomly generated

size: uint8_t[16]

default: 0x00000000000000000000000000000000

range: 0x00000000000000000000000000000000 - 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

§ GAPROLE_TIMEOUT_MULTIPLIER

#define GAPROLE_TIMEOUT_MULTIPLIER   0x314

Supervision timeout (n x 10 ms) to use when performing param update (Read/Write)

size: uint16_t

default: 1000

range: 10-3200

Copyright 2017, Texas Instruments Incorporated