ols: Do not randomly probe serial ports

ols driver used to probe a series of available serial ports obtained
by regexp matching of common serial port names.
There are a number of problems with this approach:
1. It will probe all serial devices, including devices that do not
like to be probed, potentially causing them to act up.
2. It will try to probe serial ports which may already be opened in
other applications for other purposes.
3. It assumes the naming of the serial ports is set in stone, and
creates an unnecessary OS-specific list.
4. It produces unnecessary debug output even when an OLS device is
not connected.
5. etc...

Do not implicitly probe serial ports. Only probe the port specified
by the frontend, if any; otherwise, just quit.
Also get rid of all functionality in serial.c which was designed
specifically for random probing.

Signed-off-by: Alexandru Gagniuc <redacted>

comment fix

link-mso19: Use message logging helpers.

demo: Use message logging helpers.

hantek-dso: Use message logging helpers.

asix-sigma: Use message logging helpers.

radioshack-dmm: Use new file naming conventions.

radioshack-dmm: Move some stuff out of .h file.

Most of the enums and #defines are not needed in multiple files, just
put them in the respective .c file where they're used.

radioshack-dmm: Cosmetics, coding-style, cleanups.

Also, drop some uneeded code and simplify some parts.

serial: Deduplicate log messages a bit.

Add initial Tondaj SL-814 protocol handling.

tondaj-sl-814: Initial driver skeleton.

agilent-dmm: use standard serial_readline()

serial_readline() now terminates on and strips CR and/or LF

g_get_monotonic_time() takes a signed int64

agilent-dmm: no need to specify a serialcomm scan parameter

It's always 9600/8n1 anyway.

chronovu-la8: not a bug if an unused driver gets asked to clean up

victor-dmm: add protocol decoder

more deconstifying sr_dev_inst for dev_acquisition_stop()

victor-dmm: add basic USB driver skeleton

allow for intermediate stage in stopping acquisition

In the case of USB drivers, a driver's dev_acquisition_stop() cannot
simply remove its fd sources from the session and close its devices:
a USB transfer might still be underway, and it needs to be finished
(and its memory freed) properly.

An sr_dev_inst->status value is added: SR_ST_STOPPING, which should
be set when the driver's dev_acquisition_stop() is called, and acts
as a marker for the USB event handler to wind up its operations.

In order for dev_acquisition_stop() to be able to set the sdi status,
however, it needs to be unconstified.

victor-dmm: Initial driver skeleton.

zeroplus-logic-cube: Fix samplerate and trigger

 - Default to 1MHz.
   The default sample rate is the lowest frequency (100Hz),
   but it takes a very long time until 128K memory is full.

 - Fix the 1MHz setting.

 - Use samplerate list.

 - Fix 10MHz frequency.

 - Fix trigger.

 - Change the size of memory according to the number of samples.

 - Add pre-trigger (capture ratio) setting.

 - Fix the first acquisition after power on.

uni-t-dmm: Use new USB helper functions.

genericdmm: Factor out USB functions.

Move sr_usb_connect() and sr_usb_open() to hardware/common/usb.c in a
slightly more generic form and add more error checks and logging.

Let genericdmm use the new/moved functions.

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.