RE: Queued Writes intentions and clarifications?

awneil — Thu, 30 Apr 2020 10:17:49 GMT

[quote userid="8101" url="~/f/nordic-q-a/34664/queued-writes-intentions-and-clarifications"]My sincerest plea for Nordic is someone write “how we intended this to be used” notes on SDK15 and beyond. A questionably readable example is not a replacement. [/quote]

I heartily agree!

To be fair, it's not just Nordic - this seems to be endemic in manufacturer-provided libraries & SDKs. [1]

It's not helped by the over-reliance on Doxygen-generated documentation, which will naturally produce very "close-in" documentation of individual functions/types/variables etc - but all too often lacks the overview, context and intention of the system or module as a whole.

The examples don't help in this, as they provide no explanation of the structure, or process of creating the application - they are purely presented as a done & dusted fait accompli.

The "description" is little more than. "press that button and see this happen"

For example: https://devzone.nordicsemi.com/f/nordic-q-a/60875/multi-link-peripheral---what-is-really-needed - which is what prompted the wakeup of this old thread.

Sorry - rant over.

EDIT

[1] To illustrate "seems to be endemic in manufacturer-provided libraries & SDKs", see:

https://www.avrfreaks.net/comment/2200431#comment-2200431

and the reply there.

RE: Queued Writes intentions and clarifications?

bjorn-spockeli — Tue, 29 May 2018 14:12:55 GMT

Hi SRA,

First, I apologize for the late reply.

Your feedback has been noted and I will suggest that the documentation is expanded upon and/or a blog post is written on the topic.

Q1: Yes, Prepare Write Request/Response and Execute Write Request/Response is defined by the Bluetooth Specification, see BLUETOOTH SPECIFICATION Version 5.0 | Vol 3, Part F, Section 3.4.6 Queued Writes.

Q2: Yes, the maximum size of an attribute is limited to 512 bytes, hence this is also the limit for queued writes.

Q3: Yes, each Prepare Write Request must be replied to by calling sd_ble_gatts_rw_authorize_reply ( SD will then reply with ATT Prepare Write Response), see GATTS Queued Writes: App handled, no attributes require authorization or the other Queued Writes Message Sequence Charts found here. So yes, you'll only see one packet per connection interval when using Queued Writes.

Q4: You are correct that the Queued Write operation is not widely used. I think that the overhead is 4 bytes (Attribute handle 2 bytes + Attribute Offset 2 bytes) per 18 byte data. I would rather the low throughput compared to write commands is the reason for its little use.

Best regards

Bjørn