What is a 'system attribute'

RE: What is a 'system attribute'

brianreinhold — Wed, 13 Nov 2019 10:02:17 GMT

I sort of went forward on that assumption. I save the CCCD tables on shutdown with that 'get' and restore them on connection with that 'set'. I save the table to a file in between. Still can get service-changed to work. Still get BLE_ERROR_GATTS_SYS_ATTR_MISSING.

RE: What is a 'system attribute'

tesc — Wed, 13 Nov 2019 09:47:03 GMT

Hi,

After a chat with the SoftDevice team, I can confirm that:

System attributes are the parts of the GATT database that should be kept for bonded peers, that is, they should be restored after reconnecting. CCCDs are among the things that needs to be kept for bonded peers.

System services are default services, such as the GAP service with characteristics such as Peripheral Preferred Connection Parameters (PPCP), Service Changed, etc., that are controlled by the SoftDevice, e.g. either through SoftDevice configuration or because they are mandatory.

User services are the services added by the application. That can be either SIG defined services such as the Heart Rate Service, or it can be vendor specific services such as the Nordic UART Service (NUS).

Regards,
Terje

RE: What is a 'system attribute'

brianreinhold — Tue, 05 Nov 2019 17:26:13 GMT

All for it!

I went ahead and did the 'set()' call in the connection event since the 'MISSING' event was not getting signaled. I got no error but I still could not invoke a service changed event. I get the same results:

Starting at handle zero and incrementing I got 14 invalid handle errors and then when it hit 14 (value 0x0d) I got the BLE_ERROR_GATTS_SYS_ATTR_MISSING error. Same value as in the attribute table returned by the get() method.

RE: What is a 'system attribute'

tesc — Tue, 05 Nov 2019 17:17:25 GMT

Hi,

Let's continue the discussion in the thread Why don't I get a BLE_GATTS_EVT_SYS_ATTR_MISSING event? I am currently looking into the matter.

Regards,
Terje

RE: What is a 'system attribute'

brianreinhold — Tue, 05 Nov 2019 10:08:36 GMT

I do as you say. But I have one major issue. On the bonded re-connect, the BLE_GATTS_EVT_SYS_ATTR_MISSING is never signaled. Why?

I suppose that is causing the headaches I am having with invoking a service-changed indication?

Since the central re-writes the CCCDs I still get the measurements but the central should not have to do that. It does because there are too many bad devices out there that don't bond correctly when it comes to CCCDs.

RE: What is a 'system attribute'

brianreinhold — Tue, 05 Nov 2019 09:34:40 GMT

Why would I get this

BLE_ERROR_GATTS_SYS_ATTR_MISSING

when trying to invoke a service changed sd_ble_gatts_service_changed() method?

It is clear that the peer has enabled the characteristic for indications.

Then the docs say to use these functions

uint8_t* p_sys_attr_data;
uint16_t p_len = 0;
sd_ble_gatts_sys_attr_get(m_adapter, m_connection_handle, NULL, &p_len, BLE_GATTS_SYS_ATTR_FLAG_SYS_SRVCS);
p_sys_attr_data = calloc(1, p_len);
sd_ble_gatts_sys_attr_get(m_adapter, m_connection_handle, p_sys_attr_data, &p_len, BLE_GATTS_SYS_ATTR_FLAG_SYS_SRVCS);
sd_ble_gatts_sys_attr_set(m_adapter, m_connection_handle, p_sys_attr_data, p_len, BLE_GATTS_SYS_ATTR_FLAG_SYS_SRVCS);

to set them to a known value??? Then I look at the table in p_sys_attr_data and it is 8 bytes. I have no idea which attribute it is talking about. There is no UUID. I get handle 13, two bytes length, value 0, and a checksum.

What am I supposed to do with that and how does it pertain to the 'set' function?
Do I pick what I want out of thin air?
What's wrong with the value already there?
How is that even related to the service table that I am changing? (In this case the DIS is being removed).

RE: What is a 'system attribute'

brianreinhold — Fri, 01 Nov 2019 11:02:24 GMT

Now that I am trying to use these methods there are two flags

#define BLE_GATTS_SYS_ATTR_FLAG_SYS_SRVCS (1 << 0) /**< Restrict system attributes to system services only. */
#define BLE_GATTS_SYS_ATTR_FLAG_USR_SRVCS (1 << 1) /**< Restrict system attributes to user services only. */

I think I now understand the system services. But what is a user service?

If I do this procedure, will I get the

BLE_GAP_EVT_SEC_INFO_REQUEST

any more?

Right now I save the security keys myself and restore them on that event. The documentation for the sd_ble_gatts_sys_attr_set() method does not specifically mention security keys and I get the idea that it is only CCCDs and the like, and no security keys.

To add to the problem, @ref BLE_GATTS_SYS_ATTRS_FORMAT described in the call to the *_get() method does not exist. I need to know what state the collector left the CCCDs in on a reconnect.

RE: What is a 'system attribute'

tesc — Tue, 29 Oct 2019 16:36:40 GMT

Hi,

While you are in a connection, the SoftDevice will handle the CCCD as appropriate. When the peer writes to CCCD, that will be handled by SoftDevice.

The only thing related to the CCCD that you have to do from the application, is to store the data you get from sd_ble_gatts_sys_attr_get() on disconnection, and provide it back to the SoftDevice with sd_ble_gatts_sys_attr_set() on the BLE_GATTS_EVT_SYS_ATTR_MISSING event. You should treat the data as a blob of data of unknown format, i.e. you should store it as is and provide it back as is, without changing it. You should not try to write to the CCCD directly from the application.

Regards,
Terje

RE: What is a 'system attribute'

brianreinhold — Tue, 29 Oct 2019 15:59:26 GMT

So the bottom line is this: I do save the stuff myself. But when I read in that the measurement descriptor has been enabled, can I set the descriptor to the appropriate notify/indicate setting using the write method as when the client does it? And do it before I start advertising?

RE: What is a 'system attribute'

tesc — Tue, 29 Oct 2019 15:51:10 GMT

Hi,

The SoftDevice uses a fixed amount of RAM for a given configuration, and only stores the data needed for the current connections. It does not use any permanent storage. Hence anything not related to the current connections, that should be saved for later, must be handled by the application.

When using the SD API directly you must do the work storing keys yourself. See e.g. the p_sec_keyset in/out parameter for sd_ble_gap_sec_params_reply(). You can also have a look at the GAP Message Sequence Charts, in particular the (Central / Peripheral) Security Procedures.

Regards,
Terje

RE: What is a 'system attribute'

brianreinhold — Fri, 25 Oct 2019 14:16:44 GMT

I am using the pc-ble-driver so I need to work with the sd_* methods and events directly. I prefer that in some sense because I am doing testing which means sometimes I have to do things which are considered bad and the SDK would not do.

Do those methods also save the various keys? I am wondering because now I have to handle an keys request event from the client where I give the keys to the client. If I use the above sd call to restore the state, will I still get signaled the key request event or will the SoftDevice handle it automatically?

RE: What is a 'system attribute'

tesc — Fri, 25 Oct 2019 13:44:29 GMT

Hi,

I would rather describe it as a SoftDevice API that lets you, or an SDK library, do the work. From the application you must, somehow, call sd_ble_gatts_sys_attr_get() to store the state, and sd_ble_gatts_sys_attr_set() to restore it. See GATTS System Attributes Handling: Bonded Peer and ... Unknown Peer for message sequence charts.

If you use our SDK this would be automatically handled through the Peer Manager library. So in that case you do not need to worry about the system attributes at all.

Regards,
Terje

RE: What is a 'system attribute'

brianreinhold — Thu, 24 Oct 2019 15:45:57 GMT

Okay, I figured it might be something like that but I needed to be sure.

On your second remark I have been storing the keys and the CCCD state myself. I give the keys to the peer on a reconnect when asked, and when encryption is done I just assumed the CCCD state was remembered. I just used the CCCD state to say I can start sending data as soon as encryption is finished. Since the peer re-writes the CCCDs every time to handle those bad devices that say they bond but don't save the CCCD state I was never sure that it was set before the peer set it.

So there are APIs that do this work for me?

RE: What is a 'system attribute'

tesc — Thu, 24 Oct 2019 15:29:03 GMT

Hi,

By "system attributes" we primarily mean the Client Characteristic Configuration Descriptors (CCCD), i.e. attributes that are handled by the SoftDevice and have special requirements. It is mandated by Bluetooth specification that CCCD values are altered only by the peer, so you cannot change them from the application. Since CCCD values for a bonded peer should be stored between connections, an API exist for the application to store the values after disconnection, and to restore them on connection.

Regards,
Terje