NUS Echo

This example shows testing of a device that has NUS echo implemented. NUS is the Nordic UART service, which is a BLE service that allows reading and writing data similar to a traditional UART interface. Use this test for any device that has NUS echo; that is, it sends back whatever is sent to it. This example is designed to work with the HIL nRF53 demo project, which by default will advertise with the name "EmbedOps HIL Demo Device" and has a NUS echo implemented.

It consists of two files:

conftest.py - Implements a fixture that connects to the first device with EmbedOps in the name.

test_default.py - Contains a test that sends data and asserts that the received data is the same as what was sent.

This test also makes use of the pytest-asyncio module, which adds asyncio capabilities to PyTest.

conftest.pytest_nus_echo.py

import os
import pytest
import pytest_asyncio

from hil_sdk.interfaces.ble.ble_client import BLEClient
from hil_sdk.interfaces.ble.nordic.ble_nus_service import BLENUSService
from hil_sdk.interfaces.ble.ble_scanner import BLEScanner

@pytest_asyncio.fixture
async def ble_nus_fixture(reset_fixture):

    devices = await BLEScanner.find_devices()

    address = None
    device = None
    for d in devices:
        if "EmbedOps" in d.name:
            address = d.address
            device = d

    if address is None:
        print('EmbedOps device not found!')
        assert False

    print("EmbedOps address: " + address)

    client = BLEClient(device)
    await client.connect()
    nus_service = BLENUSService(client)

    yield nus_service

    await client.disconnect()

import asyncio
import pytest
import pytest_asyncio

@pytest.mark.asyncio
async def test_ble_nus(ble_nus_fixture):

    test_data = b"This is a test"

    async def rx_callback(uuid, data):
        assert data == test_data

    await ble_nus_fixture.set_nus_received_cb(rx_callback)

    await ble_nus_fixture.write_nus(test_data)

    await asyncio.sleep(5)