]> sigrok.org Git - libsigrokdecode.git/commitdiff
srd: Move all protocol docs to __init__.py files.
authorUwe Hermann <redacted>
Wed, 1 Feb 2012 21:23:03 +0000 (22:23 +0100)
committerUwe Hermann <redacted>
Wed, 1 Feb 2012 22:18:25 +0000 (23:18 +0100)
24 files changed:
decoders/dcf77/__init__.py
decoders/dcf77/dcf77.py
decoders/ebr30a_i2c_demux/__init__.py
decoders/ebr30a_i2c_demux/ebr30a_i2c_demux.py
decoders/edid/edid.py
decoders/i2c/__init__.py
decoders/i2c/i2c.py
decoders/i2cdemux/__init__.py
decoders/i2cdemux/i2cdemux.py
decoders/i2cfilter/__init__.py
decoders/i2cfilter/i2cfilter.py
decoders/mlx90614/mlx90614.py
decoders/mx25lxx05d/__init__.py
decoders/mx25lxx05d/mx25lxx05d.py
decoders/nunchuk/__init__.py
decoders/nunchuk/nunchuk.py
decoders/pan1321/pan1321.py
decoders/rtc8564/rtc8564.py
decoders/spi/spi.py
decoders/transitioncounter/transitioncounter.py
decoders/uart/__init__.py
decoders/uart/uart.py
decoders/usb/__init__.py
decoders/usb/usb.py

index db7d2deee6dde5c75c00b71010d522c09dc068b6..bef505b926c6ab0e896600b7ec03f1f0cd692d02 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+TODO.
+
+Details:
+http://en.wikipedia.org/wiki/DCF77
+'''
+
 from .dcf77 import *
 
index 098c3b90b9d9951774b4db6a8aa827886a8932d3..ab600eddff400b60ae0fab78c6bb3d8a35de67f5 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # DCF77 protocol decoder
-#
-# More information:
-# http://en.wikipedia.org/wiki/DCF77
-#
-
-#
-# Protocol output format:
-# TODO
-#
 
 import sigrokdecode as srd
 import calendar
index dddc8b7a9424585f6017c3a38196d87118bf8186..a5df1437362f12a7b5d95aaaa6970e0337e06d9a 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+TrekStor EBR30-a I2C demux protocol decoder.
+
+Takes an I2C stream as input and outputs 3 different I2C streams, for the
+3 different I2C devices on the TrekStor EBR30-a eBook reader (which are all
+physically connected to the same SCL/SDA lines).
+
+I2C slave addresses:
+
+ - AXP199 battery management chip: 0x69/0x68 (8bit R/W), 0x34 (7bit)
+ - H8563S RTC chip: 0xa3/0xa2 (8bit R/W), 0x51 (7bit)
+ - Unknown accelerometer chip: 0x2b/0x2a (8bit R/W), 0x15 (7bit)
+'''
+
 from .ebr30a_i2c_demux import *
 
index 6abed09c116b004309a944d40bb7812667ab36ac..1a52fb8a0344586692cfabd5a0c49ee029ea8fd4 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # TrekStor EBR30-a I2C demux protocol decoder
-#
-# Takes an I2C stream as input and outputs 3 different I2C streams, for the
-# 3 different I2C devices on the TrekStor EBR30-a eBook reader (which are all
-# physically connected to the same SCL/SDA lines).
-#
-# I2C slave addresses:
-#
-#  - AXP199 battery management chip: 0x69/0x68 (8bit R/W), 0x34 (7bit)
-#  - H8563S RTC chip: 0xa3/0xa2 (8bit R/W), 0x51 (7bit)
-#  - Unknown accelerometer chip: 0x2b/0x2a (8bit R/W), 0x15 (7bit)
-#
 
 import sigrokdecode as srd
 
index 6d53bf1a609baac4d2d4b894d1e0ce99019bc37b..78ea4f6767adacf67de09d0226fe220f15ea671c 100644 (file)
@@ -17,6 +17,8 @@
 ## along with this program; if not, see <http://www.gnu.org/licenses/>.
 ##
 
+# EDID protocol decoder
+
 # TODO:
 #    - EDID < 1.3
 #    - add short annotations
index 9e7856e0884e47c5f3386b57ead4424870000afe..3c29aa1cddf723dbc4d7262e2f9379490298ec58 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+I2C protocol decoder.
+
+The Inter-Integrated Circuit (I2C) bus is a bidirectional, multi-master
+bus using two signals (SCL = serial clock line, SDA = serial data line).
+
+There can be many devices on the same bus. Each device can potentially be
+master or slave (and that can change during runtime). Both slave and master
+can potentially play the transmitter or receiver role (this can also
+change at runtime).
+
+Possible maximum data rates:
+ - Standard mode: 100 kbit/s
+ - Fast mode: 400 kbit/s
+ - Fast-mode Plus: 1 Mbit/s
+ - High-speed mode: 3.4 Mbit/s
+
+START condition (S): SDA = falling, SCL = high
+Repeated START condition (Sr): same as S
+Data bit sampling: SCL = rising
+STOP condition (P): SDA = rising, SCL = high
+
+All data bytes on SDA are exactly 8 bits long (transmitted MSB-first).
+Each byte has to be followed by a 9th ACK/NACK bit. If that bit is low,
+that indicates an ACK, if it's high that indicates a NACK.
+
+After the first START condition, a master sends the device address of the
+slave it wants to talk to. Slave addresses are 7 bits long (MSB-first).
+After those 7 bits, a data direction bit is sent. If the bit is low that
+indicates a WRITE operation, if it's high that indicates a READ operation.
+
+Later an optional 10bit slave addressing scheme was added.
+
+Documentation:
+http://www.nxp.com/acrobat/literature/9398/39340011.pdf (v2.1 spec)
+http://www.nxp.com/acrobat/usermanuals/UM10204_3.pdf (v3 spec)
+http://en.wikipedia.org/wiki/I2C
+
+Protocol output format:
+
+I2C packet:
+[<i2c_command>, <data>, <ack_bit>]
+
+<i2c_command> is one of:
+  - 'START' (START condition)
+  - 'START REPEAT' (Repeated START)
+  - 'ADDRESS READ' (Address, read)
+  - 'ADDRESS WRITE' (Address, write)
+  - 'DATA READ' (Data, read)
+  - 'DATA WRITE' (Data, write)
+  - 'STOP' (STOP condition)
+
+<data> is the data or address byte associated with the 'ADDRESS*' and 'DATA*'
+command. For 'START', 'START REPEAT' and 'STOP', this is None.
+
+<ack_bit> is either 'ACK' or 'NACK', but may also be None.
+'''
+
 from .i2c import *
 
index 527fa6e2e2fad6544876be5d018453864f2f3b85..b1c4a8acaf3080258cdbd186a5d5769cd641f2ee 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # I2C protocol decoder
-#
-
-#
-# The Inter-Integrated Circuit (I2C) bus is a bidirectional, multi-master
-# bus using two signals (SCL = serial clock line, SDA = serial data line).
-#
-# There can be many devices on the same bus. Each device can potentially be
-# master or slave (and that can change during runtime). Both slave and master
-# can potentially play the transmitter or receiver role (this can also
-# change at runtime).
-#
-# Possible maximum data rates:
-#  - Standard mode: 100 kbit/s
-#  - Fast mode: 400 kbit/s
-#  - Fast-mode Plus: 1 Mbit/s
-#  - High-speed mode: 3.4 Mbit/s
-#
-# START condition (S): SDA = falling, SCL = high
-# Repeated START condition (Sr): same as S
-# Data bit sampling: SCL = rising
-# STOP condition (P): SDA = rising, SCL = high
-#
-# All data bytes on SDA are exactly 8 bits long (transmitted MSB-first).
-# Each byte has to be followed by a 9th ACK/NACK bit. If that bit is low,
-# that indicates an ACK, if it's high that indicates a NACK.
-#
-# After the first START condition, a master sends the device address of the
-# slave it wants to talk to. Slave addresses are 7 bits long (MSB-first).
-# After those 7 bits, a data direction bit is sent. If the bit is low that
-# indicates a WRITE operation, if it's high that indicates a READ operation.
-#
-# Later an optional 10bit slave addressing scheme was added.
-#
-# Documentation:
-# http://www.nxp.com/acrobat/literature/9398/39340011.pdf (v2.1 spec)
-# http://www.nxp.com/acrobat/usermanuals/UM10204_3.pdf (v3 spec)
-# http://en.wikipedia.org/wiki/I2C
-#
 
 # TODO: Look into arbitration, collision detection, clock synchronisation, etc.
 # TODO: Handle clock stretching.
 # TODO: Handle multiple different I2C devices on same bus
 #       -> we need to decode multiple protocols at the same time.
 
-'''
-Protocol output format:
-
-I2C packet:
-[<i2c_command>, <data>, <ack_bit>]
-
-<i2c_command> is one of:
-  - 'START' (START condition)
-  - 'START REPEAT' (Repeated START)
-  - 'ADDRESS READ' (Address, read)
-  - 'ADDRESS WRITE' (Address, write)
-  - 'DATA READ' (Data, read)
-  - 'DATA WRITE' (Data, write)
-  - 'STOP' (STOP condition)
-
-<data> is the data or address byte associated with the 'ADDRESS*' and 'DATA*'
-command. For 'START', 'START REPEAT' and 'STOP', this is None.
-
-<ack_bit> is either 'ACK' or 'NACK', but may also be None.
-'''
-
 import sigrokdecode as srd
 
 # Annotation feed formats
index 83f7b121fa338054111cefc0aa68524a3a1a2eb6..445a88e501fa2183328934ab2703f86e6a8a8643 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+Generic I2C demultiplexing protocol decoder.
+
+Takes an I2C stream as input and outputs multiple I2C streams, each stream
+containing only I2C packets for one specific I2C slave.
+'''
+
 from .i2cdemux import *
 
index 354d06c23473f66c141d6eef0ce604515ff83c29..a597188fc95b695e3ff8c4de76cdac6723a9c48c 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # Generic I2C demultiplexing protocol decoder
-#
-# Takes an I2C stream as input and outputs multiple I2C streams, each stream
-# containing only I2C packets for one specific I2C slave.
-#
 
 import sigrokdecode as srd
 
index 6c5f1ec0e2bfe8d211b97066caf177cad40c6148..e9a9ab6028466134b1679751fe9e823c240df13d 100644 (file)
@@ -18,6 +18,8 @@
 ##
 
 '''
+Generic I2C filtering protocol decoder.
+
 Takes input from the I2C protocol decoder and filters out traffic from/to
 a single address on the I2C bus.
 
index 4b88befbcfa147ec9ed838daa8ac1190073d0a24..da816e6fe0e0d5766f54af65c40daf551b3c748d 100644 (file)
@@ -17,8 +17,9 @@
 ## along with this program; if not, see <http://www.gnu.org/licenses/>.
 ##
 
-import sigrokdecode as srd
+# Generic I2C filtering protocol decoder
 
+import sigrokdecode as srd
 
 class Decoder(srd.Decoder):
     api_version = 1
index 4cc39a358463a5acbc3aa8306b65d4e1e2096166..f50e56882123d419d152ead60e35c916434638f1 100644 (file)
@@ -18,9 +18,7 @@
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # Melexis MLX90614 Infrared Thermometer protocol decoder
-#
 
 import sigrokdecode as srd
 
index 0affc9959f600e74262d9308ae7b7cad91127e40..26b1a58a7df945c990f6fbe953b45a7b4883b921 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+Macronix MX25Lxx05D SPI (NOR) flash chip decoder.
+
+Works for MX25L1605D/MX25L3205D/MX25L6405D.
+
+TODO: Description.
+
+Details:
+http://www.macronix.com/QuickPlace/hq/PageLibrary4825740B00298A3B.nsf/h_Index/3F21BAC2E121E17848257639003A3146/$File/MX25L1605D-3205D-6405D-1.5.pdf
+'''
+
 from .mx25lxx05d import *
 
index a21ba3faa563bbe1977426b29d8669dcab5881a9..801ab809c09aa3146a4f98dc764252bf732c9461 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
-# Macronix MX25Lxx05D SPI (NOR) flash chip decoder.
-# Works for MX25L1605D/MX25L3205D/MX25L6405D.
-#
+# Macronix MX25Lxx05D SPI (NOR) flash chip protocol decoder
 
-#
-# TODO: Description
-#
-# Details:
-# http://www.macronix.com/QuickPlace/hq/PageLibrary4825740B00298A3B.nsf/h_Index/3F21BAC2E121E17848257639003A3146/$File/MX25L1605D-3205D-6405D-1.5.pdf
-#
+# Note: Works for MX25L1605D/MX25L3205D/MX25L6405D.
 
 import sigrokdecode as srd
 
index 6772ba76ce6f19bdfc6126407f82cad2c88e40a0..da6db065b4fc3343d630170714f61d608a510c2d 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+Nintendo Wii Nunchuk decoder.
+
+TODO: Description.
+
+Details:
+http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Nunchuck
+http://todbot.com/blog/2008/02/18/wiichuck-wii-nunchuck-adapter-available/
+https://www.sparkfun.com/products/9281
+'''
+
 from .nunchuk import *
 
index db40d358ddb7e1c59bfab718f697f654cfdb2870..f9019050439a359727e2b3c7bd754d818f0d4616 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
-# Nintendo Wii Nunchuk decoder
-#
-
-#
-# TODO: Description
-#
-# http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Nunchuck
-# http://todbot.com/blog/2008/02/18/wiichuck-wii-nunchuck-adapter-available/
-# https://www.sparkfun.com/products/9281
-#
+# Nintendo Wii Nunchuk protocol decoder
 
 import sigrokdecode as srd
 
index e89b6a0f8097b9440de071891466a61dc0dbe508..2c7e6c6e2af7e822706f1334e9870a95ecd43299 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # Panasonic PAN1321 Bluetooth module protocol decoder
-#
-# TODO
-#
 
 import sigrokdecode as srd
 
index 18f8c24379ecf793fd0c25f792d62e533a213fd6..00bfb278ea41e0ce7bde91f30e17f1514c06d1f4 100644 (file)
@@ -18,9 +18,7 @@
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
-# Epson RTC-8564 JE/NB decoder
-#
+# Epson RTC-8564 JE/NB protocol decoder
 
 import sigrokdecode as srd
 
index bbf0f3705af62f9762794d3e19cf064ccd84f793..dfe83b95499f16587d1c4672546c8a0e752307b7 100644 (file)
@@ -19,6 +19,8 @@
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+# SPI protocol decoder
+
 import sigrokdecode as srd
 
 # Key: (CPOL, CPHA). Value: SPI mode.
index 4156bfc3b8337a8bd2c1790b45d7d954b691f219..4b458b2ed778a22bc56acb5f383275e01a92d7d3 100644 (file)
@@ -18,6 +18,8 @@
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+# Transition counter protocol decoder
+
 import sigrokdecode as srd
 
 class Decoder(srd.Decoder):
index 1c7f317841622edc11de5405305f6892af0d7624..43e7706c8897d3223497c5105d6bc44c413c6fbe 100644 (file)
@@ -19,6 +19,8 @@
 ##
 
 '''
+UART protocol decoder.
+
 Universal Asynchronous Receiver Transmitter (UART) is a simple serial
 communication protocol which allows two devices to talk to each other.
 
index 16048346d1bd70d06053fd5dc4b07a4dd766f003..dd9f88d3f72d70a3821d56f733d06f4820ff66a0 100644 (file)
@@ -18,9 +18,7 @@
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
 # UART protocol decoder
-#
 
 import sigrokdecode as srd
 
index 068cadff5c5291111824c19e238baaeca6b749ae..77b58d11a509806fe6d280cb4fcaff70c512bad1 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
+'''
+USB (full-speed) protocol decoder.
+
+Full-speed USB signalling consists of two signal lines, both driven at 3.3V
+logic levels. The signals are DP (D+) and DM (D-), and normally operate in
+differential mode.
+The state where DP=1,DM=0 is J, the state DP=0,DM=1 is K.
+A state SE0 is defined where DP=DM=0. This common mode signal is used to
+signal a reset or end of packet.
+
+Data transmitted on the USB is encoded with NRZI. A transition from J to K
+or vice-versa indicates a logic 0, while no transition indicates a logic 1.
+If 6 ones are transmitted consecutively, a zero is inserted to force a
+transition. This is known as bit stuffing. Data is transferred at a rate
+of 12Mbit/s. The SE0 transmitted to signal an end-of-packet is two bit
+intervals long.
+
+Details:
+https://en.wikipedia.org/wiki/USB
+http://www.usb.org/developers/docs/
+'''
+
 from .usb import *
 
index b209aa3186fbf9f2ba4feffa63bdd0ca74cd03db..99dd4b5addba0225441bbe84207a4ffe2cd83bdf 100644 (file)
 ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 ##
 
-#
-# USB Full-speed protocol decoder
-#
-# Full-speed USB signalling consists of two signal lines, both driven at 3.3V
-# logic levels. The signals are DP (D+) and DM (D-), and normally operate in
-# differential mode.
-# The state where DP=1,DM=0 is J, the state DP=0,DM=1 is K.
-# A state SE0 is defined where DP=DM=0. This common mode signal is used to
-# signal a reset or end of packet.
-#
-# Data transmitted on the USB is encoded with NRZI. A transition from J to K
-# or vice-versa indicates a logic 0, while no transition indicates a logic 1.
-# If 6 ones are transmitted consecutively, a zero is inserted to force a
-# transition. This is known as bit stuffing. Data is transferred at a rate
-# of 12Mbit/s. The SE0 transmitted to signal an end-of-packet is two bit
-# intervals long.
-#
-# Details:
-# https://en.wikipedia.org/wiki/USB
-# http://www.usb.org/developers/docs/
-#
+# USB (full-speed) protocol decoder
 
 import sigrokdecode as srd