summaryrefslogtreecommitdiff
path: root/decoders/uart
AgeCommit message (Collapse)Author
2017-03-15uart: Minor cosmetic changes.Uwe Hermann
2017-03-14uart: Use consistent order of steps when processing samplesGerhard Sittig
Slightly rearrange some of the methods which are involved in UART frame inspection. Use a consistent sequence of steps: Grab the signal's current value, accumulate and process the information, emit respective annotations, and advance to the next stage in the UART frame inspection.
2017-03-14uart: Remove redundant "reached bit" checksGerhard Sittig
After the decode() method got adjusted to call wait() with custom made conditions and to check .matched[] before inspecting samples, the check whether a bit time's sample point was reached has become obsolete.
2017-03-14uart: Improve robustness of query API result processingGerhard Sittig
Since either of the UART signals (RX, TX) is optional, and in the absence of Decoder.wait() conditions that "will never match", we cannot construct a constant layout. Instead we need to explicitly keep track of which item in the list of wait conditions corresponds to which signal. Once the index in the list of wait conditions is known, inspection of samples can depend on the Decoder.matched[] attribute. Before this change, redundant reached_bit() checks kept us from processing samples that should not have been inspected. Tests pass before and after this very commit.
2017-03-14uart: Reduce redundancy in sample inspection (state machine)Gerhard Sittig
Factor out the logic which inspects samples that were provided by the PD version 3 query API, and dispatches their processing depending on the progress of UART frame inspection. "Unroll" a loop over the RX and TX signals. This commit replaces some complicated variable assignments by easier to verify invocations.
2017-03-14uart: Convert to PD API version 3Gerhard Sittig
Adjust the UART protocol decoder, to make use of the query based API. Have edges detected and unrelated samples skipped by common code. This implementation keeps some redundancy in place (like checking for having reached specific sample numbers, while the backend managed that for us). This approach reduces the diff and shall simplify review. Only some common checks in decode() were moved to the start of the routine, outside of the sample inspection loop.
2017-03-14uart: Minor readability nit (position of start bit in calculation)Gerhard Sittig
Rephrase the bit slot index calculation for UART frames such that it becomes more apparent whether a start bit is involved or whether an array index needs adjustment due to Python range semantics. This shall improve readability, and reduce the probability of off-by-one errors during maintenance.
2017-03-14uart: Immediately skip reception of parity bits when not applicableGerhard Sittig
When the UART frame does not contain a parity bit, then immediately advance to reception of stop bits after all data bits were received. This eliminates the necessity to run the parity check routine when parity does not apply in the first place. Without this change, some "dummy" sample needs to get inspected for correct operation of the state machine.
2017-03-14uart: Remove an obsolete unused routineGerhard Sittig
2017-01-07license: remove FSF postal address from boiler plate license textGerhard Sittig
Remove the FSF postal address as it might change (it did in the past). Reference the gnu.org website instead which is more stable.
2016-10-23uart: Default to hex format datavalue annotations.Uwe Hermann
This is in almost all cases what the user will want, only rarely ASCII (the old default) will be the more natural fit.
2016-10-23uart: Emit 2 bytes for 9-bit UART binary output.Uwe Hermann
For 5..8 data bits the binary output will be 1 byte, for 9 data bits it will be 2 bytes (big-endian). This fixes bug #708.
2016-10-19uart: skip frames with invalid start bitsGerhard Sittig
When the start bit is not low at its sample point, then stop trying to interpret the remaining frame -- it's already known to be invalid, anyway. Wait for the next start bit instead, assuming that either the falling edge which started the inspection of the UART frame and its start bit was a spurious glitch or that the captured signal does not communicate at the decoder's configured bitrate. Signed-off-by: Gerhard Sittig <gerhard.sittig@gmx.net>
2016-10-19uart: rework text formatting of communicated data values, plus nitsGerhard Sittig
Factor out the code which generates a textual representation for the numeric values that were communicated via UART bit patterns. Make the width of the output text depend on the number of bits in the UART frame (five to nine) instead of assuming bytes of exactly eight bits. Fix other minor issues while we are here: Nine bits result in a number range of 0 to 511 (not 512). ASCII codes 30 and 31 are non-printables. The previous implementation skipped a significant leading digit in the octal representation. Signed-off-by: Gerhard Sittig <gerhard.sittig@gmx.net>
2016-10-19uart: minor nit, rename the "databyte" variableGerhard Sittig
Given the generic nature of UART communication and the supported range for the data width, "byte" may be a misleading name for the numeric value that gets communicated in five to nine data bits. Rename the "databyte" variable to "datavalue". Signed-off-by: Gerhard Sittig <gerhard.sittig@gmx.net>
2016-09-24uart: Fix a bug in the output for stacked PDs.Uwe Hermann
The UART bit information was not transmitted correctly to stacked PDs if there was an overlap between RX and TX bytes in the data.
2016-05-15Use consistent __init__() format across all PDs.Uwe Hermann
The previous **kwargs some PDs had is not actually ever used, so drop it.
2016-01-29uart: Optimize handling of samples when tx and rx are both idleDaniel Thompson
Re-enable the fast path for identical samples but only when both pins are waiting for the start bit. For sparse data sets (I tested UT61E capture log) the optimization results in a >4x decode improvement.
2015-12-24Use self.out_binary naming consistently across all PDs.Uwe Hermann
2015-12-24Use a Python list (not tuple) for OUT_BINARY.Uwe Hermann
This is more consistent with annotation syntax and looks slightly better in most cases.
2015-10-22UART: Handle framing errors betterElrond
1. Show Frame Error on the Start bit 2. Don't overwrite framing errors with (valid) start/stop bit info
2015-02-17Improve uart decoder sample positions at high data rates.Petteri Aimonen
At 3 samples per bit, the uart decoder took the value at the last sample instead of the middle one. Improve calculations so that sampling is more accurate at odd number of samples per bit.
2014-10-16uart: Fix code comment.Uwe Hermann
2014-10-16uart: Emit databyte and bits list at the same time.Uwe Hermann
This will allow for much simpler code in stacked PDs. Adapt stacked PDs to new API.
2014-10-13All PDs: Only import the 'Decoder' object.Uwe Hermann
Anything else in the pd.py files doesn't have to be imported/exposed.
2014-09-15uart: Implement signal inversionDavid Barksdale
2014-09-01PD tests moved into the sigrok-test repo.Uwe Hermann
Drop them from the libsigrokdecode repository.
2014-08-14pdtests: Check for SamplerateError in all PDs that emit it.Uwe Hermann
2014-08-14spi/nrf24l01/uart: Use ChannelError exception.Uwe Hermann
Rename the old MissingDataError to the clearer ChannelError. Also, add ChannelError in the UART decoder.
2014-07-15All PDs: Minor whitespace and consistency fixes.Uwe Hermann
- No newlines at the end of files. - No trailing ';' characters. - Comparison with None: Use 'is None' or 'is not None'. - Comparison with True/False: Use 'if cond:' or 'if not cond:'. - Various minor whitespace fixes.
2014-07-09uart/i2cfilter: Don't check multiple-choice options.Uwe Hermann
For options which only have a limited set of valid values, we don't need to check (in the PD) whether a valid value was supplied, since the backend can do that for us.
2014-07-09Various PDs: Throw SamplerateError instead of Exception.Uwe Hermann
Also, use the "if not self.samplerate" form, which catches both the case where self.samplerate is None, as well as the case where it is 0.
2014-07-09All PDs: Drop unneeded exceptions.Uwe Hermann
In all current PDs it is not necessary to raise an exception upon invalid states (of the PD's state machine), since we can guarantee that no such invalid state can ever be reached in these PDs.
2014-04-15All PDs: More consistent OUTPUT_PYTHON format docs.Uwe Hermann
2014-04-15All PDs: Bump api_version to 2.Uwe Hermann
Older libsigrokdecode versions are no longer able to use the current versions of the PDs (various changes in syntax etc).
2014-04-13Rename 'probe' to 'channel' everywhere.Uwe Hermann
Variables of type 'struct srd_channel *' are consistently named 'pdch' to make them easily distinguishable from libsigrok's 'struct sr_channel *' variables that are consistently named 'ch'.
2014-03-14Bring various test output files up to date.Bert Vermeulen
2014-03-10Probes, optional probes and annotations now take a tuple.Bert Vermeulen
Annotation entries also consist of a tuple, not a list.
2014-03-10Remove unused probes and optionsBert Vermeulen
2014-03-10Change PD options to be a tuple of dictionaries.Bert Vermeulen
Each option consists of a dictionary with the following keys: id The option id, which is passed in when setting a value. desc A description of the option, suitable for display. def The default value for this option. values (optional) If present, a tuple containing values the option may take. They must be of the same type as the default. Valid types for the options are UTF-8-encoded strings, integers, and floating point values.
2014-02-23uart: Emit per-bit annotations and OUTPUT_PYTHON data.Uwe Hermann
2014-02-01uart: Better annotation row handling of parity errors.Uwe Hermann
2014-01-31uart: Define annotation rows.Uwe Hermann
Also, provide all the required annotation classes for this to work properly.
2014-01-31uart: Allow either RX or TX to be optional.Uwe Hermann
2014-01-30s/out_proto/out_python/.Uwe Hermann
The output type is now called OUTPUT_PYTHON, adapt all PDs to that.
2014-01-30uart: Add trekstor_ebr30_a test case.Uwe Hermann
2014-01-30uart: Better fix for ASCII output.Uwe Hermann
This is a temporary thing, later there'll be some facility to let frontends handle any annotations marked as "this is a number" (as opposed to "this is a string") in a generic manner and display them in any supported (by that frontend) format, e.g. ascii, hex, oct, decimal, binary, big-endian vs. little-endian, and so on. This is a fix related to #201.
2014-01-28All PDs: Consistent naming/case for annotation shortnames/IDs.Uwe Hermann
2014-01-28All PDs: Drop unneeded comments.Uwe Hermann
The single comment re-stating the PD's name / description / purpose in each pd.py file is not really needed, that info is available in the Decoder class' attributes already.
2014-01-28All PDs: Improve/fix descriptions.Uwe Hermann