Skip to content

docs: developer_guides: update logging documentation, add mtrace, deprecate sof-logger - #538

Open
kv2019i wants to merge 4 commits into
thesofproject:masterfrom
kv2019i:202609-logging-update
Open

kv2019i wants to merge 4 commits into
thesofproject:masterfrom
kv2019i:202609-logging-update

Conversation

@kv2019i

@kv2019i kv2019i commented Sep 28, 2026

Copy link
Copy Markdown
Contributor

SOF's logging relies on Zephyr logging subsystem and the backend details (mtrace is just one), dictionary (multiple solutions) will depend on build options, platforms and are typically well documented in Zephyr (or platform specific documentation).

Modify the SOF docs to be more generic, refer to Zephyr and add brief examples on how to use mtrace-reader.py as that is the primary logging solution for all modern Intel ADSPs.

Replace references to the sof-logger and smex tools with documentation
for mtrace-reader.py. Highlight that SOF uses the Zephyr logging
subsystem and that any Zephyr backend can be used to transport logs;
mtrace-reader.py is the Intel ADSP-specific backend, while other
hardware platforms use their own logging mechanisms.

Document how to acquire mtrace-reader.py from the SOF main repository
(tools/mtrace/mtrace-reader.py), how to run it locally and on a remote
DUT over SSH, and how to enable the mtrace backend via the snd_sof
kernel module parameter sof_debug=SOF_DBG_ENABLE_TRACE (0x1).

Signed-off-by: Kai Vehmanen <kai.vehmanen@linux.intel.com>
Remove references to sof-logger and smex from the DSP telemetry
architecture diagram. These are only used in older SOF releases.

Update the subtitle and section titles to reflect the Zephyr logging
subsystem and mtrace backend, which are the most common tools used with
new SOF releases. Replace the smex card with a generic build-time
metadata extraction description, and replace the sof-logger decoder card
with mtrace-reader.py for Intel ADSP, including the sof_debug=1 modprobe
enable step.

Signed-off-by: Kai Vehmanen <kai.vehmanen@linux.intel.com>
Replace the build-time Log Dictionary Catalog (.ldc) description with
a reference to the Zephyr logging dictionary (log_dictionary.json).

Clarify that the dictionary is optional and is not required for basic
log streaming with mtrace-reader.py. Point to the Zephyr documentation
for details on dictionary-based logging.

Update the architecture SVG accordingly.

Signed-off-by: Kai Vehmanen <kai.vehmanen@linux.intel.com>
Update sof_bin_releases.json to match latest release.

Signed-off-by: Kai Vehmanen <kai.vehmanen@linux.intel.com>
"asset_url": "https://github.com/thesofproject/sof-bin/releases/download/v2024.06/sof-bin-2024.06.tar.gz",
"asset_size_mb": 9.4,
"prerelease": false
}

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lgirdwood not sure why the new automation removes v2024.06 , but this is result of running the build now, so committing whatever the script updates.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant