include/sound/hdmi-codec.h

   1 /*
   2  * hdmi-codec.h - HDMI Codec driver API
   3  *
   4  * Copyright (C) 2014 Texas Instruments Incorporated - http://www.ti.com
   5  *
   6  * Author: Jyri Sarha <[email protected]>
   7  *
   8  * This program is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License
  10  * version 2 as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License for more details.
  16  */
  17
  18 #ifndef __HDMI_CODEC_H__
  19 #define __HDMI_CODEC_H__
  20
  21 #include <linux/of_graph.h>
  22 #include <linux/hdmi.h>
  23 #include <drm/drm_edid.h>
  24 #include <sound/asoundef.h>
  25 #include <sound/soc.h>
  26 #include <uapi/sound/asound.h>
  27
  28 /*
  29  * Protocol between ASoC cpu-dai and HDMI-encoder
  30  */
  31 struct hdmi_codec_daifmt {
  32         enum {
  33                 HDMI_I2S,
  34                 HDMI_RIGHT_J,
  35                 HDMI_LEFT_J,
  36                 HDMI_DSP_A,
  37                 HDMI_DSP_B,
  38                 HDMI_AC97,
  39                 HDMI_SPDIF,
  40         } fmt;
  41         unsigned int bit_clk_inv:1;
  42         unsigned int frame_clk_inv:1;
  43         unsigned int bit_clk_master:1;
  44         unsigned int frame_clk_master:1;
  45 };
  46
  47 /*
  48  * HDMI audio parameters
  49  */
  50 struct hdmi_codec_params {
  51         struct hdmi_audio_infoframe cea;
  52         struct snd_aes_iec958 iec;
  53         int sample_rate;
  54         int sample_width;
  55         int channels;
  56 };
  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 (*digital_mute)(struct device *dev, void *data, bool enable);
  85
  86         /*
  87          * Provides EDID-Like-Data from connected HDMI device.
  88          * Optional
  89          */
  90         int (*get_eld)(struct device *dev, void *data,
  91                        uint8_t *buf, size_t len);
  92
  93         /*
  94          * Getting DAI ID
  95          * Optional
  96          */
  97         int (*get_dai_id)(struct snd_soc_component *comment,
  98                           struct device_node *endpoint);
  99 };
 100
 101 /* HDMI codec initalization data */
 102 struct hdmi_codec_pdata {
 103         const struct hdmi_codec_ops *ops;
 104         uint i2s:1;
 105         uint spdif:1;
 106         int max_i2s_channels;
 107         void *data;
 108 };
 109
 110 #define HDMI_CODEC_DRV_NAME "hdmi-audio-codec"
 111
 112 #endif /* __HDMI_CODEC_H__ */