Add YiXingDianZi MDSO firmware support.

Bump required sdcc version to >= 3.4.0.

There is an issue with some sdcc versions that causes problems, e.g. only
the first scan for an FX2 device succeeds, the second one yields
LIBUSB_ERROR_PIPE (see bug #1326).

Recent tests have shown that sdcc 3.3.0 produces broken fx2lafw firmware
files, and sdcc 3.1.0 errors out during the build. Versions 3.4.0, 3.5.0,
3.6.9, and 3.8.0 (for example) all seem to work fine.

Thus, increase the minimum required sdcc version to 3.4.0.

This fixes bug #1326.

sainsmart-dds120: make the "1kHz" reference signal 1kHz

configure.ac: Bump package version to 0.1.6.

Increase FX2LAFW_VERSION_MINOR to 3.

There have been changes since the last release, but they have been
compatible ones that don't require any host-side (libsigrok) changes,
thus only increase FX2LAFW_VERSION_MINOR (but not FX2LAFW_VERSION_MAJOR).

NEWS: Add list of user-visible changes so far.

fx2lafw: Factor out LED control.

Also, make the LED polarity compile-time configurable.

[Note: This is a slightly modified version of a patch from Maciej Kurc.]

fx2lafw: silence integer overflow compile warnings

Explicitly mark literals for control bitfield values as unsigned. This
avoids a compiler warning when the MSB gets set in assignments to a BYTE.

The warning was not seen with SDCC v3.3, but with v3.6.9:

  SDCC     fx2lafw.rel
  ./source/fx2lafw.c:66: warning 158: overflow in implicit constant conversion
  SDCC     gpif-acquisition.rel
  ./source/gpif-acquisition.c:65: warning 158: overflow in implicit constant conversion

fx2lafw: fixup missing semicolon after macro "function call"

Since RESETFIFO() macro currently is "phrased unfortunately", the call
site got away with the omission of a semicolon. Adding the missing
semicolon does not harm the current implementation, and unbreaks the
build when RESETFIFO() gets improved in the future.

fx2lafw: Insert SYNCDELAYs where necessary according to TRM

fx2lafw: Delay start of GPIF until first BULK IN request is received

Apparently the host controller may issue the CONTROL transfer with
the START command earlier than any of the BULK IN requests. The result
is a filled up EP2 packet FIFO, which aborts the acquisition.

Waiting for the first BULK IN request matches the sample code in the
TRM, see e.g. Figure 10-30.

This fixes bug #655.

fx2lafw: add definitions for IBN (IN BULK NAK) interrupt

fx2lafw: remove break after return

fx2lafw: Disable SOF interrupt, it is not used

scopes: improve C preprocessor macro robustness

For pin and LED control related #define directives use C language
compound statements. This lets call sites use the macros in intended
ways (like regular function calls) without needing to worry about their
implementation details, or suffering from unexpected behaviour.

Strictly speaking the single statement variants don't require the
wrapper, but I've added one for improved future maintenance.

scopes: Move a code comment.

Makefile.am: Fix a 'make distclean' error.

scopes: Makefile.am: Add and use SDCC_LINK_FLAGS_SCOPE.

scopes: Rename dscr_hantek_6022be.inc to dscr_scope.inc.

scopes: Unify code-base, remove duplicate code/files.

All currently supported scopes (and those that will be added in the
future) now use the common include/scopes.inc firmware implementation.

Only the device-specific code and #defines are moved to the respective
subdirectory in hw/.

The now-obsolete hantek_6022be.c, hantek_6022bl.c, and sainsmart_dds120.c
files are removed.

scopes: Add include/scope.inc.

This is a copy of hantek_6022be.c, with device-specific code removed.

This includes some #defines at the top of the file, samplerates[],
and set_voltage().

scopes: Factor out TIMER2_VAL.

scopes: Factor out SET_COUPLING() and SET_CALIBRATION_PULSE().

scopes: Factor out CTL_BIT, OUT0, and OE_CTL.

scopes: Use RENUMERATE_UNCOND() for all devices.

scopes: Initialize PORTA/C/E consistently for all devices.

scopes: Factor out LED_CLEAR(), LED_GREEN(), LED_RED().

scopes: Factor out TOGGLE_CALIBRATION_PIN().

scopes: Factor out SET_ANALOG_MODE().

scopes: Adapt/fix some code comments, cosmetics.

fx2lafw: Blink LED on pin PA1 during acquisition.

All FX2 based logic analyzer devices will now toggle PA1 during
acquisition, and keep it high while idle.

On fx2grok-tiny and fx2grok-flat there's a LED connected to PA1.
Thus, those devices will visually indicate whether a firmware has been
uploaded (LED will light up and stay like that while the device is
idle). During any acquisition the LED will blink.

The PA1 pin is not used on most other FX2 based LA devices, so that
shouldn't cause any issues (tested on hardware).

On certain devices with LA and analog support the PA1 pin is used for
other purposes (e.g. Hantek 6022BL, Instrustar ISDS205X) but even there
this won't cause any issues in practice (tested on hardware).

configure.ac: Bump package version to 0.1.5.

NEWS: Add list of user-visible changes so far.

HACKING: Update URL to Linux kernel coding style.

hantek_6022be.c: Fix a code comment.

What's actually used there is OE2/CTL2.

Enable full port A as output on 6022BL

Signed-off-by: Jan Losinski <redacted>

Select enable OE0 instead of OE2 in 6022BL

Signed-off-by: Jan Losinski <redacted>

Switch from OE2/CTL2 to OE0/CTL0 on 6022BL

On this device CTL0 is soldered to IFCLK.

Signed-off-by: Jan Losinski <redacted>

Set PA7 in 6022BL again before sampling.

Signed-off-by: Jan Losinski <redacted>

Change I/O ports for voltage selection on 6022BL

The 6022BL has the multiplexers connected to port A bits instead of
port C.

Signed-off-by: Jan Losinski <redacted>

Set PA7 to high, to select analog mode.

Signed-off-by: Jan Losinski <redacted>

Change probe cal pin for 6022BL to PC2

In contrast to the 6022BE it is not connected to PA7 but to PC2 on the
6022BL.

Signed-off-by: Jan Losinski <redacted>

Initial support for Hantek 6022BL

Based on 6022BE, changed Makefile.am, added 6022BL directory.

license: remove FSF postal address from boiler plate license text

Remove the FSF postal address as it might change (it did in the past).
Reference the gnu.org website instead which is more stable.

configure.ac: Bump package version to 0.1.4.

NEWS: Add list of user-visible changes so far.

Increase FX2LAFW_VERSION_MINOR to 2.

There have been changes since the last release, but they have been
compatible ones that don't require any host-side (libsigrok) changes,
thus only increase FX2LAFW_VERSION_MINOR (but not FX2LAFW_VERSION_MAJOR).

Use per-device USB serial number strings.

These are not actual "serial numbers" in the strict sense, i.e. two
devices of the same type (e.g. two USBee ZX devices) would have the
same string.

Using two different actual serial numbers in such a case is not possible
since both devices would get the exact same firmware file (uploaded to
RAM via USB) and thus the exact same hardcoded "serial number". All devices
where fx2lafw is currently used don't have an EEPROM where the firmware
(and thus a different serial number) could be stored persistently; it's
always re-uploaded to the device's RAM upon connecting the device to USB.

However, the USB serial number field is still useful in that we can
store a nice device(-type) indicator string there. The benefit is that
an lsusb of an fx2lafw (after firmware upload) would yield something
specific like "USBee ZX" or "Hantek 6022BE" in addition to the very
generic "fx2lafw".

Add "fx2lafw-" prefix to the 6022BE/DDS120 firmware files.

Use the same VID/PID for Hantek 6022BE and SainSmart DDS120.

(one of the official sigrok VID/PIDs, 1D50:608E)

Encode the fact that they're different versions/revisions/variants
of the same device (more or less rebadges with only little changes)
in the USB product version field.

Makefile.am: Remove unneeded duplication.

Add and use macros to simplify USB descriptor files.

The macros in include/common.inc were provided by
Stefan Brüns <redacted>, thanks!

Makefile.am: Add dscr_hantek_6022be.inc to the tarball.

HACKING: Prefer git pull requests over mailing list patches.

Also, drop the reference to gitorious.org (no longer available).

README: Drop obsolete and unneeded section.

The firmware requirements should be documented in libsigrok itself, the
firmware in this repo doesn't know anything about its users per se.

gpif-acquisition.c: Minor cosmetics, drop obsolete comment.

Refactor and bugfix the delay adding code for analog capture

There're two essential modifications in this change:

1. Fix timing for capture frequencies less than 200 kHz;
2. Sample ADC output after CLK is set low, as per the TLC5510
datasheet.

The second point is also important as the capture state sets CLK low,
so with the previous code there might have been a very short glitch on
this line during capture. Not confirmed by measurements, but it's
cleaner this way.

Signed-off-by: Paul Fertser <redacted>

Remove bogus part of OUTPUT used for analog sampling

Since TRICTL = 0, FX2 always either pushes or pulls the CTLx pins.

Signed-off-by: Paul Fertser <redacted>

Fix typo in gpif_make_data_dp_state function name

Signed-off-by: Paul Fertser <redacted>

Change arguments of gpif_make_delay_state() to remove layering violation

This function is called only for adding delay states to the waveform
so OPCODE is always the same.

While at it, fix confusing comments.

Signed-off-by: Paul Fertser <redacted>

dscr*.inc: Document polling intervals better.

dscr_hantek_6022be.inc: Fix incorrect comments, add additional ones.

dscr_hantek_6022be.inc: Change vendor string to "sigrok".

dscr_hantek_6022be.inc: Cosmetic and consistency changes.

This makes the file a lot more readable and also easier to compare
to the other dscr.inc files.

Also, fix some typos (or copy-paste errors) in some comments.

dscr.inc: Shorten representation of two strings.

hantek-6022be/sainsmart-dds120: Hook up correct per-device VID/PID.

Deduplicate hantek-6022be/sainsmart-dds120's dscr.inc.

hantek-6022be/sainsmart-dds120: Use the same USB product string.

README: Mention the Sainsmart DDS120 firmware.

Add CWAV USBee ZX firmware support.

This fixes bug #764.

Silence warnings

The following warnings are fixed by this:

 hantek_6022be.c:424: warning 158: overflow in implicit constant conversion
 sainsmart_dds120.c:359: warning 158: overflow in implicit constant conversion
 sainsmart_dds120.c:363: warning 158: overflow in implicit constant conversion
 sainsmart_dds120.c:366: warning 158: overflow in implicit constant conversion
 sainsmart_dds120.c:370: warning 158: overflow in implicit constant conversion
 sainsmart_dds120.c:494: warning 158: overflow in implicit constant conversion

Add a few more code comments.

fx2lafw: clock CTL1 the same as CTL2

The LHT00SU1 has it's clock pins swapped compared to other hardware.
By duplicating the CTL2 pin both the socket and the adc will
have the same clock frequency.

Use 1D50:608E for open source Sainsmart DDS120 firmware

Support changing calibration pulse frequency

Add more sample rates

Add support for setting Sainsmart AC/DC coupling

Initial Sainsmart DDS120 firmware

Add CMD_START_FLAGS_CLK_CTL2 command flag

This command will generate a suitable clock on pin CTL2 for
devices with an analog input.

Enable more control over the GPIF state machine

hw/hantek-6022be/dscr.a51: License header cosmetics.

hantek_6022be.c: Simplify handle_vendorcommand().

hantek_6022be.c: Minor cosmetics.

hantek_6022be.c: Make a few variables and functions static.

hantek_6022be.c: Move main() for consistency.

hantek_6022be.c: Adapt to fx2lafw coding style, minor simplifications.

hantek_6022be.c: Drop unneeded debug code, random cruft.

README: Update to mention the Hantek 6022BE firmware.

hantek_6022be.c: Fix build error.

Drop handle_get_descriptor(), since it's already provided by
fx2lib/lib/setupdat.c, in order to fix the following linker error:

  Multiple definition of _handle_get_descriptor
  Makefile:925: recipe for target 'hw/hantek-6022be/hantek-6022be.ihx' failed

Makefile.am: Hook up building of hantek-6022be.fw.

The FX2 firmware for the Hantek 6022BE USB-based oscilloscope uses most
of the existing fx2lafw build infrastructure and our existing fx2lib setup,
but requires slightly different sdcc linker settings due to different code
and XRAM sizes and locations, etc.

Add FX2 firmware for the Hantek 6022BE USB scope.

This firmware was originally created by Jochen Hoenicke in 05/2015
for the Hantek6022API github project by Robert Cope. Full credit for
the implementation of the firmware goes to Jochen Hoenicke, thanks!

Github project:

  https://github.com/rpcope1/Hantek6022API

We're incorporating the firmware into the sigrok-firmware-fx2lafw
repo/tarball for convenience of sigrok users. E.g. so that they can
easily get it with the other fx2lafw firmware files from distro
packages, the build scripts in sigrok-util automatically build/install
it, the sigrok Windows installers automatically ship it, the sigrok
Android APKs automatically ship it, etc. etc.

The files we're integrating into fx2lafw from Hantek6022API are taken from
the PyHT6022/HantekFirmware/custom directory of that repo, using the state
as of 03/2016 (the files were last modified in 05/2015, though).

The git hash of the last relevant commit there was:

  0498e2ab239aabb1084c19e1e24faf56764b217e

Files integrated into fx2lafw:

 - hw/hantek-6022be/dscr.a51: Copied unmodified.

 - hantek_6022be.c: This file is created by appending the
   contents of the original device.c and fw.c together without
   other modifications.

The license of both files is LGPL 2.1 (or later).

README: Update prebuilt firmware download location.

configure.ac: Bump package version to 0.1.3.

NEWS: Add list of user-visible changes so far.

README: Any sdcc 3.x version works fine.

E.g. 3.5 also works fine as of today.

build: Distribute autogen.sh

build: Customize silent rule prefixes for sdas/sdcc

Be fancy and print custom SDAS and SDCC prefixes in silent-rules
mode.

build: Allow dist-bin from non-git sources

Do not require the source directory to be a git checkout when
creating the tarball of binary firmware files.

build: Simplify dist-changelog target

When not building from git, it is not necessary to manually copy
the ChangeLog file from the source directory to the distribution,
since Automake already does that for us.

build: Check SDCC version during configure

Require at least SDCC version 2.9.0.

This fixes bug #696.