triggering model reset handler

[Ubaid_M]

Hi, 

I have implemented a set of custom mesh models on nCS. In vendor models we have reset handlers, as in nrf documentation: https://developer.nordicsemi.com/nRF_Connect_SDK/doc/2.0.0/nrf/ug_bt_mesh_vendor_model_dev_overview.html#:~:text=The%20model%20reset%20handler%20is%20called%20when%20the%20mesh%20node%20is%20reset

I have two questions here:

1. What are the guidelines to write reset handlers, I mean what should they do..?
2. How do I trigger reset handlers to test..? I do not know how a node is reset, hence kindly suggest how to trigger reset handler.

Thanks,

[AHaug]

Hi,

I will consult with some of my colleagues early next week regarding your questions, but in the meanwhile could you elaborate a bit about your questions for me:

What are the guidelines to write reset handlers, I mean what should they do..?

Correct me if I am wrong, but from the documentation you just linked I would think the reset handler should do the following: "The model reset handler is called when the mesh node is reset. All of the model’s configuration is deleted on reset, and the model should clear its state. If the model stores any persistent data, this needs to be erased manually", 

How do I trigger reset handlers to test..? I do not know how a node is reset, hence kindly suggest how to trigger reset handler.

You could try to call this function to reset the node: https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/zephyr/connectivity/bluetooth/api/mesh/cfg_cli.html?highlight=node%20reset#c.bt_mesh_cfg_node_reset

Let me know if any of this helps, and please feel free to add more information regarding your ticket!

Kind regards,
Andreas

[Ubaid_M]

Hi,

To be more specific, each model has below instance of "bt_mesh_model_cb"

const struct bt_mesh_model_cb _bt_mesh_srv_cb =
{
	.init = bt_mesh_srv_init,
	.start = bt_mesh_srv_start,
	.reset = bt_mesh_srv_reset,
};

I need to know how to invoke ".reset"

[AHaug]

Hi,

I believe our Mesh samples shows how to use the callback function to invoke the reset, and it is often called with a button (often set to button number 4), I will take a closer look at this tomorrow and see if I can find a specific sample!

Kind regards,
Andreas

[Ubaid_M]

Hello AHaug,

AHaug said:

our Mesh samples shows

Here you suggested entire mesh model documentation, no where I found on how to invoke ".reset"..?
Kindly suggest :

Ubaid_M said:

Hi,

To be more specific, each model has below instance of "bt_mesh_model_cb"

Fullscreen

1

2

3

4

5

6

const struct bt_mesh_model_cb _bt_mesh_srv_cb =

{

.init = bt_mesh_srv_init,

.start = bt_mesh_srv_start,

.reset = bt_mesh_srv_reset,

};

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

const struct bt_mesh_model_cb _bt_mesh_srv_cb =
{
	.init = bt_mesh_srv_init,
	.start = bt_mesh_srv_start,
	.reset = bt_mesh_srv_reset,
};

I need to know how to invoke ".reset"

[AHaug]

Hi,

Apologies for the delay, I were not able to find a specific sample that showed how this is done. I will have to ask around some more to see if I can find a sample that illustrates this properly. 

I will get back to you on monday.

Kind regards,
Andreas

[Ubaid_M]

Hi,

Ubaid_M said:

no where I found on how to invoke ".reset"..?

Please suggest

Thanks,

[AHaug]

Hi,

Apologies for the further delay. I have been out of office for the last week.

Unfortunately we do not have any existing samples showing how to do this, and in looking into how to use the reset node function I previously sent, I realized I have sent you the wrong reset function. What you want to do is void bt_mesh_reset(void) from the core API to reset the node, followed by int bt_mesh_prov_enable(bt_mesh_prov_bearer_t bearers) if you want to provision the node in a new network. You may disregard the latter if you only want to test the reset of the node.

The reset handler is a callback that you can choose to implement and register for your model. This will be called when the node is reset and it is specific for your model.

What you need to do is to implement this model reset callback, on the shape of void (*const reset)(struct bt_mesh_model *model). If its required to do some manual resetting in your model when node resetting, such as if you need to update something stored in flash or in RAM that needs to be updated. As an example, if you have a server-model you will need to reset the stored state of the model. You can bind a button to trigger the bt_mesh_reset() call

Everything else with regards to the node reset that the stack and our model implementations for standard models from BT SIG is already handled by the stack.

Thank you for your patience,

Kind regards,
Andreas

[Ubaid_M]

Hi AHaug,

I am unaware about the same, 
Now coming back to my original question

Ubaid_M said:

I need to know how to invoke ".reset"

AHaug said:

if you need to update something stored in flash or in RAM that needs to be updated. As an example, if you have a server-model you will need to reset the stored state of the model.

This is exactly what I am supposed to do,

But I cannot do this through a push button, I need to know how to reset a node wirelessly.

Is there a provision for the same in nrf mesh android app..?

How do I invoke the reset callback from  nrf mesh android app..?

[AHaug]

Hi,

Take a look at configuration models functionality, specifically at Node Reset command.. The client needs to send it and server to handle it. It will perform remote device resetting including models. This is config client related API: https://github.com/zephyrproject-rtos/zephyr/blob/main/include/zephyr/bluetooth/mesh/cfg_cli.h#L208-L216

Ubaid_M said:

How do I invoke the reset callback from  nrf mesh android app..?

After flashing and provisioning your application you will find your application in nRF Mesh for android

 

Pressing the application and scrolling down to the bottom will show the reset node button for wireless node reset.

Please check out the sample to see where and how the callbacks are handled in and by the sample before implementing it in your own custom application.

Kind regards,
Andreas

[Ubaid_M]

Hi,

Thanks, This is what I was looking for.
Please mark as solved