LinkMargin availibility

RE: LinkMargin availibility

Jørgen Holmefjord — Thu, 25 Nov 2021 16:51:20 GMT

Hi,

Where did you call the functions? Do you get any errors/resets when calling the functions?

I tested by adding this to thread_state_changed_callback() in the simple_coap_client example:

case OT_DEVICE_ROLE_CHILD:
{
    otError error;
    otRouterInfo link_quality;
    error = otThreadGetParentInfo(thread_ot_instance_get(), &link_quality);
    ASSERT(error == OT_ERROR_NONE);
    NRF_LOG_INFO("mLinkQualityIn: %d", link_quality.mLinkQualityIn);
}
break;

When the device enters a Thread network as a child device together with the simple_coap_server example, The log will output 3 in my test.

Best regards,
Jørgen

RE: LinkMargin availibility

Nppn7 — Mon, 22 Nov 2021 12:48:04 GMT

Hi,

how can I extract the mLqi? I can not see any function to get this value. I only see that it is inside structot_thread_link_info. Also there is no function to get this. What we tried is this:

otError error;
otRouterInfo *link_quality;
error = otThreadGetParentInfo(COMWIRELESS_ot_instance, link_quality);
ASSERT(error == OT_ERROR_NONE);
link_U8 = (link_quality->mLinkQualityIn);

and this:

S8 *Rssi_S8;
otError error;
error = otThreadGetParentLastRssi(COMWIRELESS_ot_instance,Rssi_S8);

Both resulting in blocking the joining process. Also the debugger behaves weird and stops in thread_api.cpp (only in disassembly).

RE: LinkMargin availibility

Jørgen Holmefjord — Tue, 16 Nov 2021 11:01:21 GMT

Hi,

Sorry, I got confused from your images circling Link Metrics and corresponding pages without Link Metrics in the APIs.

You can get the Link Quality indicator otThreadLinkInfo::mLqi parameter, and convert this to Link Margin according to the table in section 5.9.4. This parameter is transmitted between neighbors, so I'm not sure if the exact Link margin value is available. As the sections mentions: "Having only four possible link quality values minimizes the overhead of communicating link qualities to neighbors."

Best regards,
Jørgen

RE: LinkMargin availibility

Nppn7 — Tue, 16 Nov 2021 10:22:48 GMT

Hi,

thank you for your reply. As far as I know the Link Margin (not Link Metrics) should be included in Thread 1.1.1 (chapter 5.9.4). If nRF5 SDK for Thread and Zigbee v4.1.0 (Release Date: Week 18, 2020) is based on Thread 1.1.1, then there should be some possibility to extract it. Is that correct? How can I do it?

Also I would like to know what mLinkQualityIn is.

Thanks.

RE: LinkMargin availibility

Jørgen Holmefjord — Thu, 11 Nov 2021 09:55:09 GMT

Hi,

Link Metrics is a Thread 1.2 feature (see page 6 of this document: https://www.threadgroup.org/Portals/0/documents/support/Thread%201.2%20Base%20Features.pdf).

Thread 1.2 features are not supported in nRF5 SDK for Thread and Zigbee, however some Thread 1.2 features are supported in nRF Connect SDK (NCS), including Link metrics.

The exact commit hash for the OpenThread version used in nRF5 SDK for Thread and Zigbee can be found in the file: external\openthread\project\readme.txt. For version 4.1.0 of the SDK, this commit is used: https://github.com/openthread/openthread/tree/c6a258e3a5bd90aa26d8245c435c0ae5797027f4

nRF Connect SDK uses a downstream copy of OpenThread, found here: https://github.com/nrfconnect/sdk-openthread

In NCS, you can choose between building OpenThread from source, or use the prebuilt libraries.

Best regards,
Jørgen