decoders/edid/pd.py

   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
  28 import sigrokdecode as srd
  29 from common.srdhelper import SrdIntEnum
  30 import os
  31
  32 St = SrdIntEnum.from_str('St', 'OFFSET EXTENSIONS HEADER EDID')
  33
  34 EDID_HEADER = [0x00, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x00]
  35 OFF_VENDOR = 8
  36 OFF_VERSION = 18
  37 OFF_BASIC = 20
  38 OFF_CHROM = 25
  39 OFF_EST_TIMING = 35
  40 OFF_STD_TIMING = 38
  41 OFF_DET_TIMING = 54
  42 OFF_NUM_EXT = 126
  43 OFF_CHECKSUM = 127
  44
  45 # Pre-EDID established timing modes
  46 est_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
  67 xy_ratio = [
  68     (16, 10),
  69     (4, 3),
  70     (5, 4),
  71     (16, 9),
  72 ]
  73
  74 # Annotation classes
  75 ANN_FIELDS = 0
  76 ANN_SECTIONS = 1
  77
  78 class 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