1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * hdmi-codec.h - HDMI Codec driver API 4 * 5 * Copyright (C) 2014 Texas Instruments Incorporated - https://www.ti.com 6 * 7 * Author: Jyri Sarha <jsarha@ti.com> 8 */ 9 10 #ifndef __HDMI_CODEC_H__ 11 #define __HDMI_CODEC_H__ 12 13 #include <linux/of_graph.h> 14 #include <linux/hdmi.h> 15 #include <drm/drm_edid.h> 16 #include <sound/asoundef.h> 17 #include <sound/soc.h> 18 #include <uapi/sound/asound.h> 19 20 /* 21 * Protocol between ASoC cpu-dai and HDMI-encoder 22 */ 23 struct hdmi_codec_daifmt { 24 enum { 25 HDMI_I2S, 26 HDMI_RIGHT_J, 27 HDMI_LEFT_J, 28 HDMI_DSP_A, 29 HDMI_DSP_B, 30 HDMI_AC97, 31 HDMI_SPDIF, 32 } fmt; 33 unsigned int bit_clk_inv:1; 34 unsigned int frame_clk_inv:1; 35 unsigned int bit_clk_master:1; 36 unsigned int frame_clk_master:1; 37 /* bit_fmt could be standard PCM format or 38 * IEC958 encoded format. ALSA IEC958 plugin will pass 39 * IEC958_SUBFRAME format to the underneath driver. 40 */ 41 snd_pcm_format_t bit_fmt; 42 }; 43 44 /* 45 * HDMI audio parameters 46 */ 47 struct hdmi_codec_params { 48 struct hdmi_audio_infoframe cea; 49 struct snd_aes_iec958 iec; 50 int sample_rate; 51 int sample_width; 52 int channels; 53 }; 54 55 typedef void (*hdmi_codec_plugged_cb)(struct device *dev, 56 bool plugged); 57 58 struct hdmi_codec_pdata; 59 struct hdmi_codec_ops { 60 /* 61 * Called when ASoC starts an audio stream setup. 62 * Optional 63 */ 64 int (*audio_startup)(struct device *dev, void *data); 65 66 /* 67 * Configures HDMI-encoder for audio stream. 68 * Mandatory 69 */ 70 int (*hw_params)(struct device *dev, void *data, 71 struct hdmi_codec_daifmt *fmt, 72 struct hdmi_codec_params *hparms); 73 74 /* 75 * Shuts down the audio stream. 76 * Mandatory 77 */ 78 void (*audio_shutdown)(struct device *dev, void *data); 79 80 /* 81 * Mute/unmute HDMI audio stream. 82 * Optional 83 */ 84 int (*mute_stream)(struct device *dev, void *data, 85 bool enable, int direction); 86 87 /* 88 * Provides EDID-Like-Data from connected HDMI device. 89 * Optional 90 */ 91 int (*get_eld)(struct device *dev, void *data, 92 uint8_t *buf, size_t len); 93 94 /* 95 * Getting DAI ID 96 * Optional 97 */ 98 int (*get_dai_id)(struct snd_soc_component *comment, 99 struct device_node *endpoint); 100 101 /* 102 * Hook callback function to handle connector plug event. 103 * Optional 104 */ 105 int (*hook_plugged_cb)(struct device *dev, void *data, 106 hdmi_codec_plugged_cb fn, 107 struct device *codec_dev); 108 109 /* bit field */ 110 unsigned int no_capture_mute:1; 111 }; 112 113 /* HDMI codec initalization data */ 114 struct hdmi_codec_pdata { 115 const struct hdmi_codec_ops *ops; 116 uint i2s:1; 117 uint spdif:1; 118 int max_i2s_channels; 119 void *data; 120 }; 121 122 struct snd_soc_component; 123 struct snd_soc_jack; 124 125 #define HDMI_CODEC_DRV_NAME "hdmi-audio-codec" 126 127 #endif /* __HDMI_CODEC_H__ */ 128