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.

code cleanup

configure.ac: Drop std-options, unneeded.

The automake 'std-options' option checks whether all installed tools
and scripts have a --help and --version CLI option. This check is not
needed for libsigrokdecode though, since it doesn't install any tools.

README: Refer to INSTALL and new Building wiki page.

ds1307: Fix date/day-of-week printing.

Add Dallas DS1307 RTC protocol decoder

Dallas DS1307 RTC protocol decoder that works stacked
with the I2C PD. Based on the rtc8564 protocol decoder.

Signed-off-by: Matt Ranostay <redacted>

Doxygen: Initial groups and topic short descriptions.

Doxygen: Add @file items for the relevant files.

These short descriptions are shown in the "Files" section of the
Doxygen output.

Doxygen: Mark private functions/variables properly.

Doxygen: Document how to mark private stuff.

Doxygen: Add intro section and some docs.

Add contrib/sigrok-logo-notext.png.

This is used in the generated Doxygen HTML output.

Doxyfile: Update to match the libsigrok file/settings.

This uses a template generated by Doyxgen 1.8.1.2 (like libsigrok
currently does) and adapts it to libsigrokdecode needs.

.gitignore: Add INSTALL (copied by automake).

Bring back temporarily reverted changes.

can: Temporary quickfix for a bug.

Update package version to new 0.1.1 release.

Update libtool version numbers for libsigrokdecode.

The last release of libsigrokdecode (package version number 0.1.0) had the
initial libtool version numbers (current:revision:age) of 0:0:0.

The upcoming release (0.1.1) is API-compatible with 0.1.0 and can be used
as drop-in replacement. Programs linked against 0.1.0 do not need to
be recompiled or relinked.

As per the libtool guidelines this release only increments the
libtool "revision" number. The new libtool version numbers
(current:revision:age) are thus 0:1:0.

See here for details:
http://www.gnu.org/software/libtool/manual/libtool.html#Updating-version-info

NEWS: Various updates.

Minor autotools improvements.

 - Don't use "foreign" option for automake. Without this automake will
   perform some additional sanity checks e.g. on missing files. It will also
   now add the usual INSTALL file which documents the configure options etc.

 - Add AUTHORS file.

 - Add 'check-news' automake option, which will abort 'make dist' if
   the NEWS file doesn't list the current (to be released) package
   version at the top (i.e., if we forget to update NEWS).

Temporarily revert API changes in preparation of release.

The upcoming libsigrokdecode release should not contain any API changes
so it is compatible with existing released frontends (sigrok-cli 0.3.1).

configure.ac: Drop AC_PROG_CXX.

We don't need a C++ compiler for libsigrokdecode, so don't check for one.

This would cause a build failure on all systems where there is a C compiler
but no C++ compiler installed.

Lower glib-2.0 requirement to 2.24.0.

We don't use any of the recent glib features in libsigrokdecode, it
compiles fine with 2.24.x.

Makefile.am: Fix typo in 'ChangeLog' target.

Cosmetics, fix typos.

NEWS: Add list of user-visible changes so far.

Small cosmetic/consistency fixes in the PDs.

constify srd_decoder_list() output

srd_inst_new() options can be NULL

Fix compiler warning.

configure.ac: Add missing -fvisibility=hidden to CFLAGS.

configure.ac: Fix CFLAGS settings.

Don't override/overwrite CFLAGS in configure.ac, but rather amend it
with (currently) "-Wall -Wextra".

This properly allows users/packagers to do things like:

 ./configure (this will default to using "-g -O2" additionally)

 CFLAGS="-g -O2" ./configure (same as above)

 CFLAGS="" ./configure (no additional flags)

 CFLAGS="-g -O0" ./configure (disable optimization, e.g. for valgrind use)

 etc. etc.

Add intial CAN protocol decoder.

configure.ac: Also check for python3.3-config.

mlx90614: "Kelvin", not "degrees Kelvin".

Fix bugs in "Invalid state" printing/exceptions.

All PDs: Name the files pd.py consistently.

The Python module name is determined by the directory name (e.g. dcf77),
the *.py file names in that directory don't matter and can be kept
consistent.

configure.ac/Makefile.am: Alphabetical order.

tlc5620: Refactoring, add initial LOAD support.

Initial TI TLC5620 (8-bit quad DAC) protocol decoder.

Re-add HACKING file after repo split.

Small update for the pkg-config files and Windows.

On Windows, cmake-using projects seem to have problems with the
"-I/c/Python32/include" syntax we have in the libsigrokdecode .pc file.

However, "-Ic:/Python32/include" works fine. So we just add both to
support everything.

README: Update repo URL.

.gitignore: Add missing entries.

README: Add status, update URL, small fixes.

srd: uart: Fix regression.

Thanks Iztok Jeras <redacted> for the report.

Add initial SD card (SPI mode) decoder.

This is work in progress, but it already works partially, and can be used
for actual decodes of some commands.

This PD stacks on top of the SPI protocol decoder.

srd: lm75: s/degrees Kelvin/Kelvin/.

The temperature unit is nowadays called just "Kelvin", not
"degrees Kelvin" (even though this was not always the case).