Fluke 287/289: support for dBu/dBV measurement units

Initial support for UNI-T DMMs.

This is not yet fully finished, but works for most use-cases.

Tested with a UNI-T UT61D using the UT-D04 USB/HID cable (new version).

la8: Rename driver.[ch] to protocol.[ch].

la8: Adapt to new driver conventions.

configure.ac: Cosmetics.

tekpower-dmm: Cosmetics, coding-style, consistency fixes.

Add support for the TekPower TP4000ZC DMM.

Also known as Digitek DT4000ZC.

Signed-off-by: Alexandru Gagniuc <redacted>

HACKING: "Adding a new hardware driver" chapter.

.gitignore: (Trivial) Ignore KDevelop project files

Signed-off-by: Alexandru Gagniuc <redacted>

configure.ac: Small consistency fixes.

config.h usage cleanups.

 - Drop config.h #include from files that don't actually use any of
   its contents (at the moment).

 - Add comment for those that do need it.

Doxygen: Explain init/shutdown, add small example.

Doxygen: libsigrok.h: Explain #include file usage.

Doxygen: Various fixes in libsigrok.h.

Doxygen: Add @file items for the relevant files.

These short descriptions are shown in the "Files" section of the
Doxygen output.

Doxygen: Fix grouping of session_file.c functions.

s/@ingroup/@addtogroup/ and s/grp_device/grp_session/.

Doxygen: TODO cleanup, use @todo where needed.

Turn TODOs which should be user-visible into @todo so that Doxygen
shows them in the function docs, and also on the special "Todo List" page.

Those TODOs that should not be in the Doxygen docs are moved out of the
/** */ comment blocks.

Also fix some comments/items, and remove some obsolete ones.

Doxygen: Various improvements in libsigrok.h.

 - Turn SR_OK/SR_ERR_* and SR_LOG_* into proper enums.

 - Use /**< Foo. */ for Doxygen comments that are on the same line as
   the (e.g.) enum entry they document. If the comment is not on the
   same line (but rather directly above the enum entry) a simple
   /** Foo. */ comment is sufficient.

 - Use /** */ instead of /* */ in some places, so that Doxygen actually uses
   the respective comments.

 - Various smaller cosmetic fixes or cleanups.

Doxygen: Fix a bunch of warnings and outdated docs.

Doxygen: Move error handling stuff to error.c.

Also, add an overview mini-section to the main page instead.

Doxygen: Initial groups and topic short descriptions.

Doxygen: Mark non-public stuff for exclusion.

 - /** @private */ can be used for functions, and /** @cond PRIVATE */ and
   /** @endcond */ for variables or #defines.

 - Document the above in HACKING.

Doxygen: Add initial main page documentation section.

Doxyfile: Various additions/improvements.

 - Show a short project description, the libsigrok version (x.y.z or
   "unreleased development snapshot"), and the sigrok logo in the
   Doxygen output.

 - Ignore a bunch of files and directories which don't contain public
   libsigrok API anyway.

 - Remove the SR_API prefix from the Doxygen output (all
   functions/symbols in the output are part of the public API anyway).

 - Various changes of settings to get nicer and more useful output.

Doxygen: Add sigrok logo PNG for use by Doxygen.

Doxyfile: Update to what doxygen 1.8.1.2 generates.

The new version has a number of neat improvements/features we could use.

Makefile.am: Add missing backslash.

backend.c: Revert accidentally committed test code.

clean up autoconf/autobuild scripts

We now require libusb >= 1.0.9.

This is due to the use of libusb_error_name().

sr_init/sr_exit: Improve docs, add error checks.

Add and init libusb_context * in struct sr_context when using libusb-1.0

This allows hardware drivers to use a common libusb_context.

Add a struct sr_context * parameter to sr_init() and sr_exit()

Move 'struct drv_context' to sigrok-internal.h.

It's not meant to be visible to frontends.

radioshack-dmm: Implement support for "LOGIC" mode

LOGIC mode sends the following data:
     V < 0 : actual voltage
0 <= V < 1 : LOW
1 <= V < 2 : actual voltage
2 <= V     : HIGH

We follow the same idea, and set our unit to BOOLEAN for the crazy
case (HIGH or LOW).

Signed-off-by: Alexandru Gagniuc <redacted>

libsigrok: (Trivial) fix packet type in datafeed_dump

datafeed_dump would print SR_DF_META_LOGIC when a SR_DF_META_ANALOG
was recieved. Fix that.

Signed-off-by: Alexandru Gagniuc <redacted>

libsigrok: (Trivial) Add support for 2400 baud

Signed-off-by: Alexandru Gagniuc <redacted>

add SR_HWOPT_* documentation

fluke-dmm: add support for Fluke 187

analog: add pretty-printer for dBu and dBV

add SR_UNIT_DECIBEL_VOLT (dBu)

analog: sane printing of very small and negative values

HACKING: Cosmetics.

Build fix for Windows/MinGW.

On Window/MinGW 'recv' seems to be already defined in some headers.
Use 'receive' instead, for now.

Re-add HACKING file after repo split.

radioshack-dmm: (Trivial) Convenience fixes

While testing the new radioshack-dmm driver with pulseview, I found
a few inconvenients.

1. Print an info message when a port is probed, and when a device is
found. This makes it easy to tell if and where the driver is looking.

2. num_samples was not reset after the first aquisition, so the
second aquisition would quit right away. Reset num_samples at start
of a new aquisition.

3. There's no need to  open the serial port RW, so change O_RDWR to
O_RDONLY when opening the port.

These changes are too trivial to split into different patches.

Signed-off-by: Alexandru Gagniuc <redacted>

radioshack-dmm: build fixes

radioshack-dmm: Add support for Radioshack 22-812 DMM

Signed-off-by: Alexandru Gagniuc <redacted>

libsigrok.h: Add measured quantity and units used by Radioshack 22-812

The Radioshack 22-812 can measure parameters such as transistor gain,
dbm, etc. Add those to libsigrok.h.

The SR_UNIT_UNITLESS is for quantities that do not have units. Any
ratio or gain are just factors, whic do not have units. Specifically,
a transistor's gain, or hFE, is a unitless quantity.

Signed-off-by: Alexandru Gagniuc <redacted>

serial: (Trivial) add support for 4800 baud

Signed-off-by: Alexandru Gagniuc <redacted>

.qitignore: Ignore KDE backup files

*.kate-swp files can become annoying, so ignore them.

Signed-off-by: Alexandru Gagniuc <redacted>

analog: support AC+DC unit modifier

don't accept numbers as probe identifiers in trigger string

Only the probe name, as supplied by the device driver, is accepted.

Quick workaround for g_match_info_unref().

README: Add status, update URL, small fixes.

updated URLs and description

restore pre-split ignores

sr: struct drv_context is global now.

fluke-dmm: support for all basic 287 functionality

sr: add support for conductance measurements in Siemens

sr: add support for pulse width measurements

fluke-dmm: definitely use CR as line terminator

fluke-dmm: add Fluke 287 to supported list

sr: always turn off ICRNL on serial ports

It does rather screw with protocols that use CR.

fluke-dmm: flesh out the driver API

fluke-dmm: auto-discover serial bitrate if not provided

fluke-dmm: don't log anything if no conn params given

fluke-dmm: fix discovery

sr: turn off canonical mode and echo ion serial ports by default

fluke-dmm: build fixes

fluke-dmm: basic scan functionality

fluke-dmm: initial driver skeleton

agilent-dmm: don't log anything if no conn params given

sr: make struct drv_context global

fx2lafw: use default libusb context

hantek-dso: use default libusb context

sr: enable genericdmm and agilent-dmm drivers by default

agilent-dmm: fix model identifiers

agilent-dmm: tentative support for all U123x and U125x models

Only tested on U1233A, but it just might work.

The U125x protocol decoding only supports voltage, current, resistance,
capacitance and diode measurements for now.

agilent-dmm: code cleanup

This should make it easier to support other Agilent U12xx models

agilent-dmm: fix AC/DC mode detection

agilent-dmm: make parser deal with input better

agilent-dmm: remove IDN check at 1Hz, we just don't need it.

Some debug message cleanup.

sr: add new analog output module

This outputs text representation of SR_DF_ANALOG packets. Unlike the
float module however, it also outputs the standard abbreviations of
SI units corresponding to the packet's MQ and unit.

It also makes an effort to multiply or divide the floating point value
as needed to the nearest multiple or fraction, and inserts the
appropriate SI prefix to match.

agilent-dmm: support for submodes

sr: add recv/cleanup calls to output module API

The new output module callbacks will be init, recv and cleanup. The
existing data  and event callbacks still work, but will be phased out
as existing modules get converted.

The recv() callback gets a copy of every packet on the session bus,
and thus has visibility of all metadata, allowing it to properly
output any acquired data.

genericdmm/victor-70c: fix resistance and frequency measurements

sr: Refactored sr_samplerate_string into a more general function: sr_si_string_u64

sr: session_driver: Remove source on completion

Remove the session source once we are done loading the file, otherwise we'll
spin forever in sr_session_run.

Reported-by: Joel Holdsworth <redacted>
Signed-off-by: Lars-Peter Clausen <redacted>

sr: output up to 12 significant digits for floats

generic-dmm: cosmetics

genericdmm/victor-70c: warn if detaching kernel driver fails

sr: mostly finished Agilent DMM driver

serial: add serial_set_paramstr()

serial: fix flow control setting

serial: set speed in both directions

sr: add new agilent-dmm driver (Agilent U12xxA multimeters)

genericdmm: Victor 70C multimeter support

genericdmm: finish basic USB support

sr: corrected VID for Victor 70C