SPDIFRX Linux driver

This message will disappear after all relevant tasks have been resolved.

Semantic MediaWiki

There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.

1. Article purpose[edit source]

This article introduces the SPDIFRX Linux^® driver for the SPDIFRX internal peripheral.

2. Short Description[edit source]

The SPDIFRX^[1] Linux driver is an ASoC CPU DAI driver implemented in the Linux ALSA framework.

3. Configuration[edit source]

3.1. Kernel Configuration[edit source]

Activate the SPDIFRX^[1] Linux driver in the kernel configuration using the Linux Menuconfig tool: Menuconfig or how to configure kernel

[*] Device Drivers
    [*] Sound card support
        [*] Advanced Linux Sound Architecture
            [*] ALSA for SoC audio support
                STMicroelectronics STM32 SOC audio support
	             [*] STM32 S/PDIF receiver (SPDIFRX) support

3.2. Device tree[edit source]

Refer to the SPDIFRX device tree configuration article when configuring the SPDIFRX Linux kernel driver.

4. How to use[edit source]

The SPDIFRX driver is accessed from userland through an ALSA device. Refer to ALSA overview to see how to list and use ALSA devices.

The SPDFIRX driver exposes an alsa control, which allows to retrieve the IEC958 status bits from the input audio stream.

Warning

The configuration of the SPDIFRX input pin in the device tree, may put some restrictions on the use of IEC958 control. Thus, in some configuration, the control can be used only when an audio stream is captured. Refer to the SPDIFRX device tree configuration article, to find details about SPDIFRX configuration.

5. How to debug[edit source]

The debugfs and procfs file systems can be checked to get information about the SPDFIRX driver and the resources it uses. A none exhaustive list of these file system entries is provided below. Refer to ALSA overview to get more details about debugging tools.

debugfs entries:

asoc: refer to ALSA_overview#How_to_monitor
clk: refer to Clock_overview#How_to_monitor_with_debugfs to get information on clocks.
pinctrl: refer to Pinctrl_overview#How_to_monitor to get information on pins.
regmap: allow to monitor SPDIFRX peripheral registers.

$ cat /sys/kernel/debug/regmap/xxx.audio-controller/registers

procfs entries:

asound: refer to ALSA_overview#How_to_debug
interrupts: allow to check interrupts.

$ cat /proc/interrupts

6. Source code location[edit source]

sound/soc/stm/stm32_spdifrx.c : implements the SPDIFRX driver.

7. References[edit source]

↑ ^1.0 ^1.1 SPDIFRX internal peripheral

{{PublicationRequestId | 9234 | 2018-10-22 | BrunoB}

[SPDIFRX_internal_peripheral-1] 1.0 ^1.1 SPDIFRX internal peripheral

[1]