nRF Util on Ubuntu 20: unable to capture modem trace

RE: nRF Util on Ubuntu 20: unable to capture modem trace

io22m007 — Tue, 15 Aug 2023 01:44:55 GMT

Update:

For Modem Firmware 1.3.5 this has been resolved with the update to version 2.1.0 of nRF Util Trace. Thank you to the Nordic team for releasing this update.

If anyone is facing this issue in the future with a newer version of the Modem Firmware, I documented the fix I applied before the update below the horizontal line.

Here is the long version for context:

I did some further testing with nRF Util on Ubuntu 20 and Windows 11.

In essence I get a very similar error on both platforms.

Here is the error message I get on Windows 11:

Error: Tracing failed

Caused by:
    unable to locate db directory  plugin path: C:\Users\flori\.nrfutil\lib\nrfutil-trace/plugins\nrfml-insight-source.nrfml (error code 100)

But when I copy this path into file explorer, I'm able to open the file.

On both operating systems the error applies to both live capture from the COM Port directly and converting a binary file which was captured with a few lines of python code. I used the same COM Port for direct capture with nRF Util and for capture with the python code

These binary files can be read and converted into pcapng files with nRF Connect Cellular Monitor.

Furthermore, I tried to include the AT command AT+CGMR at the start of my routine. My thought behind that was that it might be good to include the modem firmware version in the trace since nRF Connect Cellular Monitor also uses this information. But this didn't help to resolve the issue.

I noticed that a new version of nRF Util trace is now available (update from 1.0.1 to 2.0.0).

But even with this new version I got the same error as before on both platforms.

Uninstalling and re-installing nRF Util trace didn't help either

I then looked into nRF Util trace a bit further and found the --keep-configuration option. I exported a configuration file and found the trace_db_locations entry. I opened the file and found that the trace db for modem firmware 1.3.5 is missing in release 2.0.0 of nRF Util trace (and probably was missing in the last release as well).

What is the problem:

I'm using modem firmware 1.3.5 and the trace db for modem firmware 1.3.5 is missing from the current release of nRF Util trace.

This was the solution to my problem:

I downloaded the following three files from GitHub:

https://github.com/NordicSemiconductor/pc-nrfconnect-cellularmonitor/blob/main/resources/traceDB/config_v2.json

https://github.com/NordicSemiconductor/pc-nrfconnect-cellularmonitor/blob/main/resources/traceDB/mfw_nrf9160_1.3.5-FOTA-TEST_trace-db.json

https://github.com/NordicSemiconductor/pc-nrfconnect-cellularmonitor/blob/main/resources/traceDB/mfw_nrf9160_1.3.5_trace-db.json

These should also be present on the system if nRF Connect Cellular Monitor is installed. I got them from GitHub because I looked through this repo before and I knew where to look for these files.

I moved these files into this folder:

Windows: C:\Users\<your_user>\.nrfutil\share\nrfutil-trace\auto-detect-trace-db-config

Ubuntu: /home/<your_user>/.nrfutil/share/nrfutil-trace/auto-detect-trace-db-config

In the folder mentioned above the file config.json already exists.

Because of this I performed the following two actions:

I renamed config.json to config_old.json.
I renamed config_v2.json to config.json.

Now nRF Util trace works as intended with modem firmware 1.3.5.

I hope that this solution can help someone who is in a similar situation and that the trace db for modem firmware 1.3.5 can be included in a future release of nRF Util trace.

RE: nRF Util on Ubuntu 20: unable to capture modem trace

io22m007 — Sun, 13 Aug 2023 01:46:04 GMT

Hi Håkon,

sorry for the late reply!

I noticed that I added the wrong error message to my original post.

I meant to add the following message:

Error: Tracing failed

Caused by:
    unable to locate db directory  plugin path: /home/florian/.nrfutil/lib/nrfutil-trace/plugins/nrfml-insight-source.nrfml (error code 100)

But instead, I added the following message which was from an attempt where I installed and executed nRF Util trace with sudo:

Error: Tracing failed

Caused by:
    unable to locate db directory  plugin path: /root/.nrfutil/lib/nrfutil-trace/plugins/nrfml-insight-source.nrfml (error code 100)

I have updated the original post in order to reflect the correct error message. Apologies for the confusion.

I've implemented your suggestion with the following command:
export NRFUTIL_HOME=/home/florian/.nrfutil

But this results in the same error message:

Error: Tracing failed

Caused by:
    unable to locate db directory  plugin path: /home/florian/.nrfutil/lib/nrfutil-trace/plugins/nrfml-insight-source.nrfml (error code 100)

The file exists at the location where nRF Util trace expects it to be:

florian@ubuntu:~$ ls -la /home/florian/.nrfutil/lib/nrfutil-trace/plugins/
total 20760
drwxrwxr-x 2 florian florian    4096 Aug 12 18:20 .
drwxrwxr-x 3 florian florian    4096 Aug 10 14:51 ..
-rw-r--r-- 1 florian florian 1677000 Aug 10 14:51 nrfml-ascii-file-sink.nrfml
-rw-r--r-- 1 florian florian 8259488 Aug 10 14:51 nrfml-insight-source.nrfml
-rw-r--r-- 1 florian florian 1641960 Aug 10 14:51 nrfml-pcap-sink.nrfml
-rw-r--r-- 1 florian florian 1540032 Aug 10 14:51 nrfml-raw-file-sink.nrfml
-rw-r--r-- 1 florian florian   16160 Aug 10 14:51 nrfml-test-broken-sink.nrfml
-rw-r--r-- 1 florian florian   16128 Aug 10 14:51 nrfml-test-broken-source.nrfml
-rw-r--r-- 1 florian florian 1375376 Aug 10 14:51 nrfml-test-sink.nrfml
-rw-r--r-- 1 florian florian 1375864 Aug 10 14:51 nrfml-test-source.nrfml
-rw-r--r-- 1 florian florian 3695888 Aug 10 14:51 nrfml-tshark-sink.nrfml
-rw-r--r-- 1 florian florian 1641992 Aug 10 14:51 nrfml-wireshark-named-pipe-sink.nrfml
florian@ubuntu:~$

I'm sorry for the confusion I've cause.

I hope that with this out of the way that a solution can be found.

Thanks in advance!

regards,

Florian

RE: nRF Util on Ubuntu 20: unable to capture modem trace

helsing — Fri, 11 Aug 2023 14:33:04 GMT

Are you running nrfutil as root? If nrfutil is running as root it is trying to find the plugin in $HOME(root)/.nrfutil/(...).

Could you please specify where nrfutil is installed, with the NRFUTIL_HOME environment variable? If it is home/fabian/.nrfutil, then it would be export NRFUTIL_HOME=/home/fabian/.nrfutil

RE: nRF Util on Ubuntu 20: unable to capture modem trace

helsing — Fri, 11 Aug 2023 13:44:31 GMT

Hi Florian,

Just letting you know we are looking into this.

Regards,

Håkon