2 * Generic routines and proc interface for ELD(EDID Like Data) information
4 * Copyright(c) 2008 Intel Corporation.
7 * Wu Fengguang <wfg@linux.intel.com>
9 * This driver is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This driver is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include <linux/init.h>
25 #include <linux/slab.h>
26 #include <sound/core.h>
27 #include <asm/unaligned.h>
28 #include "hda_codec.h"
29 #include "hda_local.h"
36 enum cea_edid_versions {
37 CEA_EDID_VER_NONE = 0,
38 CEA_EDID_VER_CEA861 = 1,
39 CEA_EDID_VER_CEA861A = 2,
40 CEA_EDID_VER_CEA861BCD = 3,
41 CEA_EDID_VER_RESERVED = 4,
44 static char *cea_speaker_allocation_names[] = {
58 static char *eld_connection_type_names[4] = {
65 enum cea_audio_coding_types {
66 AUDIO_CODING_TYPE_REF_STREAM_HEADER = 0,
67 AUDIO_CODING_TYPE_LPCM = 1,
68 AUDIO_CODING_TYPE_AC3 = 2,
69 AUDIO_CODING_TYPE_MPEG1 = 3,
70 AUDIO_CODING_TYPE_MP3 = 4,
71 AUDIO_CODING_TYPE_MPEG2 = 5,
72 AUDIO_CODING_TYPE_AACLC = 6,
73 AUDIO_CODING_TYPE_DTS = 7,
74 AUDIO_CODING_TYPE_ATRAC = 8,
75 AUDIO_CODING_TYPE_SACD = 9,
76 AUDIO_CODING_TYPE_EAC3 = 10,
77 AUDIO_CODING_TYPE_DTS_HD = 11,
78 AUDIO_CODING_TYPE_MLP = 12,
79 AUDIO_CODING_TYPE_DST = 13,
80 AUDIO_CODING_TYPE_WMAPRO = 14,
81 AUDIO_CODING_TYPE_REF_CXT = 15,
82 /* also include valid xtypes below */
83 AUDIO_CODING_TYPE_HE_AAC = 15,
84 AUDIO_CODING_TYPE_HE_AAC2 = 16,
85 AUDIO_CODING_TYPE_MPEG_SURROUND = 17,
88 enum cea_audio_coding_xtypes {
89 AUDIO_CODING_XTYPE_HE_REF_CT = 0,
90 AUDIO_CODING_XTYPE_HE_AAC = 1,
91 AUDIO_CODING_XTYPE_HE_AAC2 = 2,
92 AUDIO_CODING_XTYPE_MPEG_SURROUND = 3,
93 AUDIO_CODING_XTYPE_FIRST_RESERVED = 4,
96 static char *cea_audio_coding_type_names[] = {
106 /* 9 */ "DSD (One Bit Audio)",
107 /* 10 */ "E-AC-3/DD+ (Dolby Digital Plus)",
109 /* 12 */ "MLP (Dolby TrueHD)",
114 /* 17 */ "MPEG Surround",
118 * The following two lists are shared between
119 * - HDMI audio InfoFrame (source to sink)
120 * - CEA E-EDID Extension (sink to source)
124 * SS1:SS0 index => sample size
126 static int cea_sample_sizes[4] = {
127 0, /* 0: Refer to Stream Header */
128 AC_SUPPCM_BITS_16, /* 1: 16 bits */
129 AC_SUPPCM_BITS_20, /* 2: 20 bits */
130 AC_SUPPCM_BITS_24, /* 3: 24 bits */
134 * SF2:SF1:SF0 index => sampling frequency
136 static int cea_sampling_frequencies[8] = {
137 0, /* 0: Refer to Stream Header */
138 SNDRV_PCM_RATE_32000, /* 1: 32000Hz */
139 SNDRV_PCM_RATE_44100, /* 2: 44100Hz */
140 SNDRV_PCM_RATE_48000, /* 3: 48000Hz */
141 SNDRV_PCM_RATE_88200, /* 4: 88200Hz */
142 SNDRV_PCM_RATE_96000, /* 5: 96000Hz */
143 SNDRV_PCM_RATE_176400, /* 6: 176400Hz */
144 SNDRV_PCM_RATE_192000, /* 7: 192000Hz */
147 static unsigned int hdmi_get_eld_data(struct hda_codec *codec, hda_nid_t nid,
152 val = snd_hda_codec_read(codec, nid, 0,
153 AC_VERB_GET_HDMI_ELDD, byte_index);
155 printk(KERN_INFO "HDMI: ELD data byte %d: 0x%x\n", byte_index, val);
160 #define GRAB_BITS(buf, byte, lowbit, bits) \
162 BUILD_BUG_ON(lowbit > 7); \
163 BUILD_BUG_ON(bits > 8); \
164 BUILD_BUG_ON(bits <= 0); \
166 (buf[byte] >> (lowbit)) & ((1 << (bits)) - 1); \
169 static void hdmi_update_short_audio_desc(struct cea_sad *a,
170 const unsigned char *buf)
175 val = GRAB_BITS(buf, 1, 0, 7);
177 for (i = 0; i < 7; i++)
179 a->rates |= cea_sampling_frequencies[i + 1];
181 a->channels = GRAB_BITS(buf, 0, 0, 3);
187 a->format = GRAB_BITS(buf, 0, 3, 4);
189 case AUDIO_CODING_TYPE_REF_STREAM_HEADER:
191 "HDMI: audio coding type 0 not expected\n");
194 case AUDIO_CODING_TYPE_LPCM:
195 val = GRAB_BITS(buf, 2, 0, 3);
196 for (i = 0; i < 3; i++)
198 a->sample_bits |= cea_sample_sizes[i + 1];
201 case AUDIO_CODING_TYPE_AC3:
202 case AUDIO_CODING_TYPE_MPEG1:
203 case AUDIO_CODING_TYPE_MP3:
204 case AUDIO_CODING_TYPE_MPEG2:
205 case AUDIO_CODING_TYPE_AACLC:
206 case AUDIO_CODING_TYPE_DTS:
207 case AUDIO_CODING_TYPE_ATRAC:
208 a->max_bitrate = GRAB_BITS(buf, 2, 0, 8);
209 a->max_bitrate *= 8000;
212 case AUDIO_CODING_TYPE_SACD:
215 case AUDIO_CODING_TYPE_EAC3:
218 case AUDIO_CODING_TYPE_DTS_HD:
221 case AUDIO_CODING_TYPE_MLP:
224 case AUDIO_CODING_TYPE_DST:
227 case AUDIO_CODING_TYPE_WMAPRO:
228 a->profile = GRAB_BITS(buf, 2, 0, 3);
231 case AUDIO_CODING_TYPE_REF_CXT:
232 a->format = GRAB_BITS(buf, 2, 3, 5);
233 if (a->format == AUDIO_CODING_XTYPE_HE_REF_CT ||
234 a->format >= AUDIO_CODING_XTYPE_FIRST_RESERVED) {
236 "HDMI: audio coding xtype %d not expected\n",
240 a->format += AUDIO_CODING_TYPE_HE_AAC -
241 AUDIO_CODING_XTYPE_HE_AAC;
247 * Be careful, ELD buf could be totally rubbish!
249 int snd_hdmi_parse_eld(struct parsed_hdmi_eld *e,
250 const unsigned char *buf, int size)
255 e->eld_ver = GRAB_BITS(buf, 0, 3, 5);
256 if (e->eld_ver != ELD_VER_CEA_861D &&
257 e->eld_ver != ELD_VER_PARTIAL) {
258 snd_printd(KERN_INFO "HDMI: Unknown ELD version %d\n",
263 e->baseline_len = GRAB_BITS(buf, 2, 0, 8);
264 mnl = GRAB_BITS(buf, 4, 0, 5);
265 e->cea_edid_ver = GRAB_BITS(buf, 4, 5, 3);
267 e->support_hdcp = GRAB_BITS(buf, 5, 0, 1);
268 e->support_ai = GRAB_BITS(buf, 5, 1, 1);
269 e->conn_type = GRAB_BITS(buf, 5, 2, 2);
270 e->sad_count = GRAB_BITS(buf, 5, 4, 4);
272 e->aud_synch_delay = GRAB_BITS(buf, 6, 0, 8) * 2;
273 e->spk_alloc = GRAB_BITS(buf, 7, 0, 7);
275 e->port_id = get_unaligned_le64(buf + 8);
277 /* not specified, but the spec's tendency is little endian */
278 e->manufacture_id = get_unaligned_le16(buf + 16);
279 e->product_id = get_unaligned_le16(buf + 18);
281 if (mnl > ELD_MAX_MNL) {
282 snd_printd(KERN_INFO "HDMI: MNL is reserved value %d\n", mnl);
284 } else if (ELD_FIXED_BYTES + mnl > size) {
285 snd_printd(KERN_INFO "HDMI: out of range MNL %d\n", mnl);
288 strlcpy(e->monitor_name, buf + ELD_FIXED_BYTES, mnl + 1);
290 for (i = 0; i < e->sad_count; i++) {
291 if (ELD_FIXED_BYTES + mnl + 3 * (i + 1) > size) {
292 snd_printd(KERN_INFO "HDMI: out of range SAD %d\n", i);
295 hdmi_update_short_audio_desc(e->sad + i,
296 buf + ELD_FIXED_BYTES + mnl + 3 * i);
300 * HDMI sink's ELD info cannot always be retrieved for now, e.g.
301 * in console or for audio devices. Assume the highest speakers
302 * configuration, to _not_ prohibit multi-channel audio playback.
305 e->spk_alloc = 0xffff;
313 int snd_hdmi_get_eld_size(struct hda_codec *codec, hda_nid_t nid)
315 return snd_hda_codec_read(codec, nid, 0, AC_VERB_GET_HDMI_DIP_SIZE,
319 int snd_hdmi_get_eld(struct hda_codec *codec, hda_nid_t nid,
320 unsigned char *buf, int *eld_size)
327 * ELD size is initialized to zero in caller function. If no errors and
328 * ELD is valid, actual eld_size is assigned.
331 size = snd_hdmi_get_eld_size(codec, nid);
333 /* wfg: workaround for ASUS P5E-VM HDMI board */
334 snd_printd(KERN_INFO "HDMI: ELD buf size is 0, force 128\n");
337 if (size < ELD_FIXED_BYTES || size > ELD_MAX_SIZE) {
338 snd_printd(KERN_INFO "HDMI: invalid ELD buf size %d\n", size);
343 for (i = 0; i < size; i++) {
344 unsigned int val = hdmi_get_eld_data(codec, nid, i);
346 * Graphics driver might be writing to ELD buffer right now.
347 * Just abort. The caller will repoll after a while.
349 if (!(val & AC_ELDD_ELD_VALID)) {
351 "HDMI: invalid ELD data byte %d\n", i);
355 val &= AC_ELDD_ELD_DATA;
357 * The first byte cannot be zero. This can happen on some DVI
358 * connections. Some Intel chips may also need some 250ms delay
359 * to return non-zero ELD data, even when the graphics driver
360 * correctly writes ELD content before setting ELD_valid bit.
363 snd_printdd(KERN_INFO "HDMI: 0 ELD data\n");
376 * SNDRV_PCM_RATE_* and AC_PAR_PCM values don't match, print correct rates with
377 * hdmi-specific routine.
379 static void hdmi_print_pcm_rates(int pcm, char *buf, int buflen)
381 static unsigned int alsa_rates[] = {
382 5512, 8000, 11025, 16000, 22050, 32000, 44100, 48000, 64000,
383 88200, 96000, 176400, 192000, 384000
387 for (i = 0, j = 0; i < ARRAY_SIZE(alsa_rates); i++)
389 j += snprintf(buf + j, buflen - j, " %d",
392 buf[j] = '\0'; /* necessary when j == 0 */
395 #define SND_PRINT_RATES_ADVISED_BUFSIZE 80
397 static void hdmi_show_short_audio_desc(struct cea_sad *a)
399 char buf[SND_PRINT_RATES_ADVISED_BUFSIZE];
400 char buf2[8 + SND_PRINT_BITS_ADVISED_BUFSIZE] = ", bits =";
405 hdmi_print_pcm_rates(a->rates, buf, sizeof(buf));
407 if (a->format == AUDIO_CODING_TYPE_LPCM)
408 snd_print_pcm_bits(a->sample_bits, buf2 + 8, sizeof(buf2) - 8);
409 else if (a->max_bitrate)
410 snprintf(buf2, sizeof(buf2),
411 ", max bitrate = %d", a->max_bitrate);
415 _snd_printd(SND_PR_VERBOSE, "HDMI: supports coding type %s:"
416 " channels = %d, rates =%s%s\n",
417 cea_audio_coding_type_names[a->format],
423 void snd_print_channel_allocation(int spk_alloc, char *buf, int buflen)
427 for (i = 0, j = 0; i < ARRAY_SIZE(cea_speaker_allocation_names); i++) {
428 if (spk_alloc & (1 << i))
429 j += snprintf(buf + j, buflen - j, " %s",
430 cea_speaker_allocation_names[i]);
432 buf[j] = '\0'; /* necessary when j == 0 */
435 void snd_hdmi_show_eld(struct parsed_hdmi_eld *e)
439 _snd_printd(SND_PR_VERBOSE, "HDMI: detected monitor %s at connection type %s\n",
441 eld_connection_type_names[e->conn_type]);
444 char buf[SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE];
445 snd_print_channel_allocation(e->spk_alloc, buf, sizeof(buf));
446 _snd_printd(SND_PR_VERBOSE, "HDMI: available speakers:%s\n", buf);
449 for (i = 0; i < e->sad_count; i++)
450 hdmi_show_short_audio_desc(e->sad + i);
453 #ifdef CONFIG_PROC_FS
455 static void hdmi_print_sad_info(int i, struct cea_sad *a,
456 struct snd_info_buffer *buffer)
458 char buf[SND_PRINT_RATES_ADVISED_BUFSIZE];
460 snd_iprintf(buffer, "sad%d_coding_type\t[0x%x] %s\n",
461 i, a->format, cea_audio_coding_type_names[a->format]);
462 snd_iprintf(buffer, "sad%d_channels\t\t%d\n", i, a->channels);
464 hdmi_print_pcm_rates(a->rates, buf, sizeof(buf));
465 snd_iprintf(buffer, "sad%d_rates\t\t[0x%x]%s\n", i, a->rates, buf);
467 if (a->format == AUDIO_CODING_TYPE_LPCM) {
468 snd_print_pcm_bits(a->sample_bits, buf, sizeof(buf));
469 snd_iprintf(buffer, "sad%d_bits\t\t[0x%x]%s\n",
470 i, a->sample_bits, buf);
474 snd_iprintf(buffer, "sad%d_max_bitrate\t%d\n",
478 snd_iprintf(buffer, "sad%d_profile\t\t%d\n", i, a->profile);
481 static void hdmi_print_eld_info(struct snd_info_entry *entry,
482 struct snd_info_buffer *buffer)
484 struct hdmi_eld *eld = entry->private_data;
485 struct parsed_hdmi_eld *e = &eld->info;
486 char buf[SND_PRINT_CHANNEL_ALLOCATION_ADVISED_BUFSIZE];
488 static char *eld_version_names[32] = {
492 [3 ... 30] = "reserved",
495 static char *cea_edid_version_names[8] = {
496 "no CEA EDID Timing Extension block present",
500 [4 ... 7] = "reserved"
503 mutex_lock(&eld->lock);
504 snd_iprintf(buffer, "monitor_present\t\t%d\n", eld->monitor_present);
505 snd_iprintf(buffer, "eld_valid\t\t%d\n", eld->eld_valid);
506 if (!eld->eld_valid) {
507 mutex_unlock(&eld->lock);
510 snd_iprintf(buffer, "monitor_name\t\t%s\n", e->monitor_name);
511 snd_iprintf(buffer, "connection_type\t\t%s\n",
512 eld_connection_type_names[e->conn_type]);
513 snd_iprintf(buffer, "eld_version\t\t[0x%x] %s\n", e->eld_ver,
514 eld_version_names[e->eld_ver]);
515 snd_iprintf(buffer, "edid_version\t\t[0x%x] %s\n", e->cea_edid_ver,
516 cea_edid_version_names[e->cea_edid_ver]);
517 snd_iprintf(buffer, "manufacture_id\t\t0x%x\n", e->manufacture_id);
518 snd_iprintf(buffer, "product_id\t\t0x%x\n", e->product_id);
519 snd_iprintf(buffer, "port_id\t\t\t0x%llx\n", (long long)e->port_id);
520 snd_iprintf(buffer, "support_hdcp\t\t%d\n", e->support_hdcp);
521 snd_iprintf(buffer, "support_ai\t\t%d\n", e->support_ai);
522 snd_iprintf(buffer, "audio_sync_delay\t%d\n", e->aud_synch_delay);
524 snd_print_channel_allocation(e->spk_alloc, buf, sizeof(buf));
525 snd_iprintf(buffer, "speakers\t\t[0x%x]%s\n", e->spk_alloc, buf);
527 snd_iprintf(buffer, "sad_count\t\t%d\n", e->sad_count);
529 for (i = 0; i < e->sad_count; i++)
530 hdmi_print_sad_info(i, e->sad + i, buffer);
531 mutex_unlock(&eld->lock);
534 static void hdmi_write_eld_info(struct snd_info_entry *entry,
535 struct snd_info_buffer *buffer)
537 struct hdmi_eld *eld = entry->private_data;
538 struct parsed_hdmi_eld *e = &eld->info;
545 mutex_lock(&eld->lock);
546 while (!snd_info_get_line(buffer, line, sizeof(line))) {
547 if (sscanf(line, "%s %llx", name, &val) != 2)
550 * We don't allow modification to these fields:
551 * monitor_name manufacture_id product_id
552 * eld_version edid_version
554 if (!strcmp(name, "monitor_present"))
555 eld->monitor_present = val;
556 else if (!strcmp(name, "eld_valid"))
557 eld->eld_valid = val;
558 else if (!strcmp(name, "connection_type"))
560 else if (!strcmp(name, "port_id"))
562 else if (!strcmp(name, "support_hdcp"))
563 e->support_hdcp = val;
564 else if (!strcmp(name, "support_ai"))
566 else if (!strcmp(name, "audio_sync_delay"))
567 e->aud_synch_delay = val;
568 else if (!strcmp(name, "speakers"))
570 else if (!strcmp(name, "sad_count"))
572 else if (!strncmp(name, "sad", 3)) {
575 if (name[4] >= '0' && name[4] <= '9') {
577 n = 10 * n + name[4] - '0';
579 if (n >= ELD_MAX_SAD)
581 if (!strcmp(sname, "_coding_type"))
582 e->sad[n].format = val;
583 else if (!strcmp(sname, "_channels"))
584 e->sad[n].channels = val;
585 else if (!strcmp(sname, "_rates"))
586 e->sad[n].rates = val;
587 else if (!strcmp(sname, "_bits"))
588 e->sad[n].sample_bits = val;
589 else if (!strcmp(sname, "_max_bitrate"))
590 e->sad[n].max_bitrate = val;
591 else if (!strcmp(sname, "_profile"))
592 e->sad[n].profile = val;
593 if (n >= e->sad_count)
594 e->sad_count = n + 1;
597 mutex_unlock(&eld->lock);
601 int snd_hda_eld_proc_new(struct hda_codec *codec, struct hdmi_eld *eld,
605 struct snd_info_entry *entry;
608 snprintf(name, sizeof(name), "eld#%d.%d", codec->addr, index);
609 err = snd_card_proc_new(codec->bus->card, name, &entry);
613 snd_info_set_text_ops(entry, eld, hdmi_print_eld_info);
614 entry->c.text.write = hdmi_write_eld_info;
615 entry->mode |= S_IWUSR;
616 eld->proc_entry = entry;
621 void snd_hda_eld_proc_free(struct hda_codec *codec, struct hdmi_eld *eld)
623 if (!codec->bus->shutdown && eld->proc_entry) {
624 snd_device_free(codec->bus->card, eld->proc_entry);
625 eld->proc_entry = NULL;
629 #endif /* CONFIG_PROC_FS */
631 /* update PCM info based on ELD */
632 void snd_hdmi_eld_update_pcm_info(struct parsed_hdmi_eld *e,
633 struct hda_pcm_stream *hinfo)
638 unsigned int channels_max;
641 /* assume basic audio support (the basic audio flag is not in ELD;
642 * however, all audio capable sinks are required to support basic
644 rates = SNDRV_PCM_RATE_32000 | SNDRV_PCM_RATE_44100 |
645 SNDRV_PCM_RATE_48000;
646 formats = SNDRV_PCM_FMTBIT_S16_LE;
649 for (i = 0; i < e->sad_count; i++) {
650 struct cea_sad *a = &e->sad[i];
652 if (a->channels > channels_max)
653 channels_max = a->channels;
654 if (a->format == AUDIO_CODING_TYPE_LPCM) {
655 if (a->sample_bits & AC_SUPPCM_BITS_20) {
656 formats |= SNDRV_PCM_FMTBIT_S32_LE;
660 if (a->sample_bits & AC_SUPPCM_BITS_24) {
661 formats |= SNDRV_PCM_FMTBIT_S32_LE;
668 /* restrict the parameters by the values the codec provides */
669 hinfo->rates &= rates;
670 hinfo->formats &= formats;
671 hinfo->maxbps = min(hinfo->maxbps, maxbps);
672 hinfo->channels_max = min(hinfo->channels_max, channels_max);