How to subscribe/read a characteristic over BLE?

RE: How to subscribe/read a characteristic over BLE?

ovrebekk — Tue, 07 Feb 2023 09:43:45 GMT

[quote user="jksu"]This would return 49 for 1, 50 for 2, etc.[/quote]

Yes, 49 is the ASCII Code for '1', 50 for '2 and so on.

There is another trick to print non null terminated strings, as explained here.
I don't remember if I tested this with printk(..), but you could always give this a go. In the ble_data_received callback it should look something like this:

printk("Received string: %*.s\n", len, data);

Best regards
Torbjørn

RE: How to subscribe/read a characteristic over BLE?

jksu — Fri, 03 Feb 2023 23:37:54 GMT

Hello!

Once again, I appreciate the detailed answer! If there will be a simpler example in the future, I would definitely be interested in reading through it

As for my original question, your answer worked for me! I originally tried printing the data you mentioned in your answer above, but I ended up getting weirdly interpreted values, as I was printing with a PRId8 type specifier. This would return 49 for 1, 50 for 2, etc. I changed the format specifier to a char, and the answer came as expected!

static uint8_t ble_data_received(struct bt_nus_client *nus,
								 const uint8_t *data, uint16_t len)
{
    ...
        for (int i=0;i<len;i++){
    		printk("%c", data[i]);
    	}
    	printk("\n");
    }
	
	return BT_GATT_ITER_CONTINUE;

I hope it seems that I've implemented this properly, but as you mentioned, there's likely a cleaner way to handle the data.

Anyways, thank you again for answering my questions!

RE: How to subscribe/read a characteristic over BLE?

ovrebekk — Fri, 03 Feb 2023 09:11:04 GMT

The data is actually provided directly in the arguments of the ble_data_received function:

static uint8_t ble_data_received(struct bt_nus_client *nus, const uint8_t *data, uint16_t len)

The second argument points to the data buffer, and the third argument provides the length.

In theory you could delete more or less the entire implementation of this function, with the exception of the return call at the end, and just process the data in some other way.

(The standard example is not the best IMO as it uses dynamic memory allocation, and makes the flow of the code pretty hard to follow, and I have it on my todo list to try and provide a simpler example.)

It is important to note that this callback function is running in an interrupt context, which means it is very limited what you are allowed to do in the callback directly.

The normal way to handle this is to move the data into a separate buffer, and set a flag or a semaphore that allows you to process the data from the thread context rather than in the interrupt.

Best regards
Torbjørn

RE: How to subscribe/read a characteristic over BLE?

jksu — Thu, 02 Feb 2023 23:40:27 GMT

Hello Torbjørn,

Thank you for such a quick reply! Upon messing around with my code a little bit, I ended up getting the TX characteristic to print out via Serial on the Central device, so the code does work as expected. I think there was an issue caused by having CONFIG_ASSERT=y on the peripheral prj.conf.

Your answer makes a lot of sense, and I took a look at the parts of the code you referenced, and the flow is more apparent to me now. One more thing that might be helpful for me is how to extract or store the TX characteristic data. I see in the nus_client.c file, the TX data is returned on line 44 by this snippet:

if (nus->cb.received) {
	return nus->cb.received(nus, data, length);
}

I'm having a bit of trouble tracing the value down in main(), but I suspect it may be somewhere near ble_data_received() and tx->data, but I haven't been fruitful in my attempts to track down where the data is being put. Any clarification would be appreciated!

RE: How to subscribe/read a characteristic over BLE?

ovrebekk — Thu, 02 Feb 2023 14:47:42 GMT

The central_uart should subscribe to the RX characteristic out of the box. Are you not able to get this to work?

If you look inside the discovery_complete(..) callback on line 293 of main.c you will notice it calls the bt_nus_subscribe_receive(..) function, the implementation of which can be found on line 172 of nus_client.c.

Here you can see how it calls bt_gatt_subscribe(..), after checking that notifications are not enabled already. It also sets a callback function called on_received which will be used to process incoming data from the connected peripheral. The on_received(..) callback function will in turn call the received callback, which triggers ble_data_received(..) in main.c.

If you want to make your own proprietary characteristic then a good way to do this is simply to copy the existing nus implementation, give it a different name (replacing all instance of "nus" or "NUS" with your own name), and then modifying it as you see fit.

You should also give it a different 128-bit UUID to ensure you don't get your device mixed up with all the devices using NUS.

Best regards
Torbjørn