Please consolidate nRF9160 documentation about CP-RAI and AS-RAI

[Achim Kraus]

Knowing, that the AS-RAI implementation is experimental, I would still prefer to have more documentation about the details.

I already asked for these details in an other issue (see Details of AS-RAI and CP-RAI fallback ) but for me there are still some gaps.

The above referred thread discussed, that requesting to use Rel. 14 AS-RAI, the modem falls back to Rel. 13 CP_RAI, if AS-RAI isn't supported by the network provider. So far, so good. The nasty point seems to be, that you can't use this fallback without knowing that, because the supported options seems to differ for AS-RAI and CP-RAI and a function to see, that the modem decided to fall back, is missing.

My results (the trace are provided in the referred thread):

With Rel. 14 AS-RAI only the SO_RAI_NO_DATA seems to work, with SO_RAI_ONE_RESP I had no success.

With requesting Rel. 14 AS-RAI, but fallback to Rel. 13 CP-RAI, SO_RAI_NO_DATA doesn't work, but SO_RAI_ONE_RESP is now working.

My questions:

1. Please document, which options are working in which mode (SO_RAI_NO_DATA, SO_RAI_LAST, SO_RAI_ONE_RESP combined with Rel. 14 AS-RAI, AS-RAI fallback to CP-RAI).

2. Is it possible the check, if the modem falls back to Rel. 13 CP-RAI? Especially, if the first question shows, that there are no common supported options, such a function helps to implement a working application.

Thanks in advance. 

[Michal Mühlpachr]

dejans said:

Our customers do not need to know which RAI is supported or which is enabled (if any).

We are your customer and we need to know that for troubleshooting purposes.

Knowing that and reporting that to our backend occasionally brings insight about operator/transport in use and allows battery lifetime estimation (based on communication power usage estimation). The modem do not provide information about "power consumed" unfortunately, so we do not have any other possibility how to estimate battery lifetime in case power consumption key drivers are unknown.

How would you suggest estimating energy consumed by the modem without knowing those details?

[dejans]

Hi,

Michal Mühlpachr said:

What about SO_RAI_NO_DATA in this case?

Nothing should happen with SO_RAI_NO_DATA. 

Best regards,
Dejan

[Achim Kraus]

To "ignore" SO_RAI_NO_DATA is for some customers not "nothing" ;-).

My feeling is, there are very different understandings, what should happen.

For Nordic it seems to be "the best possible way" to not report, if a requested RAI option is effective or not.

For developer, which want to implement energy efficient applications, "the best possible way" would be at least an error-code, if a requested RAI option is not effective. A "smart mapping" of not supported options into implicit working options (e.g. "SO_RAI_ONE_RESP" with Rel. 14 AS-RAI into "SO_RAI_NO_DATA" after receiving a incoming data) would be an improvement. Or at least a documentation, where it get's clear, that SO_RAI_ONE_RESP and SO_RAI_NO_DATA are intended to be used together, if it's unclear, which RAI version you get.

All in all:

Your customers are spending so much time in your "best possible way" of not reporting details, that this gets very expensive.

[Didrik Rokhaug]

Hi,

Dejan is currently on vacation, so I have taken over this ticket.

Is there anything that is still unclear?

I'll see what I can do regarding a sample or more documentation on how to use RAI.

Best regards,

Didrik

[Achim Kraus]

To mention what works and what works not in the documentation would have saved a lot of time, at least for me.

In my opinion it is not "the best possible way" to swallow a SO_RAI_ONE_RESP or SO_RAI_NO_DATA in the case it is not supported. Either returning an error code or the actual RAI mode supported by the network would enable users to write better applications and understand the network features.