ARMmbed / ARMmbed/ble

BLE API does not handle minimum and maximum intervals as in the specification

Open
#133 7 comments 0 reactions 0 assignees View on GitHub
bug mirrored
Dominant language
C++
Stars
81
Forks
71
PR merge metrics
No merged PRs in 30d

Description

In the BLE API Gap.h contains the following functions:
- `getMinAdvertisingInterval()`
- `getMinNonConnectableAdvertisingInterval()`
- `getMaxAdvertising interval()`

The Bluetooth v4.2 specification states the following in [Vol 6, Part B] Section 4.4.2.2:

```
The advInterval shall be an integer multiple of 0.625 ms in the range of 20 ms
to 10.24 s. If the advertising event type is either a scannable undirected event
type or a non-connectable undirected event type, the advInterval shall not be
less than 100 ms. If the advertising event type is a connectable undirected
event type or connectable directed event type used in a low duty cycle mode,
the advInterval can be 20 ms or greater
```

Taking this into account, it is not clear from the BLE API documentation what are the differences between `getMinAdvertisingInterval()` and `getMinNonConnectableAdvertisingInterval()`.

Contributor guide

Open the contributing guide

Research direction

Start with Gap.h and the documentation for getMinAdvertisingInterval(), getMinNonConnectableAdvertisingInterval(), and getMaxAdvertising interval(). Compare their intended behavior with Bluetooth v4.2 Vol 6, Part B, Section 4.4.2.2. Done means the API documentation clearly explains the distinctions and the minimum and maximum interval rules.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
api, documentation, embedded-iot
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.