sr/srd/cli: Fix compiling with Homebrew.

Add ACLOCAL_DIR setting and AM_PROG_AR macro for compiling with Homebrew
under Mac OS X.

Applies essentially the same change to
{libsigrok,libsigrokdecode,sigrok-cli}/{autogen.sh,configure.ac}

It may be that the same fix is needed for the other autogen.sh and/or
configure.ac files, but that hasn't been tested and therefore not in
this commit.

srd: JTAG: Enavble and get/use optional probes.

srd: Support for one or more optional probes.

In the protocol decoder you always get all required probes, then _all_
optional probes in the list of probes in the decode() call.

Example:

 (r1, r2, r3, o1, o2, o3, o4) = pins

In this case r1-r3 are required probes, o1-o4 are optional probes.
However, the value of valid/used/specified probes will be 0 or 1,
whereas the value of probes that were not specified/assigned by the user
will be (at the moment) 42.

The PD can check for a valid probe like this:

  if p in (0, 1):
    ...

Or check for an invalid probe:

  if (p > 1):
    ...

The value of 42 could change to be -1 or None later.

srd: Fix a few Doxygen errors.

srd: Add usable one-liner descriptions for all PDs.

srd: Remove TODOs from annotation format names.

Also, fix minor consistency issues, cosmetics, typos.

srd: JTAG/SMT32: Some more improvements.

Add APB-AP register offsets/names, refactor and fix some code, handle
in/out APACC/DPACC better.

Fix bracket placing

Make it consistent with the rest of the code

Signed-off-by: Thomas Jarosch <redacted>

srd: JTAG/STM32: Factor out dpacc_data_in/out.

Also, add a few code comments.

srd: JTAG/STM32: Decode IDCODE[31:0] parts.

srd: JTAG: Also show the bitstrings in hex (for now).

srd: JTAG/STM32: Various improvements, fixes.

Add APACC register handling, fix DPACC handling (esp. 'A' register size),
ouput a warning upon reserved DAPABORT bits being non-zero, implement
preliminary state machine, add various TODOs.

This is still work in progress, not yet finished or working properly.

srd: Add initial JTAG/STM32 protocol decoder.

(not yet finished)

This protocol decoder can decode ST STM32 specific JTAG accesses, knows
about the STM32-specific registers and bits.

srd: JTAG: Add some more docs.

srd: JTAG: The TRST# (and SRST#) signals are optional.

Don't handle them for now, will do this later.

srd: jtag: Various bugfixes.

Most importantly, both TDI and TDO are sampled at the rising TCK edge,
and only upon transitions from SHIFT-DR to SHIFT-DR and SHIFT-IR to SHIFT-IR
are we to save the TDI/TDO values (if I understood this correcly).

Also, start out in RUN-TEST/IDLE state for now. This is useful if you
have JTAG dumps which start "in the middle" somewhere, not in the
TEST-LOGIC-RESET state. For full dumps, the JTAG software usually issues
five TMS=1 cycles to force the JTAG state machine into TEST-LOGIC-RESET
anyway, so this works fine too.

srd: Add initial JTAG protocol decoder.

This is unfinished, needs some more work.

srd: lpc: Minor additions/fixes.

srd: MXC6225XU: Bugfixes, add missing bits/registers.

srd: Initial MEMSIC MXC6225XU protocol decoder.

Not quite finished yet, but relatively close.

Initial LPC protocol decoder implementation.

This is unfinished and not tested, and probably not really working, yet.

srd: Initial 0.1.0 release.

sr/srd: SR_API/SRD_API/etc. is a no-op on MinGW.

This avoids warnings on a MinGW build. The feature depends on ELF files,
but MinGW/Windows uses PE files.

srd: Quickfix for MinGW build issue.

srd: Add functions to query srd version(s).

sr/srd: Use/fix SR(D)_MAX_NUM_PROBES.

srd/i2s: Added links to documentation

srd/i2s: Added sample-rate and bit-depth to report

srd/i2s: Print a warning on receiving a malformed word

srd/i2s: Initial implementation

srd: Disable 'nunchuk' PD for now, it's unfinished.

srd: Decoders: Fix/simplify samplenum usage.

sr/srd: Fix 'make distcheck'.

sr/srd: Add ChangeLog to ignore list, it's generated.

srd: Generate ChangeLog from git upon 'make dist'.

srd: Add NEWS file.

srd: SRD_PACKAGE_VERSION_* for consistency.

No need to use the LIBSIGROKDECODE_ prefix here when we use SRD_ everywhere
else. Also, better distinction between package version and lib version.

srd: Some more (optional) consistency renames.

srd/cli/qt: Some more API consistency renames.

srd: PDs: Kill obsolete 'longdesc' entries.

srd: Add .gitignore file.

srd: sigrokdecode.h: Add version macros.

srd: Rename sigrokdecode.h to sigrokdecode.h.in.

srd: List 'report()' in all PDs for consistency.

srd: Drop unused inputformats/outputformats entries.

sr/srd: Remove API warnings from READMEs.

We'll have a libsigrok and a libsigrokdecode release soon. After that,
any API changes must be properly documented and reflected in the
SO version (and package version) numbers of the libs.

srd: Drop ebr30a_i2c_demux in favor of i2cdemux.

The i2cdemux protocol decoder is the more generic version of the
obsolete ebr30a_i2c_demux decoder, and should be able (now or later) to do
everything that ebr30a_i2c_demux can do.

sr/srd: Small fixes, constifications, doc updates.

sr/cli/gtk/qt: Fix package version numbers / docs.

The next (and first) libsigrok release will be called 0.1.0.

The next (and first) libsigrokdecode release will be called 0.1.0.

The next sigrok-cli release will be called 0.3.0 (as we already had a 0.1
and 0.2 release of sigrok-cli; those did not yet use the libs, though).

sigrok-gtk and sigrok-qt didn't have any releases yet, so their version
numbers are set to 0.1.0.

Also, consistently use three numbers/digits for our version numbers.

srd: srd_exit(): Set pd_list to NULL after freeing.

This will ensure that any subsequent checks for pd_list == NULL work
properly.

srd/cli/qt: s/srd_session_feed/srd_session_send/.

srd/cli/qt:s/decoders/decoder/ for consistency.

srd: Constify lots more parameters.

srd: Cosmetics, fix/add Doxygen comments.

srd: Fix typos.

srd: Drop unused ARRAY_SIZE/ARRAY_AND_SIZE for now.

srd: I2C: Update PD protocol docs.

srd: PDs: More cosmetics.

srd: PDs: Use strings for states, too.

srd: PDs: Consistency/cosmetic fixes.

sr/srd: s/handler/callback/.

We should consistently use the same name for the same thing.

sr: Name all callback data 'cb_data'.

sr/srd: Consistency fixes for callbacks.

 - Callback function pointer typedefs end with _t.

 - Variables holding callback functions are named 'cb' everywhere.

srd: I2C: change format to have ACK/NACK bits as separate events

srd: fix SIGROKDECODE_DIR env variable brokenness

srd: properly return status code

srd: PDs: Whitespace and cosmetics.

srd: rename public API functions to srd_thing_action format

srd: don't load all protocol decoders unless we really need to.

srd: last public/private fix, and docs for all publis functions.

srd: finish up public/private API

srd: no public API functions use python-specific arguments now

srd: extra module path can now optionally be passed to srd_init()

Also environment variable SIGROKDECODE_DIR, if present, is prepended
to the module path.

Rename 'void *' callback parameters to 'user_data'.

This is better, both for consistency reasons, and also because 'data' is
a bit too generic and might be confusing, especially since we have other
'data' fields in the code in various places.

srd: Every callback should have a 'void *' parameter.

This is required in various situations and for various lib users,
especially so GUIs which might want to pass specific info via this
mechanism.

Use g_try_malloc/g_free/g_strdup consistently.

Avoid plain malloc()/free() in sr/srd, especially in the API calls.
Also avoid g_malloc*() in favor of g_try_malloc*().

Use g_strdup() instead of strdup() so that we can use g_free()
consistently everywhere.

Exceptions: Stuff that is allocated via other libs (not using glib),
should also be properly free'd using the respective free-ing function
(instead of g_free()). Examples: Stuff allocated by libusb, libftdi, etc.

Also, use sr_err() instead of sr_warn() for actual errors. sr_warn() is
meant for non-fatal/uncritical warnings.

srd: rename all instance to inst

srd: Update README.

srd: s/python/Python/.

srd: Add/improve g_malloc() error messages.

srd: Move private symbols to sigrokdecode-internal.h.

srd: Add/use SRD_API/SRD_PRIV macros.

This is not yet finished, more things should be made private.

srd: Cosmetics, whitespace, coding-style fixes.

srd: More consistent log related function names.

Also, fix typos, constify some parameters, add more Doxygen comments.

Project-wide consistent naming for #include guards.

Document the naming scheme in HACKING.

autogen.sh: aclocal support for Windows XP/Vista/7.

srd: Add explicit srd_pd_output_callback_t typedef.

srd: Properly use append() for appending to lists.

This is not only the canonical way to do it, it's also quite a bit faster
and less memory-intensive than using '+='.

srd: Move all protocol docs to __init__.py files.

srd: spi: Use strings for most options.

srd: uart: Use strings for most PD options.

srd: uart: Move protocol docs to __init__.py.

srd: uart: Add missing initialization.

srd: uart: Use strings for packet types.

While this has a (small) performance penalty compared to using integers,
it has the advantage of not requiring the use of magic numbers which
need to be declared in both the UART decoder and all decoders which
stack on top of UART.

srd: rename extra_probes to optional_probes in all PDs

srd: rename extra_probes to optional_probes

srd: free all decoder instances when unloading decoders

srd: avoid POSIX_SOURCE warning

srd: remove obsolete DDC-only I2C filter

srd: add generic I2C filter PD