summaryrefslogtreecommitdiff
path: root/decoders/uart/pd.py
AgeCommit message (Collapse)Author
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-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: 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-23uart: Add binaryout/dump support, drop obsolete 'uart_dump' PD.Uwe Hermann
The functionality of the preliminary 'uart_dump' PD is now available in the proper 'uart' PD, via the OUTPUT_BINARY mechanism that frontends can use to dump decoded data (in various formats) to a file, or pipe it into other applications, and so on. Old sigrok-cli example usage: $ sigrok-cli -i foo.sr -P uart:rx=0:tx=1,uart_dump:filename=bootlog.txt New sigrok-cli example usage: $ sigrok-cli -i foo.sr -P uart:rx=0:tx=1 -B uart=rxtx > bootlog.txt New sigrok-cli example usage (piping into other applications): $ sigrok-cli -i foo.sr -P uart:rx=0:tx=1 -B uart=rxtx | grep "whatever"
2013-12-03uart: Display non-ASCII characters properly.Uwe Hermann
We use the [XX] notation for non-printable characters, which is what various other logic analyzer software packages do too, e.g. the CWAV USBee Suite. This fixes bug #201.
2013-11-15Drop obsolete report() method.Bert Vermeulen
2013-11-15Use the new Decoder.register() APIBert Vermeulen
2013-11-07Rename inter-PD output type to SRD_OUTPUT_PYTHONBert Vermeulen
This better reflects what it is: a python object generated and processed by python code.
2013-10-30Receive samplerate via metadata(), not start()Bert Vermeulen
2013-09-12uart: Output data in separate RX and TX annotation types.Uwe Hermann
There is one annotation type for the RX side of the communication/data output now, and another one for the TX side. This allows GUIs to show them in two different traces, and/or show them in the same trace but with different colors. This also has the additional benefit that it is clear which databyte belongs to which direction. Previously the annotations had to look like "RX: 5F" or "TX: 11001011", but the "RX: " and "TX: " prefixes are now no longer required, making the GUI traces (and CLI output too) much more readable.
2013-09-12uart: Use same length for data output in all cases.Uwe Hermann
Until now you could get e.g. "d" or "df" as hex output from the UART PD. This will now be a common-length "0D" and "DF". When all data byte annotations are of the same lengths the readability in GUI traces is a lot better. Also, hardcode hex characters to be upper-case (for now). The same applies to oct ("021" instead of "21") and bin output ("00001001" instead of "1001").
2013-09-12uart: Put annotations into proper annotation types.Uwe Hermann
There are now extra annotation types for data, start/stop/parity bits and for warnings (e.g. "invalid parity" or "frame error" or such). This allows users to select which of the annotation types they want to see (they can select one/multiple/all annotations as needed), and also allows them to use different visual representation for the different annotation types in GUIs (e.g. different colors for the blobs, different fonts, rectangle/round/elliptic blobs, and so on; how the annotation blobs are displayed is entirely up to the GUI and its configuration by the user).
2013-09-12uart: Move OUTPUT_PROTO format description to pd.py.Uwe Hermann
This is information that a user (when viewing PD info in a GUI/CLI) should not see (and doesn't care to see), it is meant for developers only. Thus, make it a comment in pd.py instead.
2013-09-12uart: Make data format selection a PD option.Uwe Hermann
Until now we (ab)used annotation types for outputting the same data (numbers) in different formats (hex, ascii, binary, and so on). Turn this into a proper PD option, since annotation types should rather be used for different _types_ of annotations (e.g. "CRC", "Stop bit", "Preamble", "Sequence counter", "Warnings", and similar things), not different _formats_ for the same annotation type. Old sigrok-cli invocation for hex output: sigrok-cli ... -P uart:rx=0:tx=1 -A uart=hex New: sigrok-cli ... -P uart:rx=0:tx=1:format=hex In GUIs there is now a new "Data format" option where the user can select the output format for UART data (default is 'ascii').
2013-09-12uart: Use T for stop bit, P for parity bit.Uwe Hermann
The short(est) annotations for "Stop bit" and "Parity bit" have both been "P" until now, which is confusing for users (on certain zoom levels in GUIs). Use "T" for stop bits now instead.
2013-09-12uart: Don't prefix databyte output numbers.Uwe Hermann
Previously the output was 0x41 or 0o101 or 0b1000001, now it is 41 or 101 or 1000001. We drop these prefixes, since they decrease the readability of the PD output (especially when displayed in GUIs) and are not needed anyway since the user knowingly selected the number format before running the respective PD.
2013-09-12uart: Fix corner-case that can occur with LA triggers.Uwe Hermann
Assume that the initial pin state is 1/high for the RX and TX lines. This fixes the decode when an LA triggers on e.g. TX=low (the first sample would be low in that case, so the falling edge for the start bit would be missed by the decoder).
2013-09-12uart: Fix start-/end-sample numbers.Uwe Hermann
This now makes the UART decoder suitable for use in GUIs. This fixes bug #148.
2013-04-23GPL headers: Use correct project name.Uwe Hermann
2012-11-24Fix bugs in "Invalid state" printing/exceptions.Uwe Hermann
2012-11-24All PDs: Name the files pd.py consistently.Uwe Hermann
The Python module name is determined by the directory name (e.g. dcf77), the *.py file names in that directory don't matter and can be kept consistent.