Difference between revisions of "Protocol decoders"

From sigrok
Jump to navigation Jump to search
m (→‎Protocol decoders: Use a table.)
m (More tables.)
Line 153: Line 153:
'''Custom / application-specific protocols that have raw signals/samples as input:'''
'''Custom / application-specific protocols that have raw signals/samples as input:'''


* Atmel AT93C46 serial EEPROM protocols
{| border="0" style="font-size: smaller"
* [http://en.wikipedia.org/wiki/HD44780_Character_LCD HD44780 character LCD] protocol
|- bgcolor="#6699ff"
* ...
!Protocol
!Status
!Comments
 
|- bgcolor="#6699ff"
| colspan="3" | '''Serial EEPROMs'''
 
|- bgcolor="#eeeeee"
| AT93C46
| bgcolor="red" | 0%
| Atmel AT93C46 serial EEPROM protocol
 
|- bgcolor="#6699ff"
| colspan="3" | '''Displays'''
 
|- bgcolor="#eeeeee"
| HD44780
| bgcolor="red" | 0%
| [http://en.wikipedia.org/wiki/HD44780_Character_LCD HD44780 character LCD] protocol
 
|}
 
... and many, many more.


'''Non-protocol data analysis decoders / analyzers that have raw signals/samples as input:'''
'''Non-protocol data analysis decoders / analyzers that have raw signals/samples as input:'''
Line 162: Line 184:
* Min/Max/Avg distance between two events (rising edge, falling edge, signal lenths, etc.)
* Min/Max/Avg distance between two events (rising edge, falling edge, signal lenths, etc.)
* ...
* ...
... and many, many more.


=== High-level decoders ===
=== High-level decoders ===
Line 167: Line 191:
'''Protocols that do not have raw signals/samples as input, but rather an already-preprocessed bytestream generated by one of the low-level decoders:'''
'''Protocols that do not have raw signals/samples as input, but rather an already-preprocessed bytestream generated by one of the low-level decoders:'''


* LCD display protocols over I2C (e.g. [http://www.lcd-module.de/pdf/grafik/ediptft43-a.pdf EA eDIPTFT43-A])
{| border="0" style="font-size: smaller"
* LCD display protocols over SPI (e.g. [http://pdf1.alldatasheet.com/datasheet-pdf/view/36922/SAMES/SA8807A.html Sames SA8807A])
|- bgcolor="#6699ff"
* LCD display protocols over RS232/USART (e.g. TODO)
!Protocol
* I2C-attached ADC control protocol ([http://pdf1.alldatasheet.com/datasheet-pdf/view/318172/AD/AD7291.html Analog Devices AD7291])
!Input protocol
* SPI-attached serial EEPROMs
!Status
* ...
!Comments
 
|- bgcolor="#6699ff"
| colspan="4" | '''Serial EEPROMs'''
 
|- bgcolor="#eeeeee"
| TODO
| SPI
| bgcolor="red" | 0%
| SPI-attached serial EEPROM. Datasheet: TODO.
 
|- bgcolor="#6699ff"
| colspan="4" | '''Displays'''
 
|- bgcolor="#eeeeee"
| SA8807A
| SPI
| bgcolor="red" | 0%
| SPI-attached LCD. Datasheet: [http://pdf1.alldatasheet.com/datasheet-pdf/view/36922/SAMES/SA8807A.html Sames SA8807A].
|- bgcolor="#eeeeee"
| EA eDIPTFT43-A
| I2C
| bgcolor="red" | 0%
| I2C-attached LCD. Datasheet: [http://www.lcd-module.de/pdf/grafik/ediptft43-a.pdf EA eDIPTFT43-A].
|- bgcolor="#eeeeee"
| TODO
| USART/RS232
| bgcolor="red" | 0%
| TODO
 
|- bgcolor="#6699ff"
| colspan="4" | '''ADC'''
 
|- bgcolor="#eeeeee"
| AD7291
| USART/RS232
| bgcolor="red" | 0%
| I2C-attached ADC. Datasheet: [http://pdf1.alldatasheet.com/datasheet-pdf/view/318172/AD/AD7291.html Analog Devices AD7291].
 
|}
 
... and many, many more.


'''Non-protocol data analysis decoders / analyzers:'''
'''Non-protocol data analysis decoders / analyzers:'''

Revision as of 18:50, 31 March 2010

Ideas

  • Plugin system for protocol decoding:
    • Should support SPI, I2C, RS232/UART and many many more protocols, see below.
    • Should be easy to add support for additional/custom protocols, e.g. AT93C46:
      • CS (chip select)
      • SK (clock)
      • DI (data from chip to outside)
      • DO (data from outside into chip)
      • Has start bit, opcodes, data following transmission
    • A protocol as simple as this should be doable to implement without code, only the description of the meaning of the various pins.
  • PD plugins must be GUI-independent: they must always work on any GUI present in sigrok. The plugin interface must therefore provide hooks for:
    • Providing data from core to plugin - stream or dump.
    • Sending analysis results back from the plugin, e.g. timestamps or sample IDs with structured results:
      • Type:
        • Protocol overhead e.g. start bits
        • Commands e.g. opcodes
        • Command parameters e.g. address following a READ command
        • Extracted data
        • String to display over the data ("opcode READ")
        • Data (e.g. 10) + length in bits (e.g. 2)
        • Results can overlap, as in e.g. "READ address 0x08" and "opcode 10"
  • This also opens up the possibility of producing e.g. a protocol analysis report from the main code.
  • All PD plugins are written in Python.
    • We embed a scripting language (Python) for very simple transforms and/or additional display; e.g. 4-bit interface to HD44780 LCD, take two nibbles in sequence, based on clock line, and assemble them into a whole byte. Scripted plugin could do this, then pass the data back to the UI for display.

PD plugin infrastructure

The core backend takes a streaming feed from a live aquisition source (or from a saved session). If any PA plugins are configured to act on this source, a pipe is set up to feed this raw data to the embedded Python plugin dispatcher. The dispatcher configures the PD plugins, in order, to write to/read from each other's input and output queues. The dispatcher then starts feeding raw data into the bottom plugin's input queue, and takes output from the top plugin's output queue, which it feeds back to the backend.

Protocol decoders

This is a list of ideas for specific protocol decoders we might want to write in the future (or users might want to contribute).

Low-level decoders

Standard protocols that have raw signals/samples as input:

Protocol Status Comments
Basic / microcontrollers / embedded
SPI 0%
I2C 0%
USART/RS232 0%
Automotive / industrial / embedded
CAN 0%
Embedded
JTAG 0%
PC
USB 1.1 0%
USB 2.0 0%
USB 3 0%
LPC 0%
FWH 0%
ISA 0%
PCI 0%
SMBus 0%
Consumer IR
Nokia NRC17 0%
Sony SIRC 0%
Philips RC-5 0%
Philips RC-6 0%
Philips RC-MM 0%
Philips RECS80 0%
Miscellaneous
IrDA 0%

... and many, many more.

Custom / application-specific protocols that have raw signals/samples as input:

Protocol Status Comments
Serial EEPROMs
AT93C46 0% Atmel AT93C46 serial EEPROM protocol
Displays
HD44780 0% HD44780 character LCD protocol

... and many, many more.

Non-protocol data analysis decoders / analyzers that have raw signals/samples as input:

  • Number of clock cycles / rising-edges / falling-edges / transitions / etc. (total or per-signal)
  • Min/Max/Avg distance between two events (rising edge, falling edge, signal lenths, etc.)
  • ...

... and many, many more.

High-level decoders

Protocols that do not have raw signals/samples as input, but rather an already-preprocessed bytestream generated by one of the low-level decoders:

Protocol Input protocol Status Comments
Serial EEPROMs
TODO SPI 0% SPI-attached serial EEPROM. Datasheet: TODO.
Displays
SA8807A SPI 0% SPI-attached LCD. Datasheet: Sames SA8807A.
EA eDIPTFT43-A I2C 0% I2C-attached LCD. Datasheet: EA eDIPTFT43-A.
TODO USART/RS232 0% TODO
ADC
AD7291 USART/RS232 0% I2C-attached ADC. Datasheet: Analog Devices AD7291.

... and many, many more.

Non-protocol data analysis decoders / analyzers:

  • How many data bytes are in the data stream?
  • What's the min/max/avg data value?
  • ...
Retrieved from "https://sigrok.org/w/index.php?title=Protocol_decoders&oldid=238"