What does the 'vloc' mean in ble_gatts_attr_md_t ?

RE: What does the 'vloc' mean in ble_gatts_attr_md_t ?

jj8431 — Mon, 24 Jun 2019 11:49:02 GMT

Thanks Edvin, I didn't have particular reason to think about using user memory, just a bit worried about the memory size as the softdevice memory size was defined in the linker file, if I add one or many large attribute value size later in application code then if it will run out of memory. Anyway that's not a situation I'm facing right now, so I'll just use the stack memory as you suggested. Thanks a lot.

Regards,

Jian

RE: What does the 'vloc' mean in ble_gatts_attr_md_t ?

Edvin — Mon, 24 Jun 2019 07:40:20 GMT

Hello,

I wouldn't recommend to use the USER region unless you have a very specific reason to do so. The BLE_GATTS_VLOC_STACK is easier to use, as the softdevice handles all the updates and memory update for you. I haven't really looked into what you would need to do to use the USER, but it seems like a bit more work handling the lengths and so on. You can check my colleague, run_ar's, answer here:

https://devzone.nordicsemi.com/f/nordic-q-a/30040/ble_gatts_vloc_user-and-volatile-variable

[quote user="jj8431"]I found the BLE_GATTS_FIX_ATTR_LEN_MAX is defined 510 and BLE_GATTS_FIX_ATTR_LEN_MAX is 512, does it mean if the value length is less than this value then we can use the stack memory, if I need more than that then I should use the user memory?[/quote]

That is not really the use case. The maximum length of a characteristic is not dependent on whether it is in the user memory or in the stack. The use case for the user memory area is if you are really restricted on memory, and you can manage the characteristics manually, knowing that you will never exceed the total limit. This is typically not the use case.

My tip to you is to use the BLE_GATTS_VLOCK_STACK, and use the get and set functions to manage them.

Best regards,

Edvin

RE: What does the 'vloc' mean in ble_gatts_attr_md_t ?

jj8431 — Sat, 22 Jun 2019 15:41:43 GMT

Thank you Paul and Edvin, that explained clearly. Now I have a further question about this, is there a guideline about when to use the stack memory and when to use the user memory? I guess if the value length is large then we should use the user memory? I found the BLE_GATTS_FIX_ATTR_LEN_MAX is defined 510 and BLE_GATTS_FIX_ATTR_LEN_MAX is 512, does it mean if the value length is less than this value then we can use the stack memory, if I need more than that then I should use the user memory? Thank you.

RE: What does the 'vloc' mean in ble_gatts_attr_md_t ?

Edvin — Fri, 21 Jun 2019 08:14:45 GMT

As Paul says, the vloc is short for value location, and BLE_GATTS_VLOC_STACK means that it is stored in the Bluetooth stack.

[quote user=""]the attribute value is apparently in the user memory ( encoded_bpm[] ), then why the 'vloc' is set to BLE_GATTS_VLOC_STACK ?[/quote]

The value is fetched from the user memory, but it is stored in the SoftDevice (bluetooth stack). So the encoded_bpm is only used to initialize the value. Similarly, the value can be updated by passing a pointer with a new value to the softdevice (the softdevice call depends on whether you use notifications or not.

I can recommend this tutorial if you want an introduction to BLE characteristics. There are some other tutorials on BLE here as well.

RE: What does the 'vloc' mean in ble_gatts_attr_md_t ?

paul — Fri, 21 Jun 2019 05:00:43 GMT

Hi JJ,

the GATT characteristic table can be stored in two places: on the stack as above or in user memory. I think vloc is short for value location. The stack location is the softdevice stack I believe. Your stuff gets copied in. Stack is better but you can easily run out of space. Vlen is completely different in specifying whether there are any variable length characteristics.

Cheers Paul