Add protocol decoder for Cyrustek ES51919 LCR meter chip.

Add a protocol decoder for the Cyrustek ES51919 LCR meter chip.
This chipset (together with ES51920 front-end) is supposedly used
by multiple different portable LCR meters including at least
DER EE DE-5000, Yihua V&A VA520, Mastech MS5308, Uni-T UT612,
CEM DT-9935 and various OEM rebadges of them.

The communication protocol seems to be implemented on the Cyrustek
chip itself so all the different models are expected to use the
same protocol if they implement a host connection. Unfortunately
the protocol is not available in the public documentation of the
chipset, so this implementation is based on reverse engineering it
from traffic captures.

The actual connection between the meter and the host computer may be
different from meter to meter even when based on the same chip. This
module implements a decoder for the protocol and some common helper
functions for interfacing with the meter via an RS-232 serial port.

Add pretty-printer for new units and flags.

Add support for printing henries and degrees as well as the new
reference and auto flags.

Add config key for output frequency.

Add a config key for getting/setting the output frequency. The value
will be an uint64 and measured in hertz.

Add config key for LCR meter type.

Add a config key that can be used to indicate that the device is
an LCR meter.

Add two new 'auto' flags.

Add flags for indicating that the meter has selected the measured
quantitiy and/or the used measurement model automatically. These
are similar to the existing auto-range flag.

Add quantity and flag for difference measurements.

Add 'SR_MQ_DIFFERENCE' quantity for reporting relative difference
between the current measurement and the reference value. The value
of this quantity will normally be reported in percents. Add also
the flag 'SR_MQFLAG_REFERENCE' for indicating that the reported
value is not the current measurement but the reference value instead.

Add measured quantities for LCR meters.

Add parallel and serial model inductance, capacitance and resistance
for LCR meter measurements. Add also secondary quantities many LCR
meters calculate, namely dissipation factor, quality factor and phase
angle.

Add two new units.

Add degrees and henrys to the list of supported units. Degree is
an unit of plane angle where one degree is 1/360th of a full circle.
Henry is the SI unit of inductance.

README: Bump glib version to 2.34.

usb: Simplify usb_get_port_path() and fix writing into a const char *.

Fix sr_dev_has_option().

This wasn't taking the SR_CONF_GET/_SET/_LIST flags into account.

Thanks to Janne Huttunen for spotting this.

build: Require glib 2.34.

ols: Fix serial port timeout.

colead-slm: Fix serial port timeout.

bindings: Better error handling in enumeration get() function.

Prior to this patch a call to get() with an invalid enumeration value
would raise an exception that would, for example, terminate the python
interpreter, whereas now the exception is handled and translated into a
proper python exception.

atten-pps3xxx: Use serial_timeout().

serial: Add serial_timeout().

This calculates a proper timeout value for blocking writes on the
given serial port, for the given number of bytes. Timeout is based
on a fixed 10ms OS overhead, baud rate, data bits and stop bits.

atten-pps3xxx: Fix serial port timeout.

fluke-dmm: Fix blocking serial write timeout.

agilent-dmm: Fix blocking serial write timeout.

input/csv: Fix size_t printing.

unit tests: Fix build due to recent changes.

Add a configurable read timeout to blocking SCPI reads, default 1s.

Add some Agilent USBTMC PIDs.

Add a timeout parameter to blocking serial calls.

Set this new parameter to 0 (no timeout) at every call site. This is
consistent with previous behaviour, so cannot cause any regressions.

Waiting forever for a serial operation is clearly always wrong. Without
specific knowledge of each device and driver however, I can't choose
appropriate timeouts for each call. The maintainers of these drivers
will need to do so, and also add appropriate handling of timeouts.

When this commit is merged, a bug should be entered for each driver
that is touched by it.

Avoid serial_write_blocking() warnings.

Fix similar broken error handling on several serial calls.

kecheng-kc-330b: Fix missing time/frequency weighting.

hantek-dso: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

demo: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

fluke-dmm: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

chronovu-la8: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

asix-sigma: Trigger code cleanup.

This cleans up a warning generated by clang's static analyzer.

agilent-dmm: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

scpi/vxc: Avoid NULL dereference.

This cleans up a warning generated by clang's static analyzer.

input/csv: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

input/chronovu_la8: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

input/binary: Code cleanup.

This cleans up a warning generated by clang's static analyzer.

input: Avoid NULL dereference.

This cleans up a warning generated by clang's static analyzer.

sr_parse_sizestring: Deal with invalid strings better.

This cleans up a warning generated by clang's static analyzer.

Clean up sr_session_load().

This cleans up some warnings generated by clang's static analyzer.
The function now also returns SR_ERR to signify the specified filename
does not point to a valid session file.

Other SR_ERR_* returns indicate a session file was found, but loading
failed.

Return sensible Device::description() for session and input devices.

C++: Fix management of SessionDevice objects.

C++: Add spaces in Device::description().

C++: Expose device serial number and connection ID.

C++: Expose config key capabilities.

bindings: Update for input API changes.

Clean up internal input API docs.

input: Use SR_ERR_NA instead of SR_OK_CONTINUE.

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.