Health Server and Health Client models.

[Sumedh L]

Hello All,

I am currently developing a mesh application with several nodes. I wish to add the health server faults for monitoring the nodes in the network. As of now I am able to receive the health messages with no faults detected. Health Client was referred from the 'Provisioner Sample'. example where the callbacks printed out the detected errors.

Now I am already running a sensor server on the node and I required the faults occurring in the nodes to be sent to the client. As of now I am not able to find any samples regarding this issue.

I have referred to this documentation for the health server and this documentation for the health client, but do not understand how to actually send the faults to the client.

Could someone send any samples for the same?

Currently developing using nRF Connect SDK v2.1.2 and nRF52840 dongle for evaluation.

[Hieu]

Hi Sumedh,

I will need more time to look into this. Unless someone from the community already helped you by then, I will respond to you latest by the end of Wednesday Jan 18.

Hieu

[Sumedh L]

Thank you for your response Hieu.

We'll be waiting for any help on this topic.

Regards,

Sumedh L.

[AHaug]

Hi, 

Hieu is out of office this week so I will help you progress this case in the meanwhile.

As of now I am able to receive the health messages with no faults detected. Health Client was referred from the 'Provisioner Sample'. example where the callbacks printed out the detected errors.

Could you either send us a minimal sample that reproduces how far you've come in setting up the health server/client models in your application or send us steps for how to recreate what you've done?

Kind regards,
Andreas

[Sumedh L]

Hello Andreas,

Thank you for responding.

I have copied the following code from the sensor server sample provided. My main issue with this code is understanding how I am supposed to send the faults to the client. I have seen the faults and warnings mentioned in nrf/include/bluetooth/mesh/properties.h. I wish to use few of these codes send the health details of my node to the client.

static struct k_work_delayable attention_blink_work;
static bool attention;

static void attention_blink(struct k_work *work)
{
	static int idx;
	const uint8_t pattern[] = {
#if DT_NODE_EXISTS(DT_ALIAS(led0))
		BIT(0),
#endif
#if DT_NODE_EXISTS(DT_ALIAS(led1))
		BIT(1),
#endif
#if DT_NODE_EXISTS(DT_ALIAS(led2))
		BIT(2),
#endif
#if DT_NODE_EXISTS(DT_ALIAS(led3))
		BIT(3),
#endif
	};

	if (attention) {
		dk_set_leds(pattern[idx++ % ARRAY_SIZE(pattern)]);
		k_work_reschedule(&attention_blink_work, K_MSEC(100));		//Changed the Blinking speed for the attention callback. SL
	} else {
		dk_set_leds(DK_NO_LEDS_MSK);
	}
}

/**
 * @brief: This function will enable the attention of the node.
 * This is the function that is executed during identification of the node in the nRF Mesh application.
*/
static void attention_on(struct bt_mesh_model *mod)
{
	attention = true;
	k_work_reschedule(&attention_blink_work, K_NO_WAIT);
}

/**
 * @brief: This function will disable the attention of the node.
 * This is the function that is executed during identification of the node in the nRF Mesh application.
*/
static void attention_off(struct bt_mesh_model *mod)
{
	/* Will stop rescheduling blink timer */
	attention = false;
}

static const struct bt_mesh_health_srv_cb health_srv_cb = {
	.attn_on = attention_on,
	.attn_off = attention_off,
};

static struct bt_mesh_health_srv health_srv = {
	.cb = &health_srv_cb,
};

BT_MESH_HEALTH_PUB_DEFINE(health_pub, 0);

On the Client end I implemented the following code for health client. I based this code from the Mesh_Provisioner sample provided. Now I wish to see the sent codes from the node here. 

static void current_health_status(struct bt_mesh_health_cli *cli, uint16_t addr,
				  uint8_t test_id, uint16_t cid, uint8_t *faults,
				  size_t fault_count)
{
	size_t i;
	
	printk("\nHealth Current Status from Node ID: %d\n", addr);
	
	if (!fault_count) {
		printk("\nHealth Test ID 0x%02x Company ID 0x%04x: no faults\n",
		       test_id, cid);
		return;
	}

	printk("Health Test ID 0x%02x Company ID 0x%04x Fault Count %zu:\n",
	       test_id, cid, fault_count);

	for (i = 0; i < fault_count; i++) {
		printk("\t0x%02x\n", faults[i]);
	}
}

static struct bt_mesh_health_cli health_client = {
	.current_status = current_health_status,
};

It would be useful to get some sample or guide on how to add these faults and send them as well as clear them if necessary.

Regards,

Sumedh.

[AHaug]

Hi, 

Unfortunately I did not have time to handle this case before I'm going out of office, but I will get back to it next week. Apologies for the inconvinience

Kind regards,
Andreas