sound/soc/soc-card-test.c
Source file repositories/reference/linux-study-clean/sound/soc/soc-card-test.c
File Facts
- System
- Linux kernel
- Corpus path
sound/soc/soc-card-test.c- Extension
.c- Size
- 3511 bytes
- Lines
- 130
- Domain
- Driver Families
- Bucket
- sound/soc
- Inferred role
- Driver Families: implementation source
- Status
- source 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.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
kunit/device.hkunit/test.hlinux/module.hsound/control.hsound/soc.hsound/soc-card.h
Detected Declarations
struct soc_card_test_privfunction test_snd_soc_card_get_kcontrolfunction soc_card_test_case_initfunction soc_card_test_case_exit
Annotated Snippet
struct soc_card_test_priv {
struct device *card_dev;
struct snd_soc_card *card;
};
static const struct snd_kcontrol_new test_card_controls[] = {
SOC_SINGLE("Fee", SND_SOC_NOPM, 0, 1, 0),
SOC_SINGLE("Fi", SND_SOC_NOPM, 1, 1, 0),
SOC_SINGLE("Fo", SND_SOC_NOPM, 2, 1, 0),
SOC_SINGLE("Fum", SND_SOC_NOPM, 3, 1, 0),
SOC_SINGLE("Left Fee", SND_SOC_NOPM, 4, 1, 0),
SOC_SINGLE("Right Fee", SND_SOC_NOPM, 5, 1, 0),
SOC_SINGLE("Left Fi", SND_SOC_NOPM, 6, 1, 0),
SOC_SINGLE("Right Fi", SND_SOC_NOPM, 7, 1, 0),
SOC_SINGLE("Left Fo", SND_SOC_NOPM, 8, 1, 0),
SOC_SINGLE("Right Fo", SND_SOC_NOPM, 9, 1, 0),
SOC_SINGLE("Left Fum", SND_SOC_NOPM, 10, 1, 0),
SOC_SINGLE("Right Fum", SND_SOC_NOPM, 11, 1, 0),
};
static void test_snd_soc_card_get_kcontrol(struct kunit *test)
{
struct soc_card_test_priv *priv = test->priv;
struct snd_soc_card *card = priv->card;
struct snd_kcontrol *kc;
struct soc_mixer_control *mc;
int i, ret;
ret = snd_soc_add_card_controls(card, test_card_controls, ARRAY_SIZE(test_card_controls));
KUNIT_ASSERT_EQ(test, ret, 0);
/* Look up every control */
for (i = 0; i < ARRAY_SIZE(test_card_controls); ++i) {
kc = snd_soc_card_get_kcontrol(card, test_card_controls[i].name);
KUNIT_EXPECT_NOT_ERR_OR_NULL_MSG(test, kc, "Failed to find '%s'\n",
test_card_controls[i].name);
if (!kc)
continue;
/* Test that it is the correct control */
mc = (struct soc_mixer_control *)kc->private_value;
KUNIT_EXPECT_EQ_MSG(test, mc->shift, i, "For '%s'\n", test_card_controls[i].name);
}
/* Test some names that should not be found */
kc = snd_soc_card_get_kcontrol(card, "None");
KUNIT_EXPECT_NULL(test, kc);
kc = snd_soc_card_get_kcontrol(card, "Left None");
KUNIT_EXPECT_NULL(test, kc);
kc = snd_soc_card_get_kcontrol(card, "Left");
KUNIT_EXPECT_NULL(test, kc);
kc = snd_soc_card_get_kcontrol(card, NULL);
KUNIT_EXPECT_NULL(test, kc);
}
static int soc_card_test_case_init(struct kunit *test)
{
struct soc_card_test_priv *priv;
int ret;
priv = kunit_kzalloc(test, sizeof(*priv), GFP_KERNEL);
if (!priv)
return -ENOMEM;
test->priv = priv;
priv->card = kunit_kzalloc(test, sizeof(*priv->card), GFP_KERNEL);
if (!priv->card)
return -ENOMEM;
priv->card_dev = kunit_device_register(test, "sound-soc-card-test");
priv->card_dev = get_device(priv->card_dev);
if (!priv->card_dev)
return -ENODEV;
priv->card->name = "soc-card-test";
priv->card->dev = priv->card_dev;
priv->card->owner = THIS_MODULE;
ret = snd_soc_register_card(priv->card);
if (ret) {
put_device(priv->card_dev);
return ret;
}
return 0;
}
Annotation
- Immediate include surface: `kunit/device.h`, `kunit/test.h`, `linux/module.h`, `sound/control.h`, `sound/soc.h`, `sound/soc-card.h`.
- Detected declarations: `struct soc_card_test_priv`, `function test_snd_soc_card_get_kcontrol`, `function soc_card_test_case_init`, `function soc_card_test_case_exit`.
- Atlas domain: Driver Families / sound/soc.
- Implementation status: source 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.