Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
[TW#15769] Better docs needed for esp_ble_gatts_create_service -> num_handle #1087
There is a new signature on the exposed API called
num_handle: number of handle requested for this service
I'd like to humbly request that the documentation for this be improved upon. My guess is that this parameter represents the number of handles to be allocated to the service. Reading the current statement, one might assume that this is the "number OF the handle" to be used as the start of handles. That might just be a simple grammar error.
However, when attempting to contemplate this function, the reader will now be puzzled by the notion. Among his questions will be:
referenced this issue
Oct 8, 2017
@nkolban What is a handle? --> An attribute handle is a 16-bit value that is assigned by each server to its own attributes to allow a client to reference those attributes. An attribute handle shall not be reused while an ATT Bearer exists between a client and its server.
This is pure gold and MANY thanks for taking the time to write it up. I'm thinking that folks may not find this information easily. Would it be possible to write up this information in the documentation somewhere in here:
Again ... many thanks.