]> sigrok.org Git - libsigrokdecode.git/blame_incremental - decoders/edid/pd.py
projects / libsigrokdecode.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
edid: Use SrdIntEnum for the state machine.
[libsigrokdecode.git] / decoders / edid / pd.py
... / ...
CommitLineData
1##
2## This file is part of the libsigrokdecode project.
3##
4## Copyright (C) 2012 Bert Vermeulen <bert@biot.com>
5##
6## This program is free software; you can redistribute it and/or modify
7## it under the terms of the GNU General Public License as published by
8## the Free Software Foundation; either version 3 of the License, or
9## (at your option) any later version.
10##
11## This program is distributed in the hope that it will be useful,
12## but WITHOUT ANY WARRANTY; without even the implied warranty of
13## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14## GNU General Public License for more details.
15##
16## You should have received a copy of the GNU General Public License
17## along with this program; if not, see <http://www.gnu.org/licenses/>.
18##
19
20# TODO:
21# - EDID < 1.3
22# - add short annotations
23# - Signal level standard field in basic display parameters block
24# - Additional color point descriptors
25# - Additional standard timing descriptors
26# - Extensions
27
28import sigrokdecode as srd
29from common.srdhelper import SrdIntEnum
30import os
31
32St = SrdIntEnum.from_str('St', 'OFFSET EXTENSIONS HEADER EDID')
33
34EDID_HEADER = [0x00, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x00]
35OFF_VENDOR = 8
36OFF_VERSION = 18
37OFF_BASIC = 20
38OFF_CHROM = 25
39OFF_EST_TIMING = 35
40OFF_STD_TIMING = 38
41OFF_DET_TIMING = 54
42OFF_NUM_EXT = 126
43OFF_CHECKSUM = 127
44
45# Pre-EDID established timing modes
46est_modes = [
47 '720x400@70Hz',
48 '720x400@88Hz',
49 '640x480@60Hz',
50 '640x480@67Hz',
51 '640x480@72Hz',
52 '640x480@75Hz',
53 '800x600@56Hz',
54 '800x600@60Hz',
55 '800x600@72Hz',
56 '800x600@75Hz',
57 '832x624@75Hz',
58 '1024x768@87Hz(i)',
59 '1024x768@60Hz',
60 '1024x768@70Hz',
61 '1024x768@75Hz',
62 '1280x1024@75Hz',
63 '1152x870@75Hz',
64]
65
66# X:Y display aspect ratios, as used in standard timing modes
67xy_ratio = [
68 (16, 10),
69 (4, 3),
70 (5, 4),
71 (16, 9),
72]
73
74# Annotation classes
75ANN_FIELDS = 0
76ANN_SECTIONS = 1
77
78class Decoder(srd.Decoder):
79 api_version = 3
80 id = 'edid'
81 name = 'EDID'
82 longname = 'Extended Display Identification Data'
83 desc = 'Data structure describing display device capabilities.'
84 license = 'gplv3+'
85 inputs = ['i2c']
86 outputs = []
87 tags = ['Display', 'Memory', 'PC']
88 annotations = (
89 ('field', 'Field'),
90 ('section', 'Section'),
91 )
92 annotation_rows = (
93 ('fields', 'Fields', (0,)),
94 ('sections', 'Sections', (1,)),
95 )
96
97 def __init__(self):
98 self.reset()
99
100 def reset(self):
101 self.state = None
102 # Received data items, used as an index into samplenum/data
103 self.cnt = 0
104 # Start/end sample numbers per data item
105 self.sn = []
106 # Received data
107 self.cache = []
108 # Random read offset
109 self.offset = 0
110 # Extensions
111 self.extension = 0
112 self.ext_sn = [[]]
113 self.ext_cache = [[]]
114
115 def start(self):
116 self.out_ann = self.register(srd.OUTPUT_ANN)
117
118 def decode(self, ss, es, data):
119 cmd, data = data
120
121 if cmd == 'ADDRESS WRITE' and data == 0x50:
122 self.state = St.OFFSET
123 self.ss = ss
124 return
125
126 if cmd == 'ADDRESS READ' and data == 0x50:
127 if self.extension > 0:
128 self.state = St.EXTENSIONS
129 s = str(self.extension)
130 t = ["Extension: " + s, "X: " + s, s]
131 else:
132 self.state = St.HEADER
133 t = ["EDID"]
134 self.put(ss, es, self.out_ann, [ANN_SECTIONS, t])
135 return
136
137 if cmd == 'DATA WRITE' and self.state == St.OFFSET:
138 self.offset = data
139 self.extension = self.offset // 128
140 self.cnt = self.offset % 128
141 if self.extension > 0:
142 ext = self.extension - 1
143 l = len(self.ext_sn[ext])
144 # Truncate or extend to self.cnt.
145 self.sn = self.ext_sn[ext][0:self.cnt] + [0] * max(0, self.cnt - l)
146 self.cache = self.ext_cache[ext][0:self.cnt] + [0] * max(0, self.cnt - l)
147 else:
148 l = len(self.sn)
149 self.sn = self.sn[0:self.cnt] + [0] * max(0, self.cnt - l)
150 self.cache = self.cache[0:self.cnt] + [0] * max(0, self.cnt - l)
151 ss = self.ss if self.ss else ss
152 s = str(data)
153 t = ["Offset: " + s, "O: " + s, s]
154 self.put(ss, es, self.out_ann, [ANN_SECTIONS, t])
155 return
156
157 # We only care about actual data bytes that are read (for now).
158 if cmd != 'DATA READ':
159 return
160
161 self.cnt += 1
162 if self.extension > 0:
163 self.ext_sn[self.extension - 1].append([ss, es])
164 self.ext_cache[self.extension - 1].append(data)
165 else:
166 self.sn.append([ss, es])
167 self.cache.append(data)
168
169 if self.state is None or self.state == St.HEADER:
170 # Wait for the EDID header
171 if self.cnt >= OFF_VENDOR:
172 if self.cache[-8:] == EDID_HEADER:
173 # Throw away any garbage before the header
174 self.sn = self.sn[-8:]
175 self.cache = self.cache[-8:]
176 self.cnt = 8
177 self.state = St.EDID
178 self.put(self.sn[0][0], es, self.out_ann,
179 [ANN_SECTIONS, ['Header']])
180 self.put(self.sn[0][0], es, self.out_ann,
181 [ANN_FIELDS, ['Header pattern']])
182 elif self.state == St.EDID:
183 if self.cnt == OFF_VERSION:
184 self.decode_vid(-10)
185 self.decode_pid(-8)
186 self.decode_serial(-6)
187 self.decode_mfrdate(-2)
188 self.put(self.sn[OFF_VENDOR][0], es, self.out_ann,
189 [ANN_SECTIONS, ['Vendor/product']])
190 elif self.cnt == OFF_BASIC:
191 self.put(self.sn[OFF_VERSION][0], es, self.out_ann,
192 [ANN_SECTIONS, ['EDID Version']])
193 self.put(self.sn[OFF_VERSION][0], self.sn[OFF_VERSION][1],
194 self.out_ann, [ANN_FIELDS,
195 ['Version %d' % self.cache[-2]]])
196 self.put(self.sn[OFF_VERSION+1][0], self.sn[OFF_VERSION+1][1],
197 self.out_ann, [ANN_FIELDS,
198 ['Revision %d' % self.cache[-1]]])
199 elif self.cnt == OFF_CHROM:
200 self.put(self.sn[OFF_BASIC][0], es, self.out_ann,
201 [ANN_SECTIONS, ['Basic display']])
202 self.decode_basicdisplay(-5)
203 elif self.cnt == OFF_EST_TIMING:
204 self.put(self.sn[OFF_CHROM][0], es, self.out_ann,
205 [ANN_SECTIONS, ['Color characteristics']])
206 self.decode_chromaticity(-10)
207 elif self.cnt == OFF_STD_TIMING:
208 self.put(self.sn[OFF_EST_TIMING][0], es, self.out_ann,
209 [ANN_SECTIONS, ['Established timings']])
210 self.decode_est_timing(-3)
211 elif self.cnt == OFF_DET_TIMING:
212 self.put(self.sn[OFF_STD_TIMING][0], es, self.out_ann,
213 [ANN_SECTIONS, ['Standard timings']])
214 self.decode_std_timing(self.cnt - 16)
215 elif self.cnt == OFF_NUM_EXT:
216 self.decode_descriptors(-72)
217 elif self.cnt == OFF_CHECKSUM:
218 self.put(ss, es, self.out_ann,
219 [0, ['Extensions present: %d' % self.cache[self.cnt-1]]])
220 elif self.cnt == OFF_CHECKSUM+1:
221 checksum = 0
222 for i in range(128):
223 checksum += self.cache[i]
224 if checksum % 256 == 0:
225 csstr = 'OK'
226 else:
227 csstr = 'WRONG!'
228 self.put(ss, es, self.out_ann, [0, ['Checksum: %d (%s)' % (
229 self.cache[self.cnt-1], csstr)]])
230 self.state = St.EXTENSIONS
231
232 elif self.state == St.EXTENSIONS:
233 cache = self.ext_cache[self.extension - 1]
234 sn = self.ext_sn[self.extension - 1]
235 v = cache[self.cnt - 1]
236 if self.cnt == 1:
237 if v == 2:
238 self.put(ss, es, self.out_ann, [1, ['Extensions Tag', 'Tag']])
239 else:
240 self.put(ss, es, self.out_ann, [1, ['Bad Tag']])
241 elif self.cnt == 2:
242 self.put(ss, es, self.out_ann, [1, ['Version']])
243 self.put(ss, es, self.out_ann, [0, [str(v)]])
244 elif self.cnt == 3:
245 self.put(ss, es, self.out_ann, [1, ['DTD offset']])
246 self.put(ss, es, self.out_ann, [0, [str(v)]])
247 elif self.cnt == 4:
248 self.put(ss, es, self.out_ann, [1, ['Format support | DTD count']])
249 support = "Underscan: {0}, {1} Audio, YCbCr: {2}".format(
250 "yes" if v & 0x80 else "no",
251 "Basic" if v & 0x40 else "No",
252 ["None", "422", "444", "422+444"][(v & 0x30) >> 4])
253 self.put(ss, es, self.out_ann, [0, ['{0}, DTDs: {1}'.format(support, v & 0xf)]])
254 elif self.cnt <= cache[2]:
255 if self.cnt == cache[2]:
256 self.put(sn[4][0], es, self.out_ann, [1, ['Data block collection']])
257 self.decode_data_block_collection(cache[4:], sn[4:])
258 elif (self.cnt - cache[2]) % 18 == 0:
259 n = (self.cnt - cache[2]) / 18
260 if n <= cache[3] & 0xf:
261 self.put(sn[self.cnt - 18][0], es, self.out_ann, [1, ['DTD']])
262 self.decode_descriptors(-18)
263
264 elif self.cnt == 127:
265 dtd_last = cache[2] + (cache[3] & 0xf) * 18
266 self.put(sn[dtd_last][0], es, self.out_ann, [1, ['Padding']])
267 elif self.cnt == 128:
268 checksum = sum(cache) % 256
269 self.put(ss, es, self.out_ann, [0, ['Checksum: %d (%s)' % (
270 cache[self.cnt-1], 'Wrong' if checksum else 'OK')]])
271
272 def ann_field(self, start, end, annotation):
273 annotation = annotation if isinstance(annotation, list) else [annotation]
274 sn = self.ext_sn[self.extension - 1] if self.extension else self.sn
275 self.put(sn[start][0], sn[end][1],
276 self.out_ann, [ANN_FIELDS, annotation])
277
278 def lookup_pnpid(self, pnpid):
279 pnpid_file = os.path.join(os.path.dirname(__file__), 'pnpids.txt')
280 if os.path.exists(pnpid_file):
281 for line in open(pnpid_file).readlines():
282 if line.find(pnpid + ';') == 0:
283 return line[4:].strip()
284 return ''
285
286 def decode_vid(self, offset):
287 pnpid = chr(64 + ((self.cache[offset] & 0x7c) >> 2))
288 pnpid += chr(64 + (((self.cache[offset] & 0x03) << 3)
289 | ((self.cache[offset+1] & 0xe0) >> 5)))
290 pnpid += chr(64 + (self.cache[offset+1] & 0x1f))
291 vendor = self.lookup_pnpid(pnpid)
292 if vendor:
293 pnpid += ' (%s)' % vendor
294 self.ann_field(offset, offset+1, pnpid)
295
296 def decode_pid(self, offset):
297 pidstr = 'Product 0x%.2x%.2x' % (self.cache[offset+1], self.cache[offset])
298 self.ann_field(offset, offset+1, pidstr)
299
300 def decode_serial(self, offset):
301 serialnum = (self.cache[offset+3] << 24) \
302 + (self.cache[offset+2] << 16) \
303 + (self.cache[offset+1] << 8) \
304 + self.cache[offset]
305 serialstr = ''
306 is_alnum = True
307 for i in range(4):
308 if not chr(self.cache[offset+3-i]).isalnum():
309 is_alnum = False
310 break
311 serialstr += chr(self.cache[offset+3-i])
312 serial = serialstr if is_alnum else str(serialnum)
313 self.ann_field(offset, offset+3, 'Serial ' + serial)
314
315 def decode_mfrdate(self, offset):
316 datestr = ''
317 if self.cache[offset]:
318 datestr += 'week %d, ' % self.cache[offset]
319 datestr += str(1990 + self.cache[offset+1])
320 if datestr:
321 self.ann_field(offset, offset+1, ['Manufactured ' + datestr, datestr])
322
323 def decode_basicdisplay(self, offset):
324 # Video input definition
325 vid = self.cache[offset]
326 if vid & 0x80:
327 # Digital
328 self.ann_field(offset, offset, 'Video input: VESA DFP 1.')
329 else:
330 # Analog
331 sls = (vid & 60) >> 5
332 self.ann_field(offset, offset, 'Signal level standard: %.2x' % sls)
333 if vid & 0x10:
334 self.ann_field(offset, offset, 'Blank-to-black setup expected')
335 syncs = ''
336 if vid & 0x08:
337 syncs += 'separate syncs, '
338 if vid & 0x04:
339 syncs += 'composite syncs, '
340 if vid & 0x02:
341 syncs += 'sync on green, '
342 if vid & 0x01:
343 syncs += 'Vsync serration required, '
344 if syncs:
345 self.ann_field(offset, offset, 'Supported syncs: %s' % syncs[:-2])
346 # Max horizontal/vertical image size
347 if self.cache[offset+1] != 0 and self.cache[offset+2] != 0:
348 # Projectors have this set to 0
349 sizestr = '%dx%dcm' % (self.cache[offset+1], self.cache[offset+2])
350 self.ann_field(offset+1, offset+2, 'Physical size: ' + sizestr)
351 # Display transfer characteristic (gamma)
352 if self.cache[offset+3] != 0xff:
353 gamma = (self.cache[offset+3] + 100) / 100
354 self.ann_field(offset+3, offset+3, 'Gamma: %1.2f' % gamma)
355 # Feature support
356 fs = self.cache[offset+4]
357 dpms = ''
358 if fs & 0x80:
359 dpms += 'standby, '
360 if fs & 0x40:
361 dpms += 'suspend, '
362 if fs & 0x20:
363 dpms += 'active off, '
364 if dpms:
365 self.ann_field(offset+4, offset+4, 'DPMS support: %s' % dpms[:-2])
366 dt = (fs & 0x18) >> 3
367 dtstr = ''
368 if dt == 0:
369 dtstr = 'Monochrome'
370 elif dt == 1:
371 dtstr = 'RGB color'
372 elif dt == 2:
373 dtstr = 'non-RGB multicolor'
374 if dtstr:
375 self.ann_field(offset+4, offset+4, 'Display type: %s' % dtstr)
376 if fs & 0x04:
377 self.ann_field(offset+4, offset+4, 'Color space: standard sRGB')
378 # Save this for when we decode the first detailed timing descriptor
379 self.have_preferred_timing = (fs & 0x02) == 0x02
380 if fs & 0x01:
381 gft = ''
382 else:
383 gft = 'not '
384 self.ann_field(offset+4, offset+4,
385 'Generalized timing formula: %ssupported' % gft)
386
387 def convert_color(self, value):
388 # Convert from 10-bit packet format to float
389 outval = 0.0
390 for i in range(10):
391 if value & 0x01:
392 outval += 2 ** -(10-i)
393 value >>= 1
394 return outval
395
396 def decode_chromaticity(self, offset):
397 redx = (self.cache[offset+2] << 2) + ((self.cache[offset] & 0xc0) >> 6)
398 redy = (self.cache[offset+3] << 2) + ((self.cache[offset] & 0x30) >> 4)
399 self.ann_field(offset, offset+9, 'Chromacity red: X %1.3f, Y %1.3f' % (
400 self.convert_color(redx), self.convert_color(redy)))
401
402 greenx = (self.cache[offset+4] << 2) + ((self.cache[offset] & 0x0c) >> 6)
403 greeny = (self.cache[offset+5] << 2) + ((self.cache[offset] & 0x03) >> 4)
404 self.ann_field(offset, offset+9, 'Chromacity green: X %1.3f, Y %1.3f' % (
405 self.convert_color(greenx), self.convert_color(greeny)))
406
407 bluex = (self.cache[offset+6] << 2) + ((self.cache[offset+1] & 0xc0) >> 6)
408 bluey = (self.cache[offset+7] << 2) + ((self.cache[offset+1] & 0x30) >> 4)
409 self.ann_field(offset, offset+9, 'Chromacity blue: X %1.3f, Y %1.3f' % (
410 self.convert_color(bluex), self.convert_color(bluey)))
411
412 whitex = (self.cache[offset+8] << 2) + ((self.cache[offset+1] & 0x0c) >> 6)
413 whitey = (self.cache[offset+9] << 2) + ((self.cache[offset+1] & 0x03) >> 4)
414 self.ann_field(offset, offset+9, 'Chromacity white: X %1.3f, Y %1.3f' % (
415 self.convert_color(whitex), self.convert_color(whitey)))
416
417 def decode_est_timing(self, offset):
418 # Pre-EDID modes
419 bitmap = (self.cache[offset] << 9) \
420 + (self.cache[offset+1] << 1) \
421 + ((self.cache[offset+2] & 0x80) >> 7)
422 modestr = ''
423 for i in range(17):
424 if bitmap & (1 << (16-i)):
425 modestr += est_modes[i] + ', '
426 if modestr:
427 self.ann_field(offset, offset+2,
428 'Supported established modes: %s' % modestr[:-2])
429
430 def decode_std_timing(self, offset):
431 modestr = ''
432 for i in range(0, 16, 2):
433 if self.cache[offset+i] == 0x01 and self.cache[offset+i+1] == 0x01:
434 # Unused field
435 continue
436 x = (self.cache[offset+i] + 31) * 8
437 ratio = (self.cache[offset+i+1] & 0xc0) >> 6
438 ratio_x, ratio_y = xy_ratio[ratio]
439 y = x / ratio_x * ratio_y
440 refresh = (self.cache[offset+i+1] & 0x3f) + 60
441 modestr += '%dx%d@%dHz, ' % (x, y, refresh)
442 if modestr:
443 self.ann_field(offset, offset + 15,
444 'Supported standard modes: %s' % modestr[:-2])
445
446 def decode_detailed_timing(self, cache, sn, offset, is_first):
447 if is_first and self.have_preferred_timing:
448 # Only on first detailed timing descriptor
449 section = 'Preferred'
450 else:
451 section = 'Detailed'
452 section += ' timing descriptor'
453
454 self.put(sn[0][0], sn[17][1],
455 self.out_ann, [ANN_SECTIONS, [section]])
456
457 pixclock = float((cache[1] << 8) + cache[0]) / 100
458 self.ann_field(offset, offset+1, 'Pixel clock: %.2f MHz' % pixclock)
459
460 horiz_active = ((cache[4] & 0xf0) << 4) + cache[2]
461 horiz_blank = ((cache[4] & 0x0f) << 8) + cache[3]
462 self.ann_field(offset+2, offset+4, 'Horizontal active: %d, blanking: %d' % (horiz_active, horiz_blank))
463
464 vert_active = ((cache[7] & 0xf0) << 4) + cache[5]
465 vert_blank = ((cache[7] & 0x0f) << 8) + cache[6]
466 self.ann_field(offset+5, offset+7, 'Vertical active: %d, blanking: %d' % (vert_active, vert_blank))
467
468 horiz_sync_off = ((cache[11] & 0xc0) << 2) + cache[8]
469 horiz_sync_pw = ((cache[11] & 0x30) << 4) + cache[9]
470 vert_sync_off = ((cache[11] & 0x0c) << 2) + ((cache[10] & 0xf0) >> 4)
471 vert_sync_pw = ((cache[11] & 0x03) << 4) + (cache[10] & 0x0f)
472
473 syncs = (horiz_sync_off, horiz_sync_pw, vert_sync_off, vert_sync_pw)
474 self.ann_field(offset+8, offset+11, [
475 'Horizontal sync offset: %d, pulse width: %d, Vertical sync offset: %d, pulse width: %d' % syncs,
476 'HSync off: %d, pw: %d, VSync off: %d, pw: %d' % syncs])
477
478 horiz_size = ((cache[14] & 0xf0) << 4) + cache[12]
479 vert_size = ((cache[14] & 0x0f) << 8) + cache[13]
480 self.ann_field(offset+12, offset+14, 'Physical size: %dx%dmm' % (horiz_size, vert_size))
481
482 horiz_border = cache[15]
483 self.ann_field(offset+15, offset+15, 'Horizontal border: %d pixels' % horiz_border)
484 vert_border = cache[16]
485 self.ann_field(offset+16, offset+16, 'Vertical border: %d lines' % vert_border)
486
487 features = 'Flags: '
488 if cache[17] & 0x80:
489 features += 'interlaced, '
490 stereo = (cache[17] & 0x60) >> 5
491 if stereo:
492 if cache[17] & 0x01:
493 features += '2-way interleaved stereo ('
494 features += ['right image on even lines',
495 'left image on even lines',
496 'side-by-side'][stereo-1]
497 features += '), '
498 else:
499 features += 'field sequential stereo ('
500 features += ['right image on sync=1', 'left image on sync=1',
501 '4-way interleaved'][stereo-1]
502 features += '), '
503 sync = (cache[17] & 0x18) >> 3
504 sync2 = (cache[17] & 0x06) >> 1
505 posneg = ['negative', 'positive']
506 features += 'sync type '
507 if sync == 0x00:
508 features += 'analog composite (serrate on RGB)'
509 elif sync == 0x01:
510 features += 'bipolar analog composite (serrate on RGB)'
511 elif sync == 0x02:
512 features += 'digital composite (serrate on composite polarity ' \
513 + (posneg[sync2 & 0x01]) + ')'
514 elif sync == 0x03:
515 features += 'digital separate ('
516 features += 'Vsync polarity ' + (posneg[(sync2 & 0x02) >> 1])
517 features += ', Hsync polarity ' + (posneg[sync2 & 0x01])
518 features += ')'
519 features += ', '
520 self.ann_field(offset+17, offset+17, features[:-2])
521
522 def decode_descriptor(self, cache, offset):
523 tag = cache[3]
524 self.ann_field(offset, offset+1, "Flag")
525 self.ann_field(offset+2, offset+2, "Flag (reserved)")
526 self.ann_field(offset+3, offset+3, "Tag: {0:X}".format(tag))
527 self.ann_field(offset+4, offset+4, "Flag")
528
529 sn = self.ext_sn[self.extension - 1] if self.extension else self.sn
530
531 if tag == 0xff:
532 # Monitor serial number
533 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
534 [ANN_SECTIONS, ['Serial number']])
535 text = bytes(cache[5:][:13]).decode(encoding='cp437', errors='replace')
536 self.ann_field(offset+5, offset+17, text.strip())
537 elif tag == 0xfe:
538 # Text
539 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
540 [ANN_SECTIONS, ['Text']])
541 text = bytes(cache[5:][:13]).decode(encoding='cp437', errors='replace')
542 self.ann_field(offset+5, offset+17, text.strip())
543 elif tag == 0xfc:
544 # Monitor name
545 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
546 [ANN_SECTIONS, ['Monitor name']])
547 text = bytes(cache[5:][:13]).decode(encoding='cp437', errors='replace')
548 self.ann_field(offset+5, offset+17, text.strip())
549 elif tag == 0xfd:
550 # Monitor range limits
551 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
552 [ANN_SECTIONS, ['Monitor range limits']])
553 self.ann_field(offset+5, offset+5, [
554 'Minimum vertical rate: {0}Hz'.format(cache[5]),
555 'VSync >= {0}Hz'.format(cache[5])])
556 self.ann_field(offset+6, offset+6, [
557 'Maximum vertical rate: {0}Hz'.format(cache[6]),
558 'VSync <= {0}Hz'.format(cache[6])])
559 self.ann_field(offset+7, offset+7, [
560 'Minimum horizontal rate: {0}kHz'.format(cache[7]),
561 'HSync >= {0}kHz'.format(cache[7])])
562 self.ann_field(offset+8, offset+8, [
563 'Maximum horizontal rate: {0}kHz'.format(cache[8]),
564 'HSync <= {0}kHz'.format(cache[8])])
565 self.ann_field(offset+9, offset+9, [
566 'Maximum pixel clock: {0}MHz'.format(cache[9] * 10),
567 'PixClk <= {0}MHz'.format(cache[9] * 10)])
568 if cache[10] == 0x02:
569 self.ann_field(offset+10, offset+10, ['Secondary timing formula supported', '2nd GTF: yes'])
570 self.ann_field(offset+11, offset+17, ['GTF'])
571 else:
572 self.ann_field(offset+10, offset+10, ['Secondary timing formula unsupported', '2nd GTF: no'])
573 self.ann_field(offset+11, offset+17, ['Padding'])
574 elif tag == 0xfb:
575 # Additional color point data
576 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
577 [ANN_SECTIONS, ['Additional color point data']])
578 elif tag == 0xfa:
579 # Additional standard timing definitions
580 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
581 [ANN_SECTIONS, ['Additional standard timing definitions']])
582 else:
583 self.put(sn[offset][0], sn[offset+17][1], self.out_ann,
584 [ANN_SECTIONS, ['Unknown descriptor']])
585
586 def decode_descriptors(self, offset):
587 # 4 consecutive 18-byte descriptor blocks
588 cache = self.ext_cache[self.extension - 1] if self.extension else self.cache
589 sn = self.ext_sn[self.extension - 1] if self.extension else self.sn
590
591 for i in range(offset, 0, 18):
592 if cache[i] != 0 or cache[i+1] != 0:
593 self.decode_detailed_timing(cache[i:], sn[i:], i, i == offset)
594 else:
595 if cache[i+2] == 0 or cache[i+4] == 0:
596 self.decode_descriptor(cache[i:], i)
597
598 def decode_data_block(self, tag, cache, sn):
599 codes = { 0: ['0: Reserved'],
600 1: ['1: Audio Data Block', 'Audio'],
601 2: ['2: Video Data Block', 'Video'],
602 3: ['3: Vendor Specific Data Block', 'VSDB'],
603 4: ['4: Speacker Allocation Data Block', 'SADB'],
604 5: ['5: VESA DTC Data Block', 'DTC'],
605 6: ['6: Reserved'],
606 7: ['7: Extended', 'Ext'] }
607 ext_codes = { 0: [ '0: Video Capability Data Block', 'VCDB'],
608 1: [ '1: Vendor Specific Video Data Block', 'VSVDB'],
609 17: ['17: Vendor Specific Audio Data Block', 'VSADB'], }
610 if tag < 7:
611 code = codes[tag]
612 ext_len = 0
613 if tag == 1:
614 aformats = { 1: '1 (LPCM)' }
615 rates = [ '192', '176', '96', '88', '48', '44', '32' ]
616
617 aformat = cache[1] >> 3
618 sup_rates = [ i for i in range(0, 8) if (1 << i) & cache[2] ]
619
620 data = "Format: {0} Channels: {1}".format(
621 aformats.get(aformat, aformat), (cache[1] & 0x7) + 1)
622 data += " Rates: " + " ".join(rates[6 - i] for i in sup_rates)
623 data += " Extra: [{0:02X}]".format(cache[3])
624
625 elif tag ==2:
626 data = "VIC: "
627 data += ", ".join("{0}{1}".format(v & 0x7f,
628 ['', ' (Native)'][v >> 7])
629 for v in cache[1:])
630
631 elif tag ==3:
632 ouis = { b'\x00\x0c\x03': 'HDMI Licensing, LLC' }
633 oui = bytes(cache[3:0:-1])
634 ouis = ouis.get(oui, None)
635 data = "OUI: " + " ".join('{0:02X}'.format(x) for x in oui)
636 data += " ({0})".format(ouis) if ouis else ""
637 data += ", PhyAddr: {0}.{1}.{2}.{3}".format(
638 cache[4] >> 4, cache[4] & 0xf, cache[5] >> 4, cache[5] & 0xf)
639 data += ", [" + " ".join('{0:02X}'.format(x) for x in cache[6:]) + "]"
640
641 elif tag ==4:
642 speakers = [ 'FL/FR', 'LFE', 'FC', 'RL/RR',
643 'RC', 'FLC/FRC', 'RLC/RRC', 'FLW/FRW',
644 'FLH/FRH', 'TC', 'FCH' ]
645 sup_speakers = cache[1] + (cache[2] << 8)
646 sup_speakers = [ i for i in range(0, 8) if (1 << i) & sup_speakers ]
647 data = "Speakers: " + " ".join(speakers[i] for i in sup_speakers)
648
649 else:
650 data = " ".join('{0:02X}'.format(x) for x in cache[1:])
651
652 else:
653 # Extended tags
654 ext_len = 1
655 ext_code = ext_codes.get(cache[1], ['Unknown', '?'])
656 code = zip(codes[7], [", ", ": "], ext_code)
657 code = [ "".join(x) for x in code ]
658 data = " ".join('{0:02X}'.format(x) for x in cache[2:])
659
660 self.put(sn[0][0], sn[0 + ext_len][1], self.out_ann,
661 [ANN_FIELDS, code])
662 self.put(sn[1 + ext_len][0], sn[len(cache) - 1][1], self.out_ann,
663 [ANN_FIELDS, [data]])
664
665 def decode_data_block_collection(self, cache, sn):
666 offset = 0
667 while offset < len(cache):
668 length = 1 + cache[offset] & 0x1f
669 tag = cache[offset] >> 5
670 self.decode_data_block(tag, cache[offset:offset + length], sn[offset:])
671 offset += length
Protocol decoder lib