colead-slm: fix sloppy driver context handling

HACKING: Document enum setup.

Avoid future ABI breakage by hardcoding enum values.

Whenever we added a field to the enums in libsigrok.h, we were running
the risk of breaking ABI compatibility. Any reordering of existing values
or the addition of entries other than at the bottom of the list would
cause an ABI breakage.

By hardcoding the values we ensure that any added field will have an
unused value, and will not take a value previously used by a different
flag. By doing this, we avoid confusing frontends compiled with an
earlier API.

We use 10000 as the first entry of each enum, and each "category" gets
an explicit number (10000, 20000, 30000, and so on).

Also avoid making the first value of an enum zero. A value of zero is
used as terminator item in some lists.

Remove explicit "DUMMY" (terminator) enum entries, they're not needed.

Signed-off-by: Alexandru Gagniuc <redacted>

serial: Output successful open and the FD.

serial: Fix two segfaults.

serial: Fix some sr_err() items.

genericdmm: Drop left-over entry.

genericdmm: Drop some dead code.

serial: More error-checking & logging, add baudrates.

This mostly affects the non-Windows code so far, the rest will follow.

serial: Add missing "break"s.

This would otherwise cause bugs when e.g. asking for 2 stopbits.

colead-slm: SL-5868P support

add support for sound pressure level measurements

output/analog: add support for sound pressure level

analog: if no MQ unit was set of recognized, just print the value

colead-slm: Initial driver skeleton.

Rework FS9721 parser.

Merge parts of the tekpower-dmm code (the chip of the TekPower
TP4000ZC seems to be an FS9721_LP3 too) and rework parts of the functions.

Adapt the tekpower-dmm and uni-t-dmm code accordingly.

tekpower-dmm: Use generic fs9721 parser

Replace the parser with the fs9721 parser, which is just an adapted
version of this parser.

Signed-off-by: Alexandru Gagniuc <redacted>

Remove 'float' output module.

This has been replaced by the 'analog' output module.

Return SR_ERR_MALLOC upon allocation errors.

Add some TODOs.

Factor out serial_readline() to serial.c.

Only one (slightly different) variant remains in agilent-dmm, this will
be merged soon too, though.

genericdmm/victor-dmm: Use message logging helpers.

radioshack-dmm: Use message logging helpers.

agilent-dmm: Use message logging helpers.

fluke-dmm: Use message logging helpers.

uni-t-dmm: Simplify subdriver setup.

So far, it seems we can make this work with just hw_init() needing to
be subdriver-specific (it will point 'di' to the respective per-subdriver
entry), the rest of the API functions can then use a strcmp() on di->name to
learn which subdriver they belong to.

Draft: Make UT61D and VC-820 "first-class" drivers.

The 'uni-t-dmm' driver/directory will not appear as a "driver" to
frontends anymore, it's just an internal thing.

The frontends will see a uni-t-ut61d and voltcraft-vc820 driver now,
with the correct names and parsers etc. attached to them.

This is not fully finished yet, but it's a start (and works mostly):

  $ sigrok-cli -D
  The following devices were found:
  UNI-T UT61D with 1 probe: P1
  Voltcraft VC-820 with 1 probe: P1

  $ sigrok-cli --driver voltcraft-vc820 -D
  The following devices were found:
  Voltcraft VC-820 with 1 probe: P1

  $ sigrok-cli --driver uni-t-ut61d -D
  The following devices were found:
  UNI-T UT61D with 1 probe: P1

  # Now attaching a UNI-T UT61D device via USB.

  $ sigrok-cli --driver uni-t-ut61d --samples 3 -O analog
  P1: -0.017800 V DC
  P1: -0.017600 V DC
  P1: -0.017700 V DC

  # Now attaching a Voltcraft VC-820 device via USB instead.

  $ sigrok-cli --driver voltcraft-vc820 --samples 3 -O analog
  P1: -0.319200 V DC
  P1: -0.319300 V DC
  P1: -0.319300 V DC

don't use deprecated g_thread_init/_create

require glib version >= 2.32

This allows us to do away with a few deprecated g_thread functions
in demo.c which throw deprecation warnings since glib 2.32.0.

uni-t-dmm: Voltcraft VC-820 draft support.

This is commented out so far, will be implemented properly soon.

Add protocol parser for FS9721_LP3/FS9721B.

The Fortune Semiconductor FS9721_LP3 and FS9721B/Q100 DMM chips are very
similar and the protocol looks identical.

Tested on a Voltcraft VC-820 (FS9721_LP3) with the uni-t-dmm driver
(needs some small changes, tbd).

fluke-dmm: code cleanup

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