bt_le_advert_parm_t

Structure for parameters that applications may request for low energy advertisements.

Synopsis:

typedef struct  {
    uint16_t minAdvertInterval1 ;
    uint16_t maxAdvertInterval1 ;
    uint32_t time1 ;
    uint16_t minAdvertInterval2 ;
    uint16_t maxAdvertInterval2 ;
    uint32_t time2 ;
}bt_le_advert_parm_t;

Since:

BlackBerry 10.2.0

Data:

uint16_t minAdvertInterval1
The minimum initial advertising interval used when no connection exists.
  • Range: 0x0020 to 0x4000
  • Time = N * 0.625 msec
  • Time Range: 20 msec to 10.24 seconds
uint16_t maxAdvertInterval1
The maximum initial advertisement interval used when either a connection exists or advertising.
  • Range: 0x0020 to 0x4000
  • Time = N * 0.625 msec
  • Time Range: 20 msec to 10.24 seconds
uint32_t time1
The time (in msec) to perform the initial advertisements.

Use GATT_TIME_INFINITY to run until the connection is created or disconnected. If time1 is set to 0, then the initial interval is disabled and the second interval is used instead for power saving when fast advertising is not required.

uint16_t minAdvertInterval2
The minimum second advertisement interval, used after time1 has expired or when a connection exists.
  • Range: 0x0020 to 0x4000
  • Time = N * 0.625 msec
  • Time Range: 20 msec to 10.24 seconds
uint16_t maxAdvertInterval2
The maximum second advertisement interval, used after time1 has expired or when a connection exists.
  • Range: 0x0020 to 0x4000
  • Time = N * 0.625 msec
  • Time Range: 20 msec to 10.24 seconds
uint32_t time2
The time (in msec) to perform the second stage of the advertising process.

Use 0 to disable the second stage or GATT_TIME_INFINITY to run until advertisement is stopped.

Library:

libbtapi (For the qcc command, use the -l btapi option to link against this library)

Description:

Ranges of values are specified for advertisement intervals. Application-requested values must fall within the specified range. If different values are requested by multiple applications, the lowest value that is within the range will be used as the advertising value.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus