input: sr_input_free() is now a void function.

Its backend, input_module.cleanup(), is now also a void function.

input: Add sr_input_end().

This signifies to the module instance no more input will come. This
will cause the module to process any data it may have buffered. The
SR_DF_END packet will also typically be sent at this time.

input: Free instance-private storage at instance free.

input: Add sdi_ready flag to struct sr_input.

When an input module instance has received enough input to fully
populate the struct sr_dev_inst, sdi_ready is set to TRUE and its
receive() method returns immediately. Any remaining received data
is buffered until the next time the function is called.

Removal of sdi->index, step 8: fix victor-dmm

Removal of sdi->index, step 7: fix testo

Removal of sdi->index, step 6: fix sysclk-lwla

Removal of sdi->index, step 5: fix ikalogic-scanalogic2

Removal of sdi->index, step 4: fix trivial sr_dev_inst_new() calls

Removal of sdi->index, step 3: sr_dev_inst_new() calls for input mods

Removal of sdi->index, step 2: remove it from sr_session_load()

Removal of sdi->index, step 1: remove it from headers and helper funcs

saleae-logic16: Use physical USB connection instead of sdi->index

Remove sdi->index from openbench-logic-sniffer and pipistrello-ols

hantek-dso: Use physical USB connection instead of sdi->index

zeroplus-logic-cube: Use physical USB connection instead of sdi->index

C++: handle uint32_t SR_CONF keys which contain key capabilities

This adapts the C++ bindings according to commits 584560f and 5827f61.

fx2lafw: Use physical USB connection instead of sdi->index

Previously, sdi->index was used to tell several identical fx2lafw-compatible
devices apart. This was a bit of a hack, so this patch makes it use physical
device connections instead. They're guaranteed to remain the same even if
the USB device reconnects.

Add sr_packet_copy/_free functions.

These will be used to make a copy of a packet on the session bus,
valid for the duration of the device instance that generated it.

serial: Eliminate serial_read(), serial_write() and SERIAL_NONBLOCK.

std_serial_dev_open: Remove SERIAL_NONBLOCK flag.

All calls in drivers are now explicitly (non)blocking.

scpi_serial: Mark read/write calls nonblocking, remove SERIAL_NONBLOCK.

These calls were already nonblocking. Having marked them as such, the flag can
be removed.

tondaj-sl-814: Remove SERIAL_NONBLOCK flag.

All calls in the driver are now explicitly (non)blocking.

tondaj-sl-814: Mark serial read/write calls as blocking.

These calls are executed from an event handler and were previously nonblocking,
but they have no partial read/write handling. The code is already marked TODO
for improvement.

tondaj-sl-814: Mark serial read call as nonblocking.

This call was already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. Partial reads are handled.

teleinfo: Mark serial read as nonblocking, remove SERIAL_NONBLOCK flag.

This call was already nonblocking due to the flag.

openbench-logic-sniffer: Remove SERIAL_NONBLOCK flag.

All calls in this driver are already explicitly (non)blocking.

norma-dmm: Remove SERIAL_NONBLOCK flag.

All calls in the driver are now explicitly (non)blocking.

norma-dmm: Make serial write call block.

This call is executed from an event handler and was previously nonblocking,
but has no partial write handling. It sends a short packet so should be OK
to block, most likely the output buffer will be empty anyway.

norma-dmm: Make write call block.

This call was previously nonblocking, but has no partial write handling.
It is called in the scan where it is free to block.

norma-dmm: Mark serial read call as nonblocking.

This call was already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. It only reads one byte, and a zero result is handled
appropriately.

motech-lps-30x: Remove SERIAL_NONBLOCK.

All calls in the driver are now explicitly (non)blocking.

motech-lps-30x: Make serial write call block.

This call was previously explicitly nonblocking, but has no partial write
handling. It sends a short packet so should be OK to block, most likely the
output buffer will be empty anyway.

motech-lps-30x: Mark serial read call as nonblocking.

This call was already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. It only reads one byte, and a zero result is handled
appropriately.

mic-985xx: Remove SERIAL_NONBLOCK call.

All calls in the driver are now explicitly (non)blocking.

mic-985xx: Make serial write call block.

This call is executed from an event handler and was previously nonblocking,
but has no partial write handling. It sends a short packet so should be OK
to block, most likely the output buffer will be empty anyway.

mic-985xx: Mark serial read as nonblocking.

This call was already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. Partial reads are handled.

gmc-mh-1x-2x: Remove SERIAL_NONBLOCK flag.

All calls in the driver are now explicitly (non)blocking.

gmc-mh-1x-2x: Make serial write calls block.

These calls are executed from an event handler and were previously nonblocking,
but have no partial write handling. They send short packets so should be OK to
block, most likely the output buffer will be empty anyway.

Fix error handling for some: serial_write can return any negative error code.

gmc-mh-1x-2x: Make serial write call block, and fix error handling.

This call was previously nonblocking, but there is no handling of partial
writes. It is called from config_set where it is free to block.

Also fix error handling: serial_write can return any negative error code,
not just -1.

gmc-mh-1x-2x: Mark serial read calls as nonblocking.

These calls were already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. They only read one byte. A return value of zero is not
handled, but should not occur in theory due to the G_IO_IN check. It might be
good to add handling of a zero return anyway, since I'm not sure if this is
always accurate.

gmc-mh-1x-2x: Mark serial read call as nonblocking.

This call was already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. It only reads one byte, and a zero result is handled
appropriately.

fluke-dmm: Make serial write calls block, and fix error handling.

These calls are executed from an event handler and were previously nonblocking,
but have no partial write handling. They send short packets so should be OK to
block, most likely the output buffer will be empty anyway.

Also fix error handling for these calls, which seems to have been retained from
previous direct usage of write() to a serial port fd.

fluke-dmm: Make serial write calls block, and fix error handling.

These calls were previously nonblocking, but have no partial write handling.
They are made from scan and acquisition_start contexts where they are free
to block.

Remove the SERIAL_NONBLOCK at open, which only applied during scan, since all
calls in the scan are now explicitly blocking.

Also fix error handling for these calls, which appears to have been kept
from a previous direct usage of write() on a serial port fd.

fluke-dmm: Mark serial read call as nonblocking.

This call was already nonblocking since the driver opens the port with the
SERIAL_NONBLOCK flag. Only one byte is read. The case of 0 being returned
is not handled, but the call is only made if G_IO_IN occurred so in theory,
there should be a byte available. It might be wise to add handling for a
return of 0 nonetheless, as I'm not sure if this is always accurate.

conrad-digi-35-cpu: Make serial write call block.

This call was previously nonblocking, but there is no partial write handling.
It is only called from config_set so it is free to block.

conrad-digi-35-cpu: Remove SERIAL_NONBLOCK flag from open at scan time.

This open call is only made to check access, the port is closed immediately
afterwards. The flag therefore has no effect.

colead-slm: Mark serial read calls as nonblocking.

This is an odd one. These calls are made from a receive handler so should not
block, and appear to be setup correctly to handle partial reads or no data
available. However, the driver was not opening the port with SERIAL_NONBLOCK
so these calls would have been blocking. Make them nonblocking.

center-3xx: Remove SERIAL_NONBLOCK flag.

All serial calls in this driver are now explicitly (non)blocking.

center-3xx: Make serial write call block.

This call is executed from an event handler and was previously nonblocking,
but has no partial write handling. It sends a short packet so should be OK
to block, most likely the output buffer will be empty anyway.

center-3xx: Mark serial read call as nonblocking.

This call was already nonblocking because the driver opens the port with the
SERIAL_NONBLOCK flag. Partial reads are handled.

cem-dt-885x: Mark serial access as nonblocking, remove SERIAL_NONBLOCK flag.

These calls were already nonblocking since this driver opened the port with
the SERIAL_NONBLOCK flag. Having marked them as such, we can remove the flag.

Also remove an unnecessary reopen of the port to change its blocking status.

brymen-dmm: Remove SERIAL_NONBLOCK flag.

All serial read/write calls in the driver are now explicitly (non)blocking.

brymen-dmm: Make serial write call block.

This call is executed from an event handler and was previously nonblocking,
but has no partial write handling. It sends a short packet so should be OK
to block, most likely the output buffer will be empty anyway.

brymen-dmm: Mark serial read calls as nonblocking.

The driver opens the port with SERIAL_NONBLOCK so these were already
nonblocking, and are handled appropriately.

atten-pps3xxx: Remove SERIAL_NONBLOCK.

All serial read/write calls in the driver are now explicitly (non)blocking.

atten-pps3xxx: Make serial write call block.

This call is executed from an event handler and was previously nonblocking,
but has no partial write handling. It sends a short packet so should be OK
to block, most likely the output buffer will be empty anyway.

atten-pps3xxx: Make serial write call block in scan.

This is called at scan time so free to block. There is no partial write
handling and a response is expected afterwards. This should therefore be a
blocking call.

appa-55ii: Mark serial read nonblocking and remove SERIAL_NONBLOCK.

This is the only read/write call in the driver. It is already non-blocking
and is handled appropriately.

aglient-dmm: Remove SERIAL_NONBLOCK flag.

All serial calls in this driver are now explicitly (non)blocking.

agilent-dmm: Make serial write call block in send.

This call is executed from an event handler context was previously
nonblocking, however there is no handling for a partial write.

The output buffer is unlikely to be full and the commands to be sent
are short, so it should be OK to make this a blocking call.

agilent-dmm: Make serial write call block in scan.

This call is executed at scan time so is free to block. There is no
handling for a partial write and a response is expected immediately
afterwards. It should therefore be a blocking call.

agilent-dmm: Mark serial read call as nonblocking.

This driver opens the port with the SERIAL_NONBLOCK flag, so this call is
already a nonblocking one, and is handled appropriately.

serial-dmm: Remove SERIAL_NONBLOCK flag.

All serial read/write calls in this driver are now explicitly
nonblocking so there is no need for this flag.

serial-dmm: Mark serial read/write calls as nonblocking.

This driver opens the port with the SERIAL_NONBLOCK flag so these calls were
already non-blocking.

colead-slm: Mark serial write call as blocking.

This driver opens the port without the SERIAL_NONBLOCK flag,
so this call was already blocking.

manson-hcs-3xxx: Mark serial read call as blocking.

This driver opens the port without the SERIAL_NONBLOCK flag, so this call is
already a blocking one.

serial_readline: Implement using sp_blocking_read.

serial_stream_detect: Make read nonblocking.

This code implements its own waiting based on baudrate, so the read itself
should be nonblocking. In general it will have been already, since drivers
almost universally use the SERIAL_NONBLOCK flag.

Add serial_num and connection_id fields to sr_dev_inst

Add usb_get_port_path() helper function

There is currently no way to uniquely identify USB devices in
libsigrok. It uses the "bus.address" scheme which is only
constant as long as the device remains attached to the bus.
In order to allow USB device persistence in PulseView, devices
need to provide a unique identifier even in absence of a
serial number. This function is the first step as it provides
the ability to query the physical location of a USB device.

demo: Fix pattern mode and amplitude option publishing.

colead-slm: Properly check acquisition sample limit.

session: Don't try to send packets if no session has been set.

This indicates a bug, but let's not segfault if it happens.

input/chronovu_la8: Fix broken I/O loop.

Typos and consistency fixes.

yokogawa-dlm: Don't implement dummy scan options.

Publish config key capabilities.

Every driver now publishes its device option config keys, i.e. the
list fetched with sr_config_list(SR_CONF_DEVICE_OPTIONS), with a
set of flags indicating which methods are implemented by the driver
for that key.

The config keys are OR'ed with any combination of SR_CONF_GET,
SR_CONF_SET and SR_CONF_LIST. These are defined as the high bits
of the uint32_t config key. Clients can OR config keys with
SR_CONF_MASK to strip out these bits. This mask will be kept up to
date if other bits are added to the capabilities list; clients MUST
therefore use SR_CONF_MASK for this.

Some keys don't have capability bits added, such as the informative
device type keys (SR_CONF_MULTIMETER, SR_CONF_OSCILLOSCOPE, ...) and
SR_CONF_CONTINUOUS.

Scan options do not have capabilities bits.

beaglelogic: Add missing scan options, and cleanup.

Consistently use 'scanopts' variable across all drivers.

Consistently use 'devopts' variable across all drivers.

Change type of SR_CONF keys to uint32_t.

C++: Make hardware device instances user owned.

bindings: Make documentation script work under python 3.x.

python: fix conversion to string variants.

hwdriver: Validate types of GVariants passed by user.

Use AM_PATH_PYTHON macro to find Python binary.

A specific interpreter can now be passed to configure e.g:

./configure PYTHON=python3

C++: use constructors for default argument declarations.

C++: include <cmath> for NAN.

bindings: Remove 'get_' prefix from all accessors.

scpi: Remove trailing carriage returns.

tests: Fix binary input test.

input: Add debug output.

input/binary: Fix broken I/O loop.

Don't start session with 0-channel devices.

Drivers aren't really able to deal with that in some cases, and it
denotes a frontend bug.

scpi: Don't return NULL device from unsuccessful scan.

scpi-pps: Clean up HP 6632B profile.

configure.ac: Add and use DRIVER2() to shorten file.

configure.ac: Shorten per-driver lines a bit.

configure.ac: Don't duplicate driver name.

The AC_DEFINEs don't need any driver names really, those only end up
as code comments in config.h and are otherwise useless. Thus, don't
duplicate them, we already have the driver names in DRIVER().