Where is nrf_dfu_set_adv_name_init defined?

[rolandash]

Seems i can not find where nrf_dfu_set_adv_name_init is defined? It seems not in SDK source files, neither can find any sign on SDK documents.

Thank you.

[Hung Bui]

Hi Rolandash,

nrf_dfu_set_adv_name_init is defined by the Asynchronous supervisor function interface NRF_SVCI_ASYNC.

You can find this macro in ble_dfu_unbonded.c

NRF_SVCI_ASYNC_FUNC_DECLARE(NRF_DFU_SVCI_SET_ADV_NAME, nrf_dfu_set_adv_name, nrf_dfu_adv_name_t, nrf_dfu_set_adv_name_state_t);

"The async interface provides a method to call into a external application through the SVCI interface without relying on allocated or reserved memory inside the external application."

Basically it's the call from the buttonless application to the bootloader to write the advertising name that the application want the bootloader to advertise. You can find the call nrf_dfu_set_adv_name() in set_adv_name() inside ble_dfu_unbonded.c. This call will trigger nrf_dfu_set_adv_name_on_call() inside nrf_dfu_svci_handler.c in the bootloader.

[rolandash]

I did not find more document about asynchronous Supervisor function interface. What exactly 'asynchronous' means here? Does it imply that those function calls return without waiting for the execution results?