cli: code cleanup

cli: use probe numbers starting from 0

cli: change to new struct sr_dev_inst based libsigrok API

cli: remove dead code

cli: add --show option, and switch to new info_get driver API

cli: add --driver option, and switch to new sr API scanner

cli: more flexible generic arg parser

Allow setting samplerate when reading binary files

I had a binary file that I needed to decode using UART decoder. UART
decoder needs to know the sample rate for the data, but currently it's
not possible to pass parameters to input formats and so the "binary"
file format always sets the samplerate to 0.

This patch adds the possibility to append a colon-separated list of
key=value options to the -I argument, in the same way -d supports it.
Also, it makes the "binary" format support the "samplerate" option.

I included the GHashTable containing input format options directly in
the sr_input struct. I'm not sure if that's the right way to do it. I
saw that -d uses a much more elaborate system with device capabilities
and typed options, but that seemed like an overkill for input formats.

cli: Use sr_session_stop() instead of sr_session_halt()

Use sr_session_stop() instead of the deprecated sr_session_halt().

Signed-off-by: Lars-Peter Clausen <redacted>

cli: switch to new <libsigrok/libsigrok.h>

cli: flush output on write

cli: Fix typo in protocol decoder stacking example

Probe assignments are separated by colon and not by comma.

Signed-off-by: Lars-Peter Clausen <redacted>

sr/srd/cli: require glib version >= 2.28

Needed for g_get_monotonic_time(). Thanks to Tomaž Šolc.

cli: Add missing fflush(stdout) for PD annotation output.

This is required/helpful to be able to pipe sigrok-cli PD output into
other tools, like this:

  sigrok-cli -i ... -a ... | othertool

cli: use output API for analog and frame begin/end packets

cli: not doing sigrokdecode directly from analog data

It's just a completely different can of beans.

cli: output API says to check data_out, not length_out

cli/gtk/qt: Now all require libsigrok >= 0.2.0 (API changes).

cli: strip off PD arguments before selecting for annotation

This fixes the bug where -A didn't work if the PD in question had arguments.

sr: Made hwcap const

cli: support for SR_HWCAP_COUPLING

cli: support SR_HWCAP_VDIV and the new SR_T_RATIONAL_VOLT type

cli: use SR_T_RATIONAL_PERIOD

cli: support for SR_HWCAP_FILTER and SR_DI_FILTERS

cli: parameter support various new HWCAPs and types

cli: support for frames, and limiting capture by number of frames.

cli: use SR_DF_META_*, support for analog packets

cli: configure.ac: Bump version number to 0.3.1.

cli: Constify a few char *pointers.

cli: Update NEWS in preparation of 0.3.1 the release.

cli: Cosmetic fix for --help output.

cli: Fix compile error.

cli: Make --protocol-decoder-annotations plural.

This option supports (will support) multiple annotations from multiple
PDs, as well as multiple annotation formats per PD, so use plural.

cli: Add -A (alias for --protocol-decoder-annotation).

cli: manpage cosmetics, updates.

sr/srd/cli/gtk: ChangeLog -> MAINTAINERCLEANFILES.

If the (generated) ChangeLog file is marked for DISTCLEANFILES, it'll be
removed whenever "make distclean" is called (and is then gone forever if
you use the tarballs, for example).

cli: Output which file format was autodetected.

document --protocol-decoder-annotation, and note PD stack is optional.

cli: factor out output format setup

main() is now clean.

cli: option to specify which annotation(s) to show

Also factor out PD stack setup, and remove redundant error messages.

cli: stop immediately if SRD PD registration fails

cli: loose string comparison helper

cli: always show G_LOG_LEVEL_CRITICAL messages

cli: cosmetics

cli: halt session if SRD session fails to initialize

cli: only output module or PD goes to stdout, everything else to stderr

cli: removed obsolete debugging, setup for proper stderr logging

cli: no need to specify stacking order if it's the same as the PD list

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.

cli: Print required/optional probes info.

When running 'sigrok-cli -a uart' (for example), we now additionally
print which required/optional probes the decoder needs.

cli: -V: Print protocol description upon "-l 3" or higher.

Fix bracket placing

Make it consistent with the rest of the code

Signed-off-by: Thomas Jarosch <redacted>

cli: Generate ChangeLog upon 'make dist'.

cli: New 0.3.0 release.

Document the major user-visible changes in the NEWS file.

cli: Show sr/srd versions determined at run-time.

cli: NEWS: Add 0.1.0/0.2.0 release docs.

cli: Add (almost) empty NEWS file.

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

sr: out: Use uint8_t (not char) for buffers.

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

cli: Fix -V/-h output a bit.

Options and their defaults should not be documented there, but rather in
the manpage or such.

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.

sr/cli: s/patternmode/pattern/ in a few places.

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

cli: Same order for params in manpage and -h.

cli: manpage: Document -l, -a, and -s.

Also, update list of supporter input/output formats.

cli: Fix/update manpage a bit.

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

sr: Rename -f|--format to -O|--output-format.

This is done for consistency with the -I|--input-format option. We now have:

-i|--input-file
-o|--output-file
-I|--input-format
-O|--output-format

sr: Name all callback data 'cb_data'.

sr/cli/gtk/qt: s/hw/driver/ in some places.

sr: s/sr_dev_probe_name/sr_dev_probe_name_set/.

sr/cli/gtk/qt/: s/plugin/driver/.

sr: sr_samplerate_string: Allow 3.15Hz etc. as output.

This is required for some hardware, e.g. ChronoVu LA8, where
33.333333 MHz or 2.439024 MHz are valid samplerates. This is because the
hardware takes a sampleperiod (in nanoseconds) as input, not a
samplerate (in Hz).

sr: No need for dynamic hardware driver registration.

We don't need or allow run-time registration of hardware
drivers/plugins, they're added at compile-time.

cli/gtk/qt: nsis: Better installer filename.

cli: nsis: Hook up to "Add/remove programs".

sr: s/config_set/dev_config_set/.

This functions is per-device-instance, so use dev_ as prefix as with
the other ones.

sr/cli/gtk/qt: s/configuration/config/.

sr/cli/gtk: s/capability/hwcap/.

sr/cli/gtk: A few more s/instance/inst/.

sr/cli/gtk/qt: s/device/dev/ in many places.

Also, a few s/instance/inst/ occurences.

sr: rename all sr_hwplugin(s)_* functions to sr_hw_*

srd: rename public API functions to srd_thing_action format

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

sr: rename more functions to sr_thing_action format

Also improved the interface to find capabilities in a hardware plugin.

sr: rename hwplugin functions to sr_thing_action format

sr: rename all sr_device_* functions to sr_dev_*

sr: more API cleanup and documentation

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

sr: Implement proper logging framework.

This is pretty much identical to the current libsigrokdecode API/framework.

srd: More consistent log related function names.

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

cli: nsis: Fix copy-paste error.

cli: nsis: Start menu shortcut (opens a "DOS box").

Add missing logo icon files for Windows installers.

nsis: Install missing msys-1.0.dll and msys-z.dll.

Thanks John-Eric Kamps ("MockUp") for testing on a pristine
Windows 7 (64 bit).