sound/soc/sdw_utils/soc_sdw_es9356.c
Source file repositories/reference/linux-study-clean/sound/soc/sdw_utils/soc_sdw_es9356.c
File Facts
- System
- Linux kernel
- Corpus path
sound/soc/sdw_utils/soc_sdw_es9356.c- Extension
.c- Size
- 6213 bytes
- Lines
- 231
- Domain
- Driver Families
- Bucket
- sound/soc
- Inferred role
- Driver Families: exported/initcall integration point
- Status
- integration implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/device.hlinux/errno.hlinux/input.hlinux/soundwire/sdw.hlinux/soundwire/sdw_type.hsound/control.hsound/soc.hsound/soc-acpi.hsound/soc-dapm.hsound/jack.hsound/soc_sdw_utils.h
Detected Declarations
function snd_soc_register_cardfunction asoc_sdw_es9356_spk_rtd_initfunction asoc_sdw_es9356_dmic_rtd_initfunction asoc_sdw_es9356_rtd_initfunction asoc_sdw_es9356_exitfunction asoc_sdw_es9356_initfunction asoc_sdw_es9356_amp_init
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-only
// Based on sof_sdw_rt5682.c
// This file incorporates work covered by the following copyright notice:
// Copyright (c) 2023 Intel Corporation
// Copyright (c) 2024 Advanced Micro Devices, Inc.
// Copyright (c) 2025 Everest Semiconductor Co., Ltd
/*
* soc_sdw_es9356 - Helpers to handle ES9356 from generic machine driver
*/
#include <linux/device.h>
#include <linux/errno.h>
#include <linux/input.h>
#include <linux/soundwire/sdw.h>
#include <linux/soundwire/sdw_type.h>
#include <sound/control.h>
#include <sound/soc.h>
#include <sound/soc-acpi.h>
#include <sound/soc-dapm.h>
#include <sound/jack.h>
#include <sound/soc_sdw_utils.h>
/*
* Note this MUST be called before snd_soc_register_card(), so that the props
* are in place before the codec component driver's probe function parses them.
*/
static int es9356_add_codec_device_props(struct device *sdw_dev, unsigned long quirk)
{
struct property_entry props[SOC_SDW_MAX_NO_PROPS] = {};
struct fwnode_handle *fwnode;
int ret;
if (!SOC_SDW_JACK_JDSRC(quirk))
return 0;
props[0] = PROPERTY_ENTRY_U32("everest,jd-src", SOC_SDW_JACK_JDSRC(quirk));
fwnode = fwnode_create_software_node(props, NULL);
if (IS_ERR(fwnode))
return PTR_ERR(fwnode);
ret = device_add_software_node(sdw_dev, to_software_node(fwnode));
fwnode_handle_put(fwnode);
return ret;
}
static const struct snd_soc_dapm_route es9356_map[] = {
/* Headphones */
{ "Headphone", NULL, "es9356 HP" },
{ "es9356 MIC1", NULL, "Headset Mic" },
};
static const struct snd_soc_dapm_route es9356_spk_map[] = {
/* Speaker */
{ "Speaker", NULL, "es9356 SPK" },
};
static const struct snd_soc_dapm_route es9356_dmic_map[] = {
/* DMIC */
{ "es9356 PDM_DIN", NULL, "DMIC" },
};
static struct snd_soc_jack_pin es9356_jack_pins[] = {
{
.pin = "Headphone",
.mask = SND_JACK_HEADPHONE,
},
{
.pin = "Headset Mic",
.mask = SND_JACK_MICROPHONE,
},
};
int asoc_sdw_es9356_spk_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai)
{
struct snd_soc_card *card = rtd->card;
struct snd_soc_dapm_context *dapm = snd_soc_card_to_dapm(card);
int ret;
card->components = devm_kasprintf(card->dev, GFP_KERNEL,
"%s spk:es9356-spk",
card->components);
if (!card->components)
return -ENOMEM;
ret = snd_soc_dapm_add_routes(dapm, es9356_spk_map,
ARRAY_SIZE(es9356_spk_map));
if (ret)
Annotation
- Immediate include surface: `linux/device.h`, `linux/errno.h`, `linux/input.h`, `linux/soundwire/sdw.h`, `linux/soundwire/sdw_type.h`, `sound/control.h`, `sound/soc.h`, `sound/soc-acpi.h`.
- Detected declarations: `function snd_soc_register_card`, `function asoc_sdw_es9356_spk_rtd_init`, `function asoc_sdw_es9356_dmic_rtd_init`, `function asoc_sdw_es9356_rtd_init`, `function asoc_sdw_es9356_exit`, `function asoc_sdw_es9356_init`, `function asoc_sdw_es9356_amp_init`.
- Atlas domain: Driver Families / sound/soc.
- Implementation status: integration implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.