Doxygen: Add @since markers.

Add @since tags to some (not all yet) public API functions, to document
in which release they were added (and/or in which release there were
API changes).

Document the @since usage in HACKING.

Also, add Doxygen docs for the functions in version.c.

swig: wrap g_variant_new_uint64.

swig: include cdata interface.

swig: add function to cast from void * to struct sr_datafeed_logic *

python: support datafeed callbacks implemented in python.

swig: use standard wrappers for integer types.

Add a void *cb_data parameter to datafeed callbacks.

drivers: return SR_ERR_NA on unsupported config key

Fixes bug 89.

Python bindings: Fix reported libsigrok version.

Use 'pkg-config --modversion libsigrok' to get the libsigrok package
version. 'pkg-config --version libsigrok' ignores the argument and just
reports the version of pkg-config itself.

Python bindings: Cosmetics.

Tell SWIG that gpointer is really void *.

Add SWIG interface file and build script for Python bindings.

ols: Report when a device doesn't support metadata

Not an error, but it does mean it's either a really old or really
basic device, and will help us to debug people's problems with
these.

Fixes bug 92.

fx2lafw: Support conn scan parameter

This takes a USB specification. Fixes bug 82.

usb: Fix bus.address format detection

ols: Allow configuration before the device is opened

rigol-ds1xx2: Don't assume there's a valid sdi

ols: Properly initialize operational state before start

demo: Fix compiler warning, cosmetics.

lascar-el-usb: Use two probes for temp/humidity loggers

demo: Unref the IO channel when it is no longer used

demo: Free dev_contexts

demo: Moved demo configuration variables into dev_context

session: Make sr_session_stop thread-safe

With the sigrok session running in a worker thread, if sr_session_stop is called
from another thread, it shuts down the pollfds used by the hardware drivers,
without ensuring that the sigrok event loop is no longer using those pollfds.

On the demo driver, this involves shutting down the GIOChannels, causing a
segfault when the sigrok event loop tries to use them. This is evident when
using the Stop button in PulseView, while the session is running.

This isn't a problem with just the demo driver; any driver's resources may be
freed by sr_session_stop concurrently with the sigrok session running.

To solve this problem, we don't touch the session itself in sr_session_stop().
Instead, we mark it for decommissioning and return. The session polls this flag,
and shuts itself down when requested.

This fixes bug 4.

Signed-off-by: Alexandru Gagniuc <redacted>

demo: Keep a pointer to dev_context in sr_dev_inst and vice-versa

demo: Only one GIOChannel is needed

demo: Fixed glitching in increment signal

alsa: Set the probe index

zeroplus-logic-cube: add USB ID for LAP-16128U

rigol-ds1xx2: support digital channels.

rigol-ds1xx2: doesn't actually support SR_CONF_LIMIT_SAMPLES

rigol-ds1xx2: fix handling of partial frames.

ignore test leftovers

ols: Support get/set/list on all device options

Where it makes sense: _LOGIC_ANALYZER and _TRIGGER_TYPE don't have much
use for all of them.

rigol-ds1xx2: Use g_usleep() for portability

Bump glib requirement to >= 2.32.0.

This is now required, e.g. due to the usage of g_variant_new_fixed_array().

rigol-ds1xx2: Whitespace, minor fix.

Return SR_ERR_MALLOC for failed malloc, not SR_ERR.

unittests: Adapt to new GVariant system.

Fix two minor compiler warnings.

output/vcd: Use selected probes, not lowest-numbered ones

Thanks to Andrew Bardsley for the patch.

rigol-ds1xx2: Support for all channels, proper defaults

Since this driver supports devices with a control panel and display,
we take the defaults from the device -- not a set of sensible
defaults as usual.

rigol-ds1xx2: fix channel numbers

Copyright bump, too.

rigol-ds1xx2: better debugging

rigol-ds1xx2: properly send frame begin/end packets

hantek-dso: Support SR_CONF_NUM_TIMEBASE/SR_CONF_NUM_VDIV

rigol-ds1xx2: Support SR_CONF_NUM_TIMEBASE/SR_CONF_NUM_VDIV

Add SR_CONF keys to report the number of timebases and vdivs

Number of timebases is needed to properly interpret a frame's worth
of samples. Number of vertical divisions isn't, but may nevertheless
be interesting for a frontend that wants to reproduce the scope's
native display.

use driver callbacks directly

rigol-ds1xx2: SR_CONF_TIMEBASE and _VDIVS lists are now an array of tuples

return SR_ERR_ARG if a driver doesn't implement sr_config_*()

Add Rigol DS1052E/1102E VID:PID

hantek-dso: SR_CONF_TIMEBASE and _VDIVS lists are now an array of tuples

hantek-dso: move buffer sizes to device context

There are only two sizes for every device: 10k and the complete
per-channel buffer size. This can be doubled if one channel is disabled.

ols: Get rid of gcc warnings

chronovu-la8: Adjust to GVariant-based sr_config_* functions

tondaj-sl-814: Adjust to GVariant-based sr_config_* functions

uni-t-dmm: Adjust to GVariant-based sr_config_* functions

serial-dmm: Adjust to GVariant-based sr_config_* functions

rigol-ds1xx2: Adjust to GVariant-based sr_config_* functions

mic-985xx: Adjust to GVariant-based sr_config_* functions

link-mso19: Adjust to GVariant-based sr_config_* functions

brymen-dmm: Adjust to GVariant-based sr_config_* functions

asix-sigma: Adjust to GVariant-based sr_config_* functions

alsa: Adjust to GVariant-based sr_config_* functions

zeroplus-logic-cube: fix samplerate setting

sr_voltage_string(): deprecate struct sr_rational

zeroplus-logic-cube: Adjust to GVariant-based sr_config_* functions

nexus-osciprime: Adjust to GVariant-based sr_config_* functions

agilent-dmm: Adjust to GVariant-based sr_config_* functions

victor-dmm: Adjust to GVariant-based sr_config_* functions

fluke-dmm: Adjust to GVariant-based sr_config_* functions

colead-slm: Adjust to GVariant-based sr_config_* functions

lascar-el-usb: Adjust to GVariant-based sr_config_* functions

hantek-dso: Small debug fix

hantek-dso: deprecate struct sr_rational

input/vcd: deprecate struct sr_rational

sr_parse_(period|voltage): deprecate struct sr_rational

demo: Adjust to GVariant-based sr_config_* functions

hantek-dso: Adjust to GVariant-based sr_config_* functions

struct sr_samplerates is now obsolete

sr_config_get() of SR_CONF_SAMPLERATE now returns a GVARIANT_TYPE_DICTIONARY.
This dictionary contains a single key-value pair. Possible values for the key:

 - "samplerates": the value is an array of GVARIANT_TYPE_UINT64 representing
   all valid samplerates.
 - "samplerate-steps": the value is an array of GVARIANT_TYPE_UINT64 with
   exactly three members, which represent the lowest samplerate, highest
   samplerate, and the minimum step, respectively.

ols: allow for disabling of RLE as well

ols: Adjust to GVariant-based sr_config_* functions

fx2lafw: Adjust to GVariant-based sr_config_* functions

Add SR_CONF_TRIGGER_TYPE config_info list

input/output modules: Adjust to GVariant-based sr_config_* functions

Add sr_config_free()

Due to struct sr_config now containing a GVariant, this needs to be
cleaned up after use properly. This is a helper function for that.

Adjust to GVariant-based sr_config_* functions

Use GVariant for sr_config_*() functions

sr_config_get() provides a GVariant owned by the caller, so it must be
released with g_variant_unref() when done.

sr_config_set() takes a GVariant from the caller which may be floating;
it will be properly sunk and release after use by this function. Thus
the output of g_variant_new_*() may be used as an argument.

sr_config_list() also provides a GVariant owned by the caller, to be
unreferenced when done.

sr_config_make() can take a floating reference.

Bump copyright year

configure.ac: Fix checks for cross-compiles.

When checking architecture-specific things, always check $host, i.e. the
architecture we're building _for_, not the one we happen to build _on_.

E.g. when cross-compiling _for_ Android (or Windows or others) it's important
to check for Android in $host; whether we happen to cross-compile _on_ a Linux
or Windows or OpenBSD or FreeBSD machine ($build) doesn't matter, only the
fact that we compile _for_ Android is important for most checks.

vcd output: Build fix for Windows/MinGW.

On Windows/MinGW 'recv' seems to be already defined in windows.h/winsock2.h.

Use 'receive' instead, for now, otherwise we get an error:

vcd.c:147:17: error: conflicting types for 'recv'

configure.ac: Print $host and $build.

In the configure summary at the end also print the architecture we're
building on ($build) and the target host we build for ($host). The two are
not necessarily the same, e.g. in the case of cross-compiles.

configure.ac: Mention required lib versions.

In the summary output at the end of a configure run, explicitly mention
which versions of which libraries are required, and also the version which
pkg-config has found.

configure.ac: Only enable rigol-ds1xx2 on Linux.

configure.ac: Cosmetics for the list of drivers.

Use the canonical driver name (all-lowercase, e.g. "serial-dmm") in the
list of enabled/disabled drivers that configure prints after a run.

It's common to many drivers that they support multiple devices, so
printing one device name (e.g. "ChronoVu LA8") is seldom really correct.
E.g. the agilent-dmm, asix-sigma, brymen-dmm, colead-slm, fluke-dmm,
fx2lafw, hantek-dso, lascar-el-usb, mic-985xx, openbench-logic-sniffer,
rigol-ds1xx2, uni-t-dmm, victor-dmm, and zeroplus-logic-cube drivers
all support more than just one device.

So, just print the driver name instead which is more correct anyway
since it's specifically a list of enabled/disabled drivers.

configure.ac: Improve a libusb-1.0 related check.

Don't rely on the "heuristic" that 'libusb_CFLAGS' will be non-empty if
libusb-1.0 was found, but rather use the proper method of checking the
variable 'have_libusb1_0' which pkg-config will set to "yes"/"no"
depending on whether it finds the library.

configure.ac: Improve USB/EZUSB/serial checks.

 - If libusb-1.0 is not found, do not compile in ezusb.c and usb.c since
   they require libusb.h. The respective hardware drivers that use
   libusb-1.0, and usb.c and/or ezusb.c will be excluded from the build
   elsewhere in configure.ac. Rename NEED_EZUSB to NEED_USB.

 - Drop the NEED_SERIAL check and always compile in serial.c. This is a
   very small chunk of code, it does not depend on any external
   libraries that might be missing, and it compiles on all architectures.
   Thus there's no need to conditionally include or exclude it.

configure.ac: Fix the order of some entries.

In order for lib autodetection and disabling of drivers (which require
libs that cannot be found) to work, the order of AC_ARG_ENABLEs,
AM_CONDITIONALs, and AC_DEFINEs needs to be changed.

All drivers start out enabled or disabled (depending on whether
the --disable-drivers option was supplied or not). Then, any driver can
be enabled or disabled explicitly via --enable-<drivername> or the
resp. --disable-<drivername> option. Finally, pkg-config checks for all
libraries are performed, and all drivers which require a library that
cannot be found are disabled explicitly (regardless of any
--enable-<drivername> option that might have been supplied).

configure.ac: Improve pkg-config related checks.

Until now, we checked for certain (optional) libraries via pkg-config and
the configure script would abort if any of them was not found, even
though they were optional. It was up to the user to then figure out which
combination of --disable-<drivername> switches were required for his
specific OS (and set of installed libs) to get a working configure run.

Only if the user already specified enough --disable-<drivername>
switches beforehand, so that all drivers which require a missing library
were disabled, would the configure run not check for that specific lib
(and would thus not fail).

With this change, we now always unconditionally check for all libs
(required and optional) via pkg-config. However, whether an (optional) lib
is found or not, configure will not abort. Instead, it'll just disable
all drivers which need a lib that cannot be found.

The user will no longer have to supply --disable-<drivername> parameters
in order to get a working build.

Fix kernel driver attached check

The check is really only broken on darwin, but useful on all other
platforms, even if only Linux can actually detach a driver.