libraw1394 v2.1.0 released

[Stefan R. <st...@s5...>]

Hi all,

a new minor release of libraw1394 is now available.

libraw1394 is the Linux legacy programming interface to low-level IEEE
1394 I/O.  Although new application development is encouraged to prefer
the <linux/firewire-cdev.h> ABI over libraw1394, this time we did add a
few new APIs to libraw1394.

Behavior changes of the backend to firewire-core:

    - The isochronous reception buffer is now mapped read/writable
      rather than read-only.  The raw1394 backend already maps the
      buffer read/writable too.  Note that writing into the buffer
      will go wrong on architectures without cache-coherent DMA if
      the CPU and the OHCI write within the same cacheline region,
      so use this feature with caution.

    - Decrease memory footprint of IR and IT buffers by avoiding
      some internal rounding up of the buffer size.

New APIs in <libraw1394/raw1394.h>:

    - raw1394_add_config_rom_descriptor():
      Add contents to the Configuration ROM of the local node(s).
      At runtime, this API is only available if running on top of
      firewire-core.  It could probably also be implemented with
      the raw1394 kernel driver if anybody cared.

    - raw1394_remove_config_rom_descriptor():
      Counterpart to raw1394_add_config_rom_descriptor().

    - raw1394_read_cycle_timer_and_clock():
      Like the existing raw1394_read_cycle_timer(), but lets the
      caller choose between CLOCK_REALTIME (which the former call
      is always using), CLOCK_MONOTONIC, or CLOCK_MONOTONIC_RAW.
      For example, this enables libffado's audio streaming to run
      undisturbed by resets of CLOCK_REALTIME.
      At runtime, this call requires firewire-core underneath.

    - raw1394_get_speed():
      Returns the speed code of the maximum possible transmission
      speed between a given node and the local node.  This takes
      maximum speeds of all participating PHYs and the two links
      into account.  This can be used to configure the speed of
      isochronous streams.
      At runtime, this call requires firewire-core underneath.

    - enum raw1394_iso_speed was extended by
      RAW1394_ISO_SPEED_800, _1600, and _3200.

New APIs in <libraw1394/ieee1394.h>:

    - Added preprocessor constants
      L1394_SPEED_BETA, L1394_SPEED_800, _1600, and _3200.

testlibraw1394:  Added unit tests of the new APIs.

------------------------------------------------------------------------

Gitweb:
      https://git.kernel.org/?p=libs/ieee1394/libraw1394.git

Git clone:
      git://git.kernel.org/pub/scm/libs/ieee1394/libraw1394.git
      https://git.kernel.org/pub/scm/libs/ieee1394/libraw1394.git

Tarball:
      https://www.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.bz2
      https://www.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.gz
      https://www.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.xz
      https://www.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.sign
      ftp://ftp.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.bz2
      ftp://ftp.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.gz
      ftp://ftp.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.xz
      ftp://ftp.kernel.org/pub/linux/libs/ieee1394/libraw1394-2.1.0.tar.sign

To verify a downloaded tarball, first uncompress from one of the
*.tar.{bz2,gz,xz} to *.tar, then run "gpg --verify libraw1394-2.1.0.tar.sign".

------------------------------------------------------------------------

Shortlog and diffstat from v2.0.9 to v2.1.0:

B.J. Buchalter (1):
      Add raw1394_add_config_rom_descriptor() and raw1394_remove_config_rom_descriptor() API

Igor Kuzmin (2):
      Enable write access to isochronous reception buffer
      Disable power-of-2 alignment of isochronous I/O buffers

Stefan Richter (10):
      Tweak raw1394_add_config_rom_descriptor() API, add documentation and test case
      Add raw1394_read_cycle_timer_and_clock() API
      Increase libtool version to 2.1.0
      Remove now unused code
      Fix documentation of raw1394_iso_multichannel_recv_init()
      Add 1394b speed codes to <libraw1394/{ieee,raw}1394.h>
      Trivial whitespace normalization in ieee1394.h and raw1394.h
      Add raw1394_get_speed() API
      testlibraw: Fix printing of card name
      Changelog, NEWS: update to version 2.1.0

 ChangeLog          |   40 +++++++
 NEWS               |   40 +++++++
 configure.ac       |    8 +-
 src/dispatch.c     |   61 +++++++++++
 src/fw-iso.c       |   49 ++++-----
 src/fw.c           |   62 +++++++++++
 src/fw.h           |   11 +-
 src/ieee1394.h     |   11 +-
 src/raw1394.h      |  413 ++++++++++++++++++++++++++++++++++++++++++++---------------------------
 tools/testlibraw.c |  104 ++++++++++++++++--
 10 files changed, 593 insertions(+), 206 deletions(-)

-- 
Stefan Richter
-=====-===-- -=== ===-=
http://arcgraph.de/sr/