decoders/xfp/__init__.py

   1 ##
   2 ## This file is part of the libsigrokdecode project.
   3 ##
   4 ## Copyright (C) 2013 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 2 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, write to the Free Software
  18 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  19 ##
  20
  21 '''
  22 XFP I2C management interface structure decoder.
  23
  24 XFP modules include an I2C interface, used to monitor and control various
  25 aspects of the module. The specification defines an I2C slave at address
  26 0x50 (0xa0) which returns 128 bytes of a standard structure ("lower memory"),
  27 and, after setting a table number in lower memory, a set of 256 "higher
  28 memory" tables, which can be mapped to different subdevices on the XFP.
  29
  30 Only one table is defined in the specification: table 0x01, the default on
  31 module startup. Other table are either reserved for future expansion, or
  32 available for vendor-specific extensions. This decoder supports both lower
  33 memory and table 0x01.
  34
  35 The XFP specification is available here:
  36
  37   ftp://ftp.seagate.com/sff/INF-8077.PDF
  38 '''
  39
  40 from .pd import *
  41