]> sigrok.org Git - libsigrokdecode.git/commitdiff
NEWS: Add list of user-visible changes so far.
authorUwe Hermann <redacted>
Tue, 6 May 2014 07:00:00 +0000 (09:00 +0200)
committerUwe Hermann <redacted>
Tue, 6 May 2014 17:47:07 +0000 (19:47 +0200)
NEWS

diff --git a/NEWS b/NEWS
index 09cd51fdf8ad16dc4ed0d7491e6253e2df414f76..bd21b02955e4629f5ee8b70d77d4d4922627c2e2 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,8 +1,153 @@
+0.3.0 (2014-05-06)
+------------------
+
+Note: This release DOES change the libsigrokdecode public C API. This
+means it is NOT backwards-compatible and frontends will need updates.
+
+ * New supported protocol decoders:
+   - guess_bitrate  Guess the bitrate/baudrate of a signal
+   - ir_nec         NEC infrared remote control protocol
+   - ir_rc5         RC-5 infrared remote control protocol
+   - midi           Musical Instrument Digital Interface
+   - parallel       Parallel synchronous bus decoder
+   - rgb_led_spi    RGB LED string decoder (SPI)
+   - xfp            10 Gigabit Small Form Factor Pluggable Module
+   - z80            Zilog Z80 microprocessor disassembly
+ * Add support for annotation rows, i.e. groups of annotation classes that
+   are supposed to be displayed on the same GUI "row" together.
+ * Add support for the new OUTPUT_BINARY feature, which allows PDs to output
+   decoded data in various file formats (for loading and further processing
+   in other tools, or for direct live piping into other tools).
+ * Add support for the OUTPUT_META output type. This is used by PDs for
+   reporting various data points to the frontends, allowing them to perform
+   various post-processing and statistics tasks on them (e.g. simple counts,
+   average/mean values, min/max values, and so on).
+ * The OUTPUT_PROTO output type is now called OUTPUT_PYTHON.
+ * All protocol decoders:
+   - Bump the 'api_version' field of all decoders to 2. They are no longer
+     compatible (and cannot be used with) older libsigrokdecode versions.
+   - Updates to emit proper annotation classes, annotation sample numbers,
+     and annotation rows for GUI usage (bugs #146, #148, #150, #151, #154,
+     #155, #162, #147, #163, #168, #156, #309, and #344).
+   - Longer and shorter annotations are now supplied for GUI usage (frontends
+     can for example always show the longest annotation per zoom-level).
+   - Extensive protocol information has been moved from the PDs to the wiki.
+     Example: http://sigrok.org/wiki/Protocol_decoder:Uart
+   - Use correct I²C / I²S names in user-visible texts (not I2C/I2S).
+ * dcf77:
+   - Fix a bug in the handling of DCF77 bit 0.
+   - Drop handling of the 'PON' pin, this is not DCF77 related (bug #153).
+   - Fix the data parity check (bug #157).
+ * i2c:
+   - Fix corner case that can yield issues when using triggers on LAs.
+   - Drop unneeded 'addressing' option.
+   - Output bit-exact annotations and data for use by stacked PDs.
+ * i2s:
+   - Add OUTPUT_BINARY support for dumping the decoded data in WAV format.
+ * lpc:
+   - Various fixes to make the PD work better (or at all).
+   - Fix the handling of optional channels.
+   - Make the RESET# pin optional.
+ * onewire_link:
+   - Split 'reset' and 'presence' annotations.
+ * pan1321:
+   - Support the JSEC, JPRO, JAAC, and JSDA commands.
+   - Various internal fixes and improvements.
+ * parallel:
+   - Fix internal use of the obsolete 'metadata' parameter (bug #202).
+ * rtc8564:
+   - Properly handle register 0x06 (weekday) and the 'century' bit.
+ * sdcard_spi:
+   - Emit bit-exact annotations for the register fields that need them.
+   - Fix a Python issue with duplicate keys in a dict (bug #191).
+ * spi:
+   - Either MISO or MOSI can be optional now, but not both (bug #175).
+   - The CS# pin is optional now. If the pin is supplied, it is honored
+     (decoding only happens when the pin is asserted). Otherwise decoding will
+     use every CLK edge, regardless of CS# state or CS# existance (bug #152).
+   - Rename the 'SCK' pin to the more common 'CLK'.
+   - Output bit-exact annotations and data for use by stacked PDs.
+   - Fix a bug occuring when only MOSI (but not MISO) was supplied.
+ * transitioncounter:
+   - Drop the obsolete 'transitioncounter' dummy protocol decoder.
+ * uart:
+   - Fix corner case that can yield issues when using triggers on LAs.
+   - Use 'T' for stop bits and 'P' for parity bits (shortest annotations).
+   - Add a data format selection option.
+   - Annotations for RX and TX are now emitted in different annotation rows.
+   - Either the RX or TX signal can be optional now (but not both).
+   - Fix incorrectly displayed characters (bug #201).
+   - Add support for OUTPUT_BINARY output for RX, TX, or both.
+   - Output bit-exact annotations and data for use by stacked PDs.
+ * uart_dump:
+   - Drop the obsolete 'uart_dump' decoder (the feature is now included
+     in the 'uart' protocol decoder itself via OUTPUT_BINARY).
+ * usb_packet:
+   - The 'usb_protocol' decoder has been renamed to 'usb_packet'.
+   - Various bugfixes and decoding improvements.
+ * usb_signalling:
+   - Fix decoding of individual bits, sample in the middle of bits (bug #158).
+ * libsigrokdecode API changes overview:
+   - Add srd_session_new(), srd_session_destroy(), and a session context.
+   - Add srd_session_metadata_set().
+   - The name 'probe' has been renamed to 'channel' everywhere.
+   - The lib no longer defineѕ names with _t suffix (POSIX reserved).
+   - Drop the obsolete SRD_MAX_NUM_PROBES.
+   - Add the SRD_CONF_SAMPLERATE config key.
+   - Please see the Doxygen API documentation for further details.
+ * Protocol decoder API:
+   - Metadata is passed to PDs at runtime now (not at decoder start).
+     PDs now have a new optional metadata() method to receive it.
+   - Output types are now registered via Decoder.register(), not Decoder.add().
+   - The report() method is now obsolete. This kind of information will be
+     passed to the frontends via the OUTPUT_META output type, allowing the
+     frontends to perform various post-processing and statistics tasks.
+   - PDs can now define BINARY_OUTPUT types via the 'binary' tuple.
+   - PDs can now define annotation rows via the 'annotation_rows' tuple.
+   - PD options are now a tuple of dicts. Each option is a dict containing
+     the keys 'id', 'desc', 'def', and 'values'. Valid option types are
+     UTF-8 strings, integers, and floats (bugs #254, #306, #317, #165).
+   - Channels, optional channels, and annotations are now tuples (not lists).
+   - Only load PDs of API version 2, all other versions are incompatible.
+ * srd_inst_channel_set_all(): Report an error if not all channels required
+   by the respective protocol decoder have been supplied.
+ * Remove some internal limitations to max. 64 channels (bug #120).
+ * Add a unit test suite framework for libsigrokdecode ('make check').
+ * Add a protocol decoder test-suite framework for developers (tests/pdtest).
+ * Various bugfixes:
+   - srd_inst_option_set(): Properly return an error on exceptions.
+   - srd_inst_option_set(): Fix setting of instance options, caused by class
+     variable clobbering or releasing borrowed references (bugs #170, #174).
+   - srd_decoder_load(): Error out upon invalid module names (bug #176).
+   - srd_decoder_load(): Don't try to load an already loaded PD twice.
+   - srd_decoder_load_all(): Avoid issues without prior srd_init() (bug #178).
+   - srd_decoder_doc_get(): Fix an issue in the unit test suite (bug #179).
+   - srd_pd_output_callback_add(): Honor cb_data value (bug #143).
+   - Fix issues with PDs not getting the samplerate (bugs #97, #132, #166).
+   - Don't incorrectly decrease a borrowed reference (bug #177).
+   - Fix various memory leaks and segfault conditions.
+ * Build system:
+    - Use pkg-config (not python3-config) to check for Python libs.
+      This enables (better) libsigrokdecode cross-compile support.
+    - PDs no longer have an extra Makefile.am, and 'make install' now
+      happens via a Python script.
+    - configure: Clearly mark required and optional libs.
+    - Fix an issue with DESTDIR support (bug #215).
+    - Add the HACKING file to the tarball.
+ * Updated or new build-time and runtime requirements:
+   - Python >= 3.2 (required)
+   - check >= 0.9.4 (optional, only needed for the libsigrokdecode testsuite)
+   - libsigrok >= 0.3.0 (optional, only needed for the developer PD testsuite)
+   - python3-coverage (optional, only needed for the developer PD testsuite)
+ * New 'make install'-time requirement:
+   - Python >= 3.2 (required)
+
 0.2.0 (2013-05-04)
 ------------------
 
- * Note: This release DOES change the libsigrokdecode public C API. This
-   means it is NOT backwards-compatible and frontends will need updates.
+Note: This release DOES change the libsigrokdecode public C API. This
+means it is NOT backwards-compatible and frontends will need updates.
+
  * New supported protocol decoders:
    - Dallas DS1307 RTC
  * Library: Decoders now expose their options via the GSList *options field
 0.1.1 (2013-01-27)
 ------------------
 
- * Note: This release does NOT change the libsigrokdecode public C API. This
-   means existing libsigrokdecode frontends should not require any changes.
-   However, individual PDs and their output changed, which may require
-   some adaptations on the user's side in some cases.
+Note: This release does NOT change the libsigrokdecode public C API. This
+means existing libsigrokdecode frontends should not require any changes.
+However, individual PDs and their output changed, which may require
+some adaptations on the user's side in some cases.
+
  * New supported protocol decoders:
    - avr_isp              AVR In-System Programming
    - can                  Controller Area Network