drivers/gpu/drm/display/drm_hdmi_audio_helper.c
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/display/drm_hdmi_audio_helper.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/display/drm_hdmi_audio_helper.c- Extension
.c- Size
- 5442 bytes
- Lines
- 196
- Domain
- Driver Families
- Bucket
- drivers/gpu
- 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.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/export.hlinux/mutex.hlinux/of_graph.hlinux/platform_device.hdrm/drm_connector.hdrm/drm_device.hdrm/display/drm_hdmi_audio_helper.hsound/hdmi-codec.h
Detected Declarations
function Copyrightfunction drm_connector_hdmi_audio_preparefunction drm_connector_hdmi_audio_shutdownfunction drm_connector_hdmi_audio_mute_streamfunction drm_connector_hdmi_audio_get_dai_idfunction drm_connector_hdmi_audio_get_eldfunction drm_connector_hdmi_audio_hook_plugged_cbfunction drm_connector_hdmi_audio_plugged_notifyfunction drm_connector_hdmi_audio_initexport drm_connector_hdmi_audio_plugged_notifyexport drm_connector_hdmi_audio_init
Annotated Snippet
// SPDX-License-Identifier: MIT
/*
* Copyright (c) 2024 Linaro Ltd
*/
#include <linux/export.h>
#include <linux/mutex.h>
#include <linux/of_graph.h>
#include <linux/platform_device.h>
#include <drm/drm_connector.h>
#include <drm/drm_device.h>
#include <drm/display/drm_hdmi_audio_helper.h>
#include <sound/hdmi-codec.h>
static int drm_connector_hdmi_audio_startup(struct device *dev, void *data)
{
struct drm_connector *connector = data;
const struct drm_connector_hdmi_audio_funcs *funcs =
connector->hdmi_audio.funcs;
if (funcs->startup)
return funcs->startup(connector);
return 0;
}
static int drm_connector_hdmi_audio_prepare(struct device *dev, void *data,
struct hdmi_codec_daifmt *fmt,
struct hdmi_codec_params *hparms)
{
struct drm_connector *connector = data;
const struct drm_connector_hdmi_audio_funcs *funcs =
connector->hdmi_audio.funcs;
return funcs->prepare(connector, fmt, hparms);
}
static void drm_connector_hdmi_audio_shutdown(struct device *dev, void *data)
{
struct drm_connector *connector = data;
const struct drm_connector_hdmi_audio_funcs *funcs =
connector->hdmi_audio.funcs;
return funcs->shutdown(connector);
}
static int drm_connector_hdmi_audio_mute_stream(struct device *dev, void *data,
bool enable, int direction)
{
struct drm_connector *connector = data;
const struct drm_connector_hdmi_audio_funcs *funcs =
connector->hdmi_audio.funcs;
if (funcs->mute_stream)
return funcs->mute_stream(connector, enable, direction);
return -ENOTSUPP;
}
static int drm_connector_hdmi_audio_get_dai_id(struct snd_soc_component *comment,
struct device_node *endpoint,
void *data)
{
struct drm_connector *connector = data;
struct of_endpoint of_ep;
int ret;
if (connector->hdmi_audio.dai_port < 0)
return -ENOTSUPP;
ret = of_graph_parse_endpoint(endpoint, &of_ep);
if (ret < 0)
return ret;
if (of_ep.port == connector->hdmi_audio.dai_port)
return 0;
return -EINVAL;
}
static int drm_connector_hdmi_audio_get_eld(struct device *dev, void *data,
uint8_t *buf, size_t len)
{
struct drm_connector *connector = data;
mutex_lock(&connector->eld_mutex);
memcpy(buf, connector->eld, min(sizeof(connector->eld), len));
mutex_unlock(&connector->eld_mutex);
Annotation
- Immediate include surface: `linux/export.h`, `linux/mutex.h`, `linux/of_graph.h`, `linux/platform_device.h`, `drm/drm_connector.h`, `drm/drm_device.h`, `drm/display/drm_hdmi_audio_helper.h`, `sound/hdmi-codec.h`.
- Detected declarations: `function Copyright`, `function drm_connector_hdmi_audio_prepare`, `function drm_connector_hdmi_audio_shutdown`, `function drm_connector_hdmi_audio_mute_stream`, `function drm_connector_hdmi_audio_get_dai_id`, `function drm_connector_hdmi_audio_get_eld`, `function drm_connector_hdmi_audio_hook_plugged_cb`, `function drm_connector_hdmi_audio_plugged_notify`, `function drm_connector_hdmi_audio_init`, `export drm_connector_hdmi_audio_plugged_notify`.
- Atlas domain: Driver Families / drivers/gpu.
- Implementation status: integration implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.