ltc26x7: Put channel voltages on different annotation rows.

ltc26x7: Reduce unnecessarily many voltage formats.

ltc26x7: Fix the default for the 'chip' option.

ltc26x7: Option renames for consistency.

The 'part' option is renamed to 'chip' (and 'ref' to 'vref') to be more
consistent with the naming used in other decoders.

ltc26x7: Fix the tags metadata item.

ltc26x7: Drop unnecessary annotation_rows item.

All annotation classes are on the same row anyway, and the row name
"LTC26x7 data" isn't all that much more useful than no row name at all.

Add LTC26x7 decoder.

Signed-off-by: Teo Perisanu <redacted>

adxl345: Fix incorrect rate value in handle_reg_0x2c().

adxl345: Use all-lowercase method named for handle_reg_*.

adxl345: Use SrdIntEnum for the state machine.

adxl345: Use SrdIntEnum for annotation classes.

adxl345: Fix scale factor in handle_reg_0x22().

According to the datasheet, this should be 1.25 (ms/LSB).

adxl345: Shorten/simplify self.putbs() invocations.

adxl345: Shorten/simplify a few code snippets.

Add ADXL345 decoder.

Signed-off-by: Teo Perisanu <redacted>

sdcard_sd: Automatically generate token field annotation classes.

sdcard_sd: Put 0/1 bits in different annotation classes.

This will allow for usage of different colors in UIs, and for
showing/hiding them independently in UIs.

sdcard_sd: Put card status fields in their own annotation classes.

This also fixes the CURRENT_STATE and RSVD_TESTMODE fields, which are
not single-bit fields.

sdcard_sd: Add basic support for CSD register fields.

sdcard_sd: Add basic support for CID register fields.

sdcard_sd: Rename some annotation classes.

The responses were simply named "R1" etc., but this becomes inconvenient
when Ann.prefixeѕ('R') is used and other annotation classes also have
names that start with 'R'. Hence, rename respose annotation classes to
"RESPONSE_R1" etc.

sdcard_sd: Use a Bit class to improve readability.

Usually we'd use namedtuple(), but in this case we need to
retro-actively modify the items, so that's not possible.

sdcard_sd: Replace a hardcoded number for better readability.

sdcard_sd: Clarify some variable/argument names.

Differentiate cmd (e.g. 55 or CMD55) vs. cmd_pin (the value of the CMD pin).

sdcard_sd: Remove a list that needs manual maintenance.

Instead of checking if a command is in a fixed list/tuple (that needs
to be manually updated every time a new command becomes supported),
simply check if the respective handling method for the command exists.

This fixes the bug of the CMD16 handler not being called, and will
prevent similar bugs in the future.

sdcard_sd: Use correct annotation class for R2.

cjtag: Use SrdIntEnum for cJTAG states.

sda2506: Use SrdIntEnum for pins.

tlc5620: Use SrdIntEnum for pins.

maple_bus: Use SrdIntEnum for pins.

sdcard_sd: Use SrdIntEnum for pins.

sdcard_sd: Simplify self.putr() invocations.

sdcard_sd: Put responses in their own annotation classes.

Also, rename "reply" to "response" to use the wording from the spec.

sdcard_sd: Use SrdIntEnum for annotation classes.

cjtag: Use SrdStrEnum for the state machine.

jtag: Use SrdStrEnum for the state machine.

edid: Use SrdIntEnum for the state machine.

sdcard_sd: Use SrdStrEnum for the state machine.

srdhelper: Add SrdStrEnum with various helper methods.

usb_signalling: Use SrdIntEnum for the state machine.

jtag_ejtag: Use SrdIntEnum for annotation classes.

mcs48: Use SrdIntEnum for annotation classes.

ac97: Rename Pins class to Pin.

ac97: Use SrdIntEnum for annotation/binary/pin classes.

spiflash: Use SrdIntEnum for annotation classes.

Also, automate construction of the Ann SrdIntEnum.
This avoids having to remember to manually keep two lists in sync.

sdcard_spi: Use ternary operator where possible.

sdcard_spi: Use SrdIntEnum for annotation classes.

This also fixes incorrect annotation classes for bit, bit warning, and R1.

Also, auto-generate some more parts of the annotation class listing.

ds1307: Use SrdIntEnum for annotation classes.

ds1307: Consistently use _ instead of - for various IDs.

cc1101: Use SrdIntEnum for annotation classes.

amulet_ascii: Use SrdIntEnum for annotation classes.

Also, automate construction of the Ann SrdIntEnum.
This avoids having to remember to manually keep two lists in sync.

srdhelper: Add SrdIntEnum with various helper methods.

cjtag: Drop no longer needed _real variable name suffix.

cjtag: Give each cJTAG state its own annotation class.

cjtag: Use correct TCKC/TMSC channel names.

cjtag: Drop some unused method arguments.

cjtag: Drop non-existing channels from the decoder.

cJTAG only has two wires/channels.

cjtag: Use ternary operator where possible.

cjtag: Use += operator where possible.

cjtag: Drop various unneeded parenthesis.

cjtag: Use plural for annotation row IDs/names.

cjtag: Add cJTAG OSCAN1 decoder.

[Note: This is a commit from Kongou Hikari ("diodep" on GitHub) that was
"rebased" by Uwe Hermann on top of the current libsigrokdecode mainline JTAG
decoder. There are various reasons for this, including avoiding non-mainline
or outdated decoder changes, as well as making it easily visible what the
changes vs. the current JTAG decoder are, in case we later need to apply some
changes to both decoders or in case both decoders might be merged later on.
Minor cosmetic and naming changes were also squashed in (no functional
changes, though).]

cjtag: Use an exact copy of the jtag PD as basis for cjtag.

spiflash: Don't use ambiguous annotation class names.

This is not technically a bug since (at least some) datasheets refer
to this command as "Chip erase", it just happens to have two different
command codes (0x60 and 0xc7).

In order to not confuse users with two annotation classes with the
same name, we'll call the second one "Chip erase 2" to match the
"CE2" short name.

This fixes bug #1482.

dmx512: stack DMX512 on top of UART and improve usability

It was unfortunate that the previous DMX512 decoder implementation
re-invented UART decoder features and introduced new issues in the
process. Automatic polarity detection is just impossible when the full
set of valid DMX timings is to get supported. Sample numbers suffered
from floating point rounding errors.

Introduce a stacked decoder on top of UART which exclusively deals with
DMX512 details, and transparently benefits from all available UART
features (adjustable polarity, robust and correct sampling, data byte
accumulation, BREAK detection while silencing false STOP violations). On
one hand this requires users to specify the bitrate (250kbps), on the
other hand it results in reliable operation for all captures that have
become available so far.

Provide Python output for stacked decoders which can process protocol
extensions like RDM. Prepare the DMX512 decoder itself to handle simple
cases of protocol extensions (start codes other than 0). Add support for
additional constraint checks, emit warnings when user specified limits
are violated: short BREAK, long MARK, long RESET to RESET and short
BREAK to BREAK intervals. This shall speedup the identification of bus
health issues (data loss or corruption) or improper controller timing.

Also hide all-zero values by default, to make used channels visually
stand out, and help users focus their attention. For special cases (like
16bit data, or zero being a valid set-point for the channels) users can
enforce the display of all values. Provide an option to present byte
values to users in the most appropriate format for the use case.

This resolves bug #1442.

dmx512: remove previous implementation before replacing it

The existing DMX512 decoder implementation duplicates UART specific
knowledge, and implements some of the redundant logic in ways which fail
to interpret correct input data. See bug #1442 for details.

This commit removes the previous decoder implementation before adding a
more recent version, to gain a more readable history across that decoder
replacement.

ps2: end data byte at rising clock edge of the stop bit

Data byte transmission is complete when the STOP bit was communicated.
End the STOP bit at the rising CLOCK edge of the 11th bit time, do not
rely on the host's clock inhibit after data transmission. This avoids
the unexpected expansion of a STOP bit well into the next data byte.

This fixes bug #1460, where absence of host activity after the first
data byte loses synchronization to the input stream.

Rephrase pin level sampling while we are here. Reflect that the clock
line is used for .wait() conditions, but its level is not evaluated.
Only data line levels get processed.

Comment on the implementation's assumption of specific input data (the
device as transmitter, host transmit may not be supported, or can result
in unexpected output). Which may be acceptable yet maintainers need to
remain aware.

flexray: fix annotation for 'frame end sequence'

amulet_ascii: Minor consistency fix.

xfp: Add annotation rows.

modbus: Add missing annotation class names.

mlx90614: Add annotation rows.

Previously there were two different annotation classes with 100% overlap.

cc1101: Add missing annotation class.

This was causing incorrect annotation class indices to be used.

All PDs: Consistently use singular/plural for annotation classes/rows.

x2444m: Eliminate duplicate annotation class ID.

srd_decoder_load(): Error out upon various duplicate IDs.

HACKING: Add some Python coding style hints, fix incorrect docs.

uart: Use human-readable names for binary classes.

uart: Fix incorrect stop bit annotation class.

This fixes bug #1474.

uart: Use human-readable names for annotation classes.

Using human-readable names for annotation classes (instead of numeric
indices) improves readability and maintainability of the decoder, and can
also prevent bugs due to incorrect indices.

uart: sample position nits, fix typo, float calculation awareness

This commit amends bd50ceb314e4. Fix a typo in a comment. Rephrase the
bit width percentage calculation such that readers remain aware of the
necessity for floating point math in sample position calculations. This
commit does not change behaviour, Python 3 always yields float results
for divisions. It's about raising awareness.

uart: allow arbitrary sample positions for UART bit values (1-99%)

The previous implementation of the UART decoder used to sample bit values
strictly at the center position within a bit time. This commit introduces
support to sample bit values at arbitrary positions in the range of 1-99%
of the bit time. This allows to work around glitches in existing captures
as well as using the decoder for UART like protocols which don't sample
bit values at the center position (like EIB aka KNX).

This implementation is incomplete (on purpose). Although this version
improves the ability to extract data from captures, it also introduces
inaccuracies in the annotation positions for non-default values of the
sample point position. Addressing this issue is left for later, assuming
that it'll be a byproduct of another commit series that is being worked
on (general annotation position adjustment and stop bits support).

can: Drop an unused method.

signature: increase compatibility across Python versions

Underscores in number literals are a recent Python feature which only
was introduced in version 3.6. The sigrok project claims compatibility
with previous Python versions, but the signature decoder fails to load
with this error:

  $ pulseview
  srd: SyntaxError: Failed to load decoder signature: import by name failed: invalid syntax (pd.py, line 138)
  srd: Traceback (most recent call last):
    File "/home/user/share/libsigrokdecode/decoders/signature/__init__.py", line 25, in <module>
      from .pd import Decoder
    File "/home/user/share/libsigrokdecode/decoders/signature/pd.py", line 138
      incoming = (bin(shiftreg & 0b0000_0010_1001_0001).count('1') + data) & 1
                                                     ^
  SyntaxError: invalid syntax

Use the more compact hex presentation for a magic binary pattern. This
obsoletes the necessity to separate groups of bits for readability.

ac97/lin: Remove some unneeded code snippets.

struct srd_decoder: Fix/improve some documentation comments.

i2cfilter: Improve description of the "address" option.

dsi: Add a TODO comment for proper self.wait() usage.

All PDs where "trivial" self.wait() conversion was used now have this
specific comment, so it's easy to grep for.

srd_decoder_doc_get(): Add an additional sanity check.

decoders: Don't set self.samplenum.

This is managed by the backend and should be read-only for PDs.

hdcp: Add missing spaces.

hdcp: Reduce nesting level.

hdcp: Simplify some code snippets.

hdcp: Add tags.

Add HDCP traffic decoder to stack on i2c

This decoder annotates i2c traffic to indicate the type of HDCP
message contained. It includes HDCP2.2 and HDCP1.4. Useful for
analysing HDCP negotiation failures.

ieee488: flush upper layer payload data when IFC asserts

Also flush previously accumulated payload data when the IFC signal
asserts (interface clear, a controller requests ownership of the bus).
This is in line with EOI (end of message) and ATN (start of a command,
including change of "connected" peers or direction of communication).

ieee488: introduce 'delim' option for improved text output

When a capture contains output from a talking device, but neither
contains EOI (end of transmission) nor ATN (new commands, including
changes in the set of communicating peers or communication direction),
then lower layer data bytes would be shown but accumulated runs of upper
layer payload data would not. The hp53131a-ton.sr capture demonstrates
this behaviour.

Add transparent support for the typical case of communicating SCPI over
GPIB. Do emit upper layer payload data annotations when termination
sequences for text lines were seen. Allow users to disable this feature
when it's not appropriate for binary content.

It's an internal implementation detail that accumulated data gets flushed.
Communicate the user visible option as "payload data separation", which
should most appropriately reflect the resulting behaviour. The specific
implementation of this feature can also support different kinds of payload
chunk separation.

Obsolete gpib and iec PDs in favor of ieee488.

ieee488: Mention more relevant keywords in longname.

This can be used by frontends for decoder search features.

ieee488: Simplify _get_raw_byte() a bit.