Code cleanup

i2s_dump: Fix bug in the WAV output format generation.

Add new i2s_dump protocol decoder.

This stacks of top of the 'i2s' decoder and outputs the audio data to
file (or stdout) in various formats. Currently only WAV is supported.

This is work in progress, it has various hard-coded assumptions.

tlc5620: Output short/long annotations.

This fixes (the remaining parts of) bug #168.

tlc5620: Use annotation types.

This fixes parts of bug #168.

lpc: Initial start-/end-sample support.

This fixes (parts of) bug #163.

lpc: Use annotation types.

This fixes (parts of) bug #163.

lpc: Make the RESET# pin optional.

lpc: Fix handling of optional probes.

lpc: Add annotation helper method.

This fixes (parts of) bug #163.

usb_signalling: Drop packet handling.

The usb_signalling PD should not care about packets, only symbols and bits.
The new (fixed) usb_packet PD constructs packets out of individual bits now.

usb_packet: Major rewrite, e.g. to prepare for GUI usage.

Restructure the PD into a state machine, output individual packet
components as separate annotations, define a protocol output format and
implement it (so that other PDs can stack on top of this one), and fix
various other isses in the PD.

Rename usb_protocol to usb_packet.

There will be further PDs that are stacked on top of usb_packet.

usb_signalling: Document protocol output format.

Also, add missing output for some packet types.

onewire_link: Provide short/long annotations.

onewire_link: Fix typos.

onewire_link: Split "reset" and "presence" annotations.

This needs a few more fixes later, but it's a start.

onewire_link: Default the 'overdrive' option to 'no'.

onewire_link: Use defaults for the PD options.

This also simplifies the PD code a bit.

onewire_link: Drop PD info not useful for the user.

onewire_link: Use annotation types.

This fixes bug #147.

onewire_link: Add/use annotation helpers.

i2s: Add shorter and longer annotations for GUI use.

This fixes (the remaining parts of) bug #162.

i2s: Define/use common proto out format.

i2s: Add helper methods for annotation/proto output.

i2s: Use annotation types.

This fixes parts of bug #162.

Add initial MIDI protocol decoder.

This supports a certain number of MIDI messages already, but not yet all
of them. More will be added later.

usb_signalling: Fix packet annotation.

usb_signalling: Fix EOP handling and annotation.

usb_signalling: Properly use different annotation types.

usb_signalling: Fix decode of individual bits.

After a Start of Packet (SOP) has been detected, "sample" the individual
USB symbolѕ/bits in the middle of the respective bittime (depending on
whether full-speed or low-speed signalling is used).

This fixes various incorrectly decoded cases (bug #158).

usb_signalling: Simplify symbols handling a bit.

usb_signalling: Refactor/simplify bitrate/bitwidth handling.

usb_signalling: Fix start/end sample numbers.

This makes the decoder suitable for GUI usage.

This fixes bug #155.

dcf77: Fix date parity check.

The parity check for certain DCF77 fields/bits was incorrect. It has to be
an even parity over bits 36-58. This is fixed now.

This fixes bug #157.

dcf77: Provide short and long annotations.

dcf77: Fix multi-bit DCF77 field annotations.

dcf77: Consistency renames.

dcf77: Drop PON pin handling.

The PON pin is specific to the Pollin "DCF1 module", but has nothing to
do with DCF77 itself. Thus, drop it from this PD. It can be part of
another stacked PD if needed.

This fixes bug #153.

dcf77: Use proper annotations for DCF77 components.

dcf77: Fix bug in handling of DCF77 bit 0.

dcf77: Fix start-/end-sample numbers.

This fixes bug #154.

i2c: Drop unneeded 'addressing' option.

This (unimplemented so far) option is not needed at all, since the
decoder will be able to detect 7/10 bit slave addresses automatically,
the user doesn't have to specify slave address sizes.

i2c: Drop obsolete TODOs.

i2c: Move OUTPUT_PROTO docs to pd.py.

i2c: Moved extensive protocol docs to the wiki.

i2c: Various fixes to make the PD suitable for GUIs.

The output format of the slave address is now a PD option. It can be
"shifted" or "unshifted", i.e. bit 0 (which contains a read/write
marker) is either shifted out or not, i.e., the slave address is
displayed as 8bit or 7bit number (or 11bit/10bit number for 10bit slave
addresses).

Data bytes (not address bytes) are always shown as 8bit values, of course.

Add annotation types for the individual I2C components such as
start conditions, stop conditions, ACK/NACK, address read/writes,
data read/writes and so on.

This fixes bug #151.

spi: Add some documentation, move OUTPUT_PROTO docs.

Add a short help text for the PD and move the OUTPUT_PROTO docs to pd.py
since they're not meant for the user too see.

spi: Make CS# optional and use it if supplied.

The CS# pin is now optional, it can either be supplied to the PD or not.

If it _is_ supplied, reset the PD state every time it changes. This has
the effect that "incomplete" SPI frames and those where CS# is not
asserted are ignored and not decoded.

This fixes bug #152.

spi: Refactor code, use a state machine.

spi: Provide multiple annotation types.

For now SPI gets the following annotation types:

 - MISO/MOSI SPI data
 - MISO SPI data
 - MOSI SPI data

(i.e. you can see either MISO, or MOSI, or both; the latter is most
useful for CLI usage)

Also, show the hex values as e.g. F5 (upper-case letters, no "0x" prefix).

spi: Fix start-/end-sample numbers.

This now makes the SPI decoder suitable for use in GUIs.

This fixes bug #150.

spi: Make data format a PD option, add annotation types.

The data format can be specified via the PD's "format" option now, it is
no longer an annotation type.

Also, add and use two annotation types: "Data" and "Warnings".

can: Use proper annotation types for the CAN fields.

This allows GUIs to show different fields in different colors.

uart: Output data in separate RX and TX annotation types.

There is one annotation type for the RX side of the communication/data
output now, and another one for the TX side.

This allows GUIs to show them in two different traces, and/or show them in
the same trace but with different colors.

This also has the additional benefit that it is clear which databyte
belongs to which direction. Previously the annotations had to look like
"RX: 5F" or "TX: 11001011", but the "RX: " and "TX: " prefixes are now
no longer required, making the GUI traces (and CLI output too) much more
readable.

uart: Use same length for data output in all cases.

Until now you could get e.g. "d" or "df" as hex output from the UART PD.

This will now be a common-length "0D" and "DF". When all data byte
annotations are of the same lengths the readability in GUI traces is a lot
better. Also, hardcode hex characters to be upper-case (for now).

The same applies to oct ("021" instead of "21") and bin output
("00001001" instead of "1001").

uart: Put annotations into proper annotation types.

There are now extra annotation types for data, start/stop/parity bits and
for warnings (e.g. "invalid parity" or "frame error" or such).

This allows users to select which of the annotation types they want to
see (they can select one/multiple/all annotations as needed), and also
allows them to use different visual representation for the different
annotation types in GUIs (e.g. different colors for the blobs, different
fonts, rectangle/round/elliptic blobs, and so on; how the annotation
blobs are displayed is entirely up to the GUI and its configuration by
the user).

uart: Move OUTPUT_PROTO format description to pd.py.

This is information that a user (when viewing PD info in a GUI/CLI)
should not see (and doesn't care to see), it is meant for developers only.

Thus, make it a comment in pd.py instead.

uart: Drop extensive protocol info (moved to wiki).

Move the full details of the protocol to the wiki, the docs in the PD
itself should only be a short description and/or a collection of notes
that could be useful for a user in a GUI (or CLI) to decide which
PD to select, which options to set how, what PDs to stack where, and so on.

The full protocol description (including photos, examples, ...) is here:

  http://sigrok.org/wiki/Protocol_decoder:Uart

uart: Make data format selection a PD option.

Until now we (ab)used annotation types for outputting the same data
(numbers) in different formats (hex, ascii, binary, and so on).

Turn this into a proper PD option, since annotation types should rather be
used for different _types_ of annotations (e.g. "CRC", "Stop bit",
"Preamble", "Sequence counter", "Warnings", and similar things), not
different _formats_ for the same annotation type.

Old sigrok-cli invocation for hex output:

  sigrok-cli ... -P uart:rx=0:tx=1 -A uart=hex

New:

  sigrok-cli ... -P uart:rx=0:tx=1:format=hex

In GUIs there is now a new "Data format" option where the user can
select the output format for UART data (default is 'ascii').

uart: Use T for stop bit, P for parity bit.

The short(est) annotations for "Stop bit" and "Parity bit" have both
been "P" until now, which is confusing for users (on certain zoom levels
in GUIs). Use "T" for stop bits now instead.

uart: Don't prefix databyte output numbers.

Previously the output was 0x41 or 0o101 or 0b1000001, now it is 41 or
101 or 1000001. We drop these prefixes, since they decrease the readability
of the PD output (especially when displayed in GUIs) and are not needed
anyway since the user knowingly selected the number format before running
the respective PD.

uart: Fix corner-case that can occur with LA triggers.

Assume that the initial pin state is 1/high for the RX and TX lines.

This fixes the decode when an LA triggers on e.g. TX=low (the first
sample would be low in that case, so the falling edge for the start bit
would be missed by the decoder).

uart: Fix start-/end-sample numbers.

This now makes the UART decoder suitable for use in GUIs.

This fixes bug #148.

can: Use annotation abbreviations.

Supply long, middle, and short versions for most annotations, so that
GUIs can show nicely readable and useful annotations on various zoom
levels.

can: Fix annotation start/end samples.

With this change pretty much all CAN annotations that are currently
output should have the correct values, including single-bit and
multi-bit fields, standard and extended CAN frames, and so on.

This fixes #146.

can: Prepare for fixing annotation start/end samples.

i2c: Fix corner-case that can occur with LA triggers.

Until now the I2C PD was basically ignoring the very first sample, and
using that as the initial 'oldscl'/'oldsda' value.

However, if your logic analyzers trigger on, say, SDA=low that will
result in a file where the first sample is really important since it
is the one which the PD will need to know that there's a falling edge
on SDA.

Thus, assume both SCL and SDA are high/1 when the PD starts. This is
a good assumption since both pins have pullups on them in practice
and are thus high/1 when the bus is idle.

Later on we might want to have config options to let the PD assume
other states of SDA/SCL initially.

i2s: Fixed annotation sample numbers

pan1321: Improve commands documentation.

pan1321: Initial JSDA support.

pan1321: Add support for JAAC.

pan1321: Properly check for \r\n, not just \n.

pan1321: Code simplifications.

pan1321: Add warnings for invalid protocol usage.

pan1321: Support JSEC and JPRO.

Use frontend-registered callback with correct parameters

xfp: Decoder for XFP I2C structures

Ignore __pycache__ entries

lpc: Bugfix: Sample data at rising clock edges.

lpc: Various fixes to make the PD actually work.

Fix double free

Fix double free

Doxyfile: Set version to "unreleased development snapshot".

Fix various memory leaks

Use enums for error codes and loglevels as in libsigrok.

Add srd_strerror() and srd_strerror_name().

libsigrokdecode-internal.h: Cosmetics.

NEWS: Minor updates.

Doxygen: Various fixes.

Main header is <libsigrokdecode/libsigrokdecode.h> now.

This matches the convention used in libsigrok. Potential other headers
might end up in libsigrokdecode/, but only libsigrokdecode.h is meant
to be #included by frontends directly.

Doxygen: Add @since markers to API functions.

Also, document the functions in version.c.

HACKING: Document the @since Doxygen tag.

Doxyfile: Set version number to 0.2.0.

Update package version to new 0.2.0 release

GPL headers: Use correct project name.

configure.ac: Show $build, $host, and lib versions.

configure.ac: Look for python-config-3.x besides python3.x-config.

README: Add "Copyright and license" section.

use GVariant for passing decoder options and probes

Decoder options are now exposed in struct srd_decoder, via a GSList
of the new struct srd_decoder_option. The 'def' field represents
the default value as set in the decoder, converted to GVariant. This
allows a library user to determine the type as well as default value.