Release Notes

From IEEE 1394 FireWire Wiki
(Difference between revisions)
Jump to: navigation, search
(Linux 3.1: -rc3 with camcorder related fix)
(Linux 4.8, Linux 4.4: stable backports)
 
(48 intermediate revisions by one user not shown)
Line 5: Line 5:
 
'''Release Status'''
 
'''Release Status'''
  
The latest stable releases of Linux IEEE 1394 drivers are those in the latest released Linux 2.6 kernels.
+
The latest stable releases of Linux IEEE 1394 drivers are those in the latest released Linux 4.x kernels.
  
The drivers in Linux 2.4 are considered stable too but are not actively updated anymore.  Therefore they lack some features and compatibility updates which went into recent Linux 2.6 releases.
+
The drivers in Linux 2.4 were considered stable too but have not been updated anymore for a long time.  Therefore they lack many features and compatibility updates which went into Linux 2.6.x...4.x releases.
  
 
The following release notes only summarize more notable changes.  A complete list of IEEE 1394 related changes is available via kernel.org git:
 
The following release notes only summarize more notable changes.  A complete list of IEEE 1394 related changes is available via kernel.org git:
:* [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/ieee1394 drivers/ieee1394]
+
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/ieee1394 drivers/ieee1394]
:* [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/firewire drivers/firewire]
+
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/firewire drivers/firewire]
:* [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/media/dvb/firewire drivers/media/dvb/firewire].
+
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/media/firewire drivers/media/firewire], formerly [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/media/dvb/firewire drivers/media/dvb/firewire]
:* [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=sound/firewire sound/firewire]
+
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=drivers/target/sbp drivers/target/sbp]
:* include/linux/{[http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/linux/firewire.h firewire.h],[http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/linux/firewire-cdev.h firewire-cdev.h],[http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/linux/firewire-constants.h firewire-constants.h]}
+
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=sound/firewire sound/firewire]
:* Documentation/ABI/stable/{[http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=Documentation/ABI/stable/firewire-cdev firewire-cdev],[http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=Documentation/ABI/stable/sysfs-bus-firewire sysfs-bus-firewire]}
+
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=tools/firewire tools/firewire]
 +
:* [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/linux/firewire.h include/linux/firewire.h]
 +
:* include/uapi/linux/{[https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/uapi/linux/firewire-cdev.h firewire-cdev.h],[https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/uapi/linux/firewire-constants.h firewire-constants.h]}, formerly include/linux/{[https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/linux/firewire-cdev.h firewire-cdev.h],[https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=include/linux/firewire-constants.h firewire-constants.h]}
 +
:* Documentation/ABI/stable/{[https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=Documentation/ABI/stable/firewire-cdev firewire-cdev],[https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=Documentation/ABI/stable/sysfs-bus-firewire sysfs-bus-firewire]}, [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=history;f=Documentation/debugging-via-ohci1394.txt Documentation/debugging-via-ohci1394.txt]
  
  
Line 21: Line 24:
  
  
== Linux 3.1 ==
+
== Linux 4.9 ==
  
''tentative release notes per 3.1-rc3''
+
''tentative release notes as per v4.9-rc4''
  
;firewire-core:
+
;firewire-net:
:* Fix detection failures of old Panasonic and Grundig camcordersThe failure was accompanied by "giving up on config rom" log messages after ack-busy events in firewire-ohci's debug log.
+
:* Add missing input validationInvalid IP-over-1394 encapsulation headers could trigger buffer overflows, potentially leading up to remote code execution ([http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8633 CVE-2016-8633]). Also fixed in v4.8.7 and v4.4.31.
:* Added a [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/ABI/stable/firewire-cdev;h=16d030827368b2c49cbbe396588635dfa69d6c08;hb=322a8b034003c0d46d39af85bf24fee27b902f48 brief introduction into the character device file ABI].
+
:* Fix IP-over-1394 link fragmentation headers that were read and written incorrectly, which prevented fragmented reception from/ fragmented transmission to other stacks, including Mac OS X, Windows XP, and older Linux' eth1394Also fixed in v4.8.7 and v4.4.31.
:* Added a [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/ABI/stable/sysfs-bus-firewire;h=3d484e5dc846ed9b7625c83d948322f825c323df;hb=322a8b034003c0d46d39af85bf24fee27b902f48 reference documentation of the sysfs ABI].
+
:* Minor corrections to the cdev ABI:  Unknown ioctls set errno to ENOTTY now instead of EINVALFW_CDEV_EVENT_BUS_RESET events are now guaranteed not to be generated before FW_CDEV_IOC_GET_INFO was used to set the bus reset closure.  Both issues are also fixed in Linux 3.0.1 and 2.6.35.14.
+
  
;firewire-ohci:
 
:* Reduced CPU utilization during packet queuing.
 
  
 +
== Linux 4.8 ==
  
== Linux 3.0 ==
+
''2 October 2016''
  
''21 July 2011''
+
;snd-firewire-tascam:
 +
:* Fix possible deadlock in hwdep interface.  Also fixed in v4.7.4 and v4.4.21.
  
This release contains a few fixes and some optimizations regarding CPU utilization of the IEEE 1394 kernel drivers, and the following more visible changes.
+
;snd-fireworks:
 +
:* Fix possible deadlock in hwdep interface.  Also fixed in v4.7.4, v4.4.21, v4.1.34, v3.18.43.
  
;firewire-ohci:
 
:* Probing of the FireWire part on Pinnacle MovieBoard is disabled for now because it used to lock up the kernel.  Also disabled in kernel 2.6.39.4, 2.6.35.14.  Perhaps we can come up with a proper fix longer term, perhaps not.
 
  
;firewire-sbp2:
+
== Linux 4.7 ==
:* Management of storage devices (connect, reconnect, disconnect) is now performed in parallel if there are two or more devices present.
+
  
;snd-isight:
+
''24 July 2016''
:* New ALSA driver for the microphones in Apple iSight FireWire webcams.  It exposes front and rear microphone as a sound card with two PCM capture channels.  This supersedes an older out-of-the-mainline driver with the same function, called lisight, which depended on the removed ieee1394 driver stack.
+
  
 +
;snd-dice:
 +
:* Add support for M-Audio Profire 610, and perhaps for Profire 2626.
  
== Linux 2.6.39 ==
+
;snd-firewire-lib:
 +
:* Add tracepoints to dump a part of isochronous packet data in order to support debugging of device quirks and of kernel-internal packet processing. The [https://git.kernel.org/linus/0c95c1d6197f patch changelog] describes how to use this feature.  A [https://git.kernel.org/linus/a9c4284bf5a9 subsequent commit] expands the dump format.
  
''18 May 2011''
+
;snd-firewire-lib, snd-bebob, snd-firewire-tascam, snd-fireworks:
 +
:* Remove matching of SYT fields of the outbound stream to those of the inbound stream since it proves to be unnecessary in practice.  The same was already done in snd-dice in Linux v4.6.  This simplifies the kernel code and allows for finer-grained tasklet scheduling.
  
;firewire-core:
+
;snd-firewire-lib, snd-bebob, snd-firewire-digi00x, snd-firewire-tascam, snd-fireworks, snd-oxfw:
:* Increase the default timeout of outbound split transactions from 100 ms to 2000 ms.  This is mostly just relevant to some audio devices for which the FFADO drivers used to increase this timeout.
+
:* Perform sound card registration at least 2 seconds after the last IEEE 1394 bus reset.  This was already implemented for snd-dice in Linux v4.5 and is now adopted by the other FireWire audio drivers. It ensures that the bus and device firmware settle into a ready state before userspace initiate I/O to the device.
:* Try to probe even nodes whose self-ID packet does not have the "link active" bit set.  Some rare devices wrongly have this bit off and were therefore not recognized.
+
:* Fix the FW_CDEV_IOC_ADD/REMOVE_DESCRIPTOR ioctl()s which did not update the local Config ROM properly since kernel 2.6.36 if called in repetition.  Also fixed in Linux 2.6.38.6.
+
  
;snd-firewire-speakers:
 
:* New ALSA driver for LaCie FireWire Speakers.  Also has got some experimental support for Griffin FireWave.
 
  
 +
== Linux 4.6 ==
  
== Linux 2.6.38 ==
+
''15 May 2016''
  
''14 March 2011''
+
;snd-bebob:
 +
:* internal rework related to streaming recovery after bus reset
  
;firewire-core:
+
;snd-dice:
:* Fix access to some Canon camcorders, notably MV5i.  Also fixed in kernel 2.6.37.1, 2.6.36.4, and 2.6.33.8.
+
:* Change how the dependency between number of available PCM and MIDI channels versus sampling rate is handled.  Also affects the hw_params ioctl interface. Userspace should set the desired sampling rate before starting PCM I/O.
 +
:* Change how phase lock is ensured and how lock status is detected.
 +
:* Remove matching of SYT fields of the outbound stream to those of the inbound stream. This synchronization happened when the device was configured for internal clock. It required a startup delay of the outbound stream, which caused DICE II based devices to remain silent at the first attempt to start streaming.
 +
:* Add support for previously unavailable higher PCM channels on certain devices with high channel count, notably Focusrite Saffire PRO 40, Focusrite Liquid Saffire 56, and TC Electronic Studio Konnekt 48. These devices spread the PCM and MIDI channels across 2 tx + 2 rx IEEE 1394 channels instead of just 1 tx + 1 rx IEEE 1394 channel, as most other devices do.
  
;firewire-net:
+
;snd-oxfw:
:* Longstanding performance issues are now fixed thanks to changes in firewire-ohci.
+
:* improvements to MIDI I/O
:* Show carrier status to userland.
+
:* Refresh the ARP cache quicker after a temporary disconnection.
+
  
;firewire-ohci:
 
:* Fix reception of asynchronous packets larger than 4080 bytes.
 
:* Performance of asynchronous reception has been improved considerably.  Busy link situations that were previously very common with firewire-net and with applications that required fast async reception are now avoided.
 
:* Fix restoration of the GUID after PM resume with some BIOSes.
 
:* Restart isochronous DMAs after PM resume if they were running at PM suspend time.  Also needed for broadcast reception by firewire-net.
 
  
;firedtv:
+
== Linux 4.5 ==
:* Fix reporting of IR remote control key presses to recent Xorg versions.
+
  
As always, there have also been several further low-profile improvements, e.g. a few small changes to firewire-core and firewire-ohci which each lower CPU utilization a little bit or prevent potential corner case bugs.
+
''13 March 2016''
  
'''Known issues:'''  On systems with the kernel configured for a maximum supported number of CPU cores which is not a power of two, firewire-ohci of kernel 2.6.38 and newer triggers a bug in the kernel's memory management system, causing a crash during boot (bug [https://bugzilla.kernel.org/show_bug.cgi?id=31572 31572]).  As a workaround, set CONFIG_NR_CPUS to 4 instead 3, 8 instead of 6, or 16 instead of 10 etc., depending on your needs.  This bug has been fixed (i.e. the workaround is no longer needed) in Linux 3.1 and 3.0.3.
+
;snd-dice:
 +
:* Improved handling of DICE II firmware bootstrapping during device start-up.
 +
:* Avoid time-out when PCM streaming is started.
  
 +
;snd-firewire-tascam:
 +
:* Add support for TASCAM FW-1804.
  
== Linux 2.6.37 ==
+
;snd-scs1x:
 +
:* The functionality of this driver was moved to the snd-oxfw driver, and the now obsolete snd-scs1x module has been removed.
  
''4 January 2011''
 
  
;firewire-net:
+
== Linux 4.4 ==
:* Fix memory leaks.
+
:* Fix counting of transmit statistics.
+
:* Fix firewire-net blocking other FireWire I/O.
+
 
+
;firewire-ohci:
+
:* Fix crashes or memory corruption during reception of large asynchronous requests or responses.  These bugs were for example experienced when using firewire-net.  Also fixed in 2.6.36.2, 2.6.35.10, 2.6.34.9, 2.6.33.8, and 2.6.32.27.
+
 
+
;firedtv:
+
:* Add support for DVB-S2 HD channels.  (HD already worked on DVB-C and presumably DVB-T.)
+
:* Add a module parameter to adjust CA system IDs.  This is a workaround for users of Content Access Module and applications like MythTV, in cases when manufacturer ID of a CAM and CA system ID differ.
+
 
+
;dv1394, eth1394, ieee1394, ohci1394, pcilynx, raw1394, sbp2, video1394:
+
:* These drivers, a.k.a. the Linux1394 driver stack, have been removed.<br>  firewire-ohci replaces ohci1394.<br>  firewire-core replaces ieee1394, raw1394, video1394.<br>  firewire-net replaces eth1394.<br>  firewire-sbp2 replaces sbp2.<br>  There is no replacement for dv1394 and pcilynx.<br>  The drivers firedtv, init_ohci1394_dma, and nosy are not affected by these replacements.
+
 
+
'''Known issues:'''  The rare and quirky controllers ALi M52xx, Apple UniNorth v1, NVIDIA NForce2 are even less well supported by firewire-ohci than by ohci1394.  There were some ieee1394 based out-of-the-mainline drivers.  Of them, only lisight, an audio driver for iSight webcams, seems still useful.  Work is underway to reimplement it on top of firewire-core.
+
 
+
 
+
== Linux 2.6.36 ==
+
 
+
''20 October 2010''
+
 
+
This release brings several fixes and some new features for the newer firewire driver stack.  Some of these fixes, as far as they affect libraw1394 based software, also require libraw1394 2.0.6 (which contains corresponding updates) or later.  Furthermore, an older special-purpose stand-alone driver has now been merged into the mainline kernel:  Nosy, a packet sniffer for PCILynx cards.
+
 
+
;firewire-core, interface to userspace drivers:
+
:* Fix transaction responses if multiple cards are present.
+
:* Fix lock transaction responses.
+
:* Add new incoming request event type which carries information about source node and extended transaction code.  This addresses deficiencies of the prior ABI for address range mapping and FCP which made it impossible to write target-like drivers in userspace.  It also prevented FFADO to work with two or more audio devices together on the bus.  In order to use this ABI fix with libraw1394 based clients like e.g. FFADO, libraw1394 v2.0.6 will be required.  (Due to be released soon.)
+
:* FW_CDEV_VERSION, defined in <linux/firewire-cdev.h>, is no longer being updated.  Old libraw1394 code misused this constant.  If your code needs to handle different firewire-cdev.h file versions, have a look at    current libraw1394 code how it can be done.  Basically, check for particular defined ioctls and event types.
+
:* Fix fw_cdev_event_bus_reset:  Implement bm_node_id.  Fix missing event on the local node's /dev/fw* after descriptor addition or removal.
+
:* New feature:  Support multichannel isochronous reception.  A corresponding update to libraw1394 has not been implemented yet.
+
:* New feature:  PHY packet transmission and reception.  Among else this allows to implement VersaPHY controllers or VersaPHY devices in userspace.
+
:* The address range allocation ioctl now allows to allocate a CSR anywhere in a region larger than the CSR.
+
:* Add more safeguards against bogus ioctl data and against multithread client race conditions.
+
:* Several updates to the inline documentation in <linux/firewire-cdev.h>.
+
  
;firewire-core, bus management:
+
''10 January 2016''
:* Support the following CSRs on the local node:  STATE_CLEAR/STATE_SET (cmstr and abdicate bits), NODE_IDS, RESET_START (as dummy), SPLIT_TIMEOUT (useful to FFADO with BeBoB devices with lots of channels), CYCLE_TIME write support, BUS_TIME, BUSY_TIMEOUT, PRIORITY_BUDGET, MAINT_UTILITY.
+
:* More careful bus manager routines WRT temporary transaction failures, Cycle Master activation.
+
:* Bus resets that were issued by userspace clients via bus reset ioctl or indirectly by descriptor addition or removal (also firewire-net insertion and removal) are now better integrated into bus management:  The gap count is kept stable, and the period between such bus resets is forced to be 2 seconds or more.  This period is necessary for isochronous resource reallocation, SBP-2 reconnect, and similar procedures.
+
  
 
;firewire-ohci:
 
;firewire-ohci:
:* Enable message-signaled interrupts ([http://en.wikipedia.org/wiki/Message_Signaled_Interrupts MSI]) on native PCIe controllersThis includes Agere FW643E (i.e. FW643 rev07), but not FW643 rev06 and older nor VIA VT6315 nor JMicron JMB38x on which we continue to use classic pin-based interrupts due to hardware bugs. MSIs are furthermore not present on Texas Instruments PCIe FireWire controllers which are PCI devices with a PCI&ndash;PCIe bridge&mdash;  MSI support was initially also enabled on older FW643 and VT6317 which led to regressions in kernels 2.6.36...2.6.36.2 inclusive. This has been corrected in kernel 2.6.36.3.
+
:* Work around JMicron JMB38x initialization quirkAffected isochronous transmission, e.g. audio via FFADO or ALSAAlso fixed in v4.3.3, v4.2.8, v4.1.15, v3.18.26, v3.16.35, v3.14.59, v3.12.52, v3.10.95, v3.4.113, v3.2.74.
:* Enable workaround for nonmonotonic Cycle Timer on Ricoh controllers. Cycle Timer is used by libdc1394 and by FFADO for reception timestamps.
+
  
;firewire-sbp2:
+
;snd-bebob:
:* Fix stalls with "Unsolicited response" with some firmwares of 4-bay RAID enclosures.
+
:* Fix device identifier of Mackie Onyx 1220/1620/1640 FireWire I/O card.
:* Fix a memory leak in error cases.
+
  
;nosy:
+
;snd-dice:
:* "New" driver:  Nosy is a traffic sniffer driver for Texas Instruments PCILynx/ PCILynx-2 based cards.  The use cases for nosy are analysis of nonstandard protocols and as an aid in development of drivers, applications, or firmwares.<br>  Nosy was written by Kristian Høgsberg many years ago and maintained by him in a stand-alone source repository.  Now the driver is available in the mainline kernel sources.  Its userspace frontend, called nosy-dump, is also maintained and distributed with the kernel sources under tools/firewire/.<br>  PCILynx/ PCILynx-2 is a FireWire controller which is not OHCI-1394  compliant.  This controller is found for example on IOI IOI-1394TT (PCI card), Unibrain Fireboard 400 PCI Lynx-2 (PCI card), Newer Technology FireWire 2 Go (CardBus card), and Apple Power Mac G3 blue & white (onboard controller).
+
:* Fix device identifier of Mackie Onyx Blackbird and Onyx-i series.
  
There is also an obscure change to the kernel's Makefiles with a side effect:  When both ohci1394 and firewire-ohci were installed but there was no [[Juju_Migration#How_to_suppress_auto-loading|modprobe blacklist configuration]] for one or both of them, then it was reportedly more likely in recent kernels that ohci1394 was being bound to FireWire controllersIn 2.6.36, it will more likely be firewire-ohci.
+
;snd-firewire-digi00x:
 +
:* New driver for Digidesign audio interfaces: Digi 002 Console, Digi 002 Rack, Digi 003 Console, Digi 003 Rack, Digi 003 Rack+Written by Takashi Sakamoto.
  
 +
;snd-firewire-lib:
 +
:* Restructured and extended for wider protocol support.  Data block processing is split from isochronous packet processing.  This work was required for integration of snd-firewire-digi00x and snd-firewire-tascam because devices which are supported by these drivers do not comply with IEC 61883-6.  Written by Takashi Sakamoto.
  
== Linux 2.6.35 ==
+
;snd-firewire-tascam:
 +
:* New driver for TASCAM audio interfaces: FW-1082, FW-1884. Written by Takashi Sakamoto.
  
''1 August 2010''
+
;snd-oxfw:
 +
:* Fix Mackie Onyx Satellite packet discontinuity when device is used in base station mode.
 +
:* Add support for TASCAM FireOne.
 +
:* Fix calculation of MIDI ports.
 +
:* Fix for statically linked (i.e. non-modular) builds.
  
This release brings minor fixes to the new firewire driver stack.
 
  
The old ieee1394 driver stack &mdash; i.e. ieee1394, ohci1394, pcilynx, sbp2, eth1394, raw1394, video1394, dv1394 &mdash; is now scheduled for removal in Linux 2.6.37.
+
== Linux 4.3 ==
  
;firewire-core:
+
''1 November 2015''
:* Fix inaccessibility of certain Sony camcorders, caused by bus reset loops because of conflicts between firewire-core's and the camcorder firmware's bus management.  Fixed by checking for IEEE 1394a compliance of the isochronous resource manager.  Also fixed in Linux 2.6.34.1, 2.6.33.6, 2.6.32.16.
+
:* more robust allocation of transaction labels and time-out of transactions
+
:* lseek() is not useful with /dev/fw*;  it is now failed instead of seemingly succeeding
+
  
;firewire-ohci:
+
No functional changes to the FireWire subsystem.
:* access PHY registers more safely
+
:* enable IEEE 1394a enhancements in the physical layer and link layer consistently (or disable consistently on IEEE 1394-1995 hardware)
+
  
;raw1394, video1394, dv1394:
 
:* lseek() is not useful with /dev/raw1394, /dev/video1394/*, /dev/dv1394/*;  it is now failed instead of seemingly succeeding
 
  
'''Known issues:'''  firewire-ohci changes in this release caused slow-down and data corruption on some TI TSB82AA2 based cards. This regression is fixed in kernel 2.6.36 and 2.6.35.8.
+
== Linux 4.2 ==
  
 +
''30 August 2015''
  
== Linux 2.6.34 ==
+
;snd-bebob:
 +
:* Add support for
 +
::: Digidesign Mbox 2 Pro
 +
::: Behringer FCA610, FCA1616
 +
:* Improve BeBoB v3 support (PrismSound Orpheus, Behringer UFX1604, Behringer FCA610).
 +
:* Improved clock source detection.  Add SYT-Match support.
  
''16 May 2010''
+
;snd-firewire-lib:
 +
:* Internal changes related to packet handling.
  
;firewire-core:
+
;snd-fireworks:
:* fix "giving up on config rom for node id..." with some devices with bogus configuration ROM, notably Panasonic AG-DV2500 tape deck
+
:* Fix packet discontinuity with newer firmwares. Also fixed in v4.1.6 and v3.18.21.
:* fix Model_ID in modalias (sysfs variable and uevent)
+
:* more consistency checks in userspace driver interface
+
:* add FW_CDEV_IOC_GET_CYCLE_TIMER2 ioctl for choice of local clock
+
:* put <linux/firewire-*.h> files under MIT license
+
:* remove incomplete support of Bus_Time CSR
+
  
;firewire-ohci:
 
:* Work around hardware that does not provide reliable cycle timer register access.  Currently, this work around is active for the following known affected chips:  ALi, NEC, VIA, TI TSB12LV22.  A tool called [http://user.in-berlin.de/~s5r6/linux1394/utils/ test_cycle_time] exists which can be used to detect faulty chips that require addition to firewire-ohci's internal quirks list.  Reliable cycle timer access is needed for video reception timestamps and audio synchronization.
 
:* add module parameter that allows ad hoc activation of quirk fixes
 
:* fix detection of maximum available IR and IT DMA contexts
 
:* fixes for local (loopback) requests
 
  
;firedtv:
+
== Linux 4.1 ==
:* DMA mapping fixes
+
  
;ohci1394_earlyinit:
+
''21 June 2015''
:* fix boot crash regression
+
  
 +
No functional changes to the FireWire subsystem.
  
== Linux 2.6.33 ==
 
  
''24 February 2010''
+
== Linux 4.0 ==
  
This release finally adapts the firedtv DVB driver to be usable with the new stack alternatively to the old stack.  It furthermore brings a few fixes for the new stack along with the usual assortment of less visible updates.
+
''12 April 2015''
 
+
Distributors who still ship the old stack (ieee1394, ohci1394, raw1394, sbp2, eth1394 and more) should now switch to the new one (firewire-core, firewire-ohci, firewire-sbp2, firewire-net).  In the first iteration, those distributors might want to ship the old stack also (but blacklisted) as a fallback for their users if unforeseen problems with the newer replacement drivers are encountered.
+
 
+
The older FireWire stack contains several known problems which are not going to be fixed; instead, those issues are addressed by the new stack.  An incomplete list of these issues is kept in [http://bugzilla.kernel.org/show_bug.cgi?id=10046 bugzilla].  We have a [http://ieee1394.wiki.kernel.org/index.php/Juju_Migration guide] on migration from the older to the newer stack.
+
  
 
;firewire-core:
 
;firewire-core:
:* Properly support multiple concurrent FCP listeners.  This is necessary if more than one process or driver requires continuous control over AV/C devices (e.g. camcorders, tape decks, audio devices, TV tuners).
+
:: The vendor ID and model ID in the Configuration ROM root directory of Linux hosts was changed from 0xd00d1e:0x000001 to 0x001f11:0x023901This change makes firewire-core's local Configuration ROM comply with IEEE's OUI assignment rules.
:* Some small optimizations and fixes, among them improved Topology Map register handling.
+
:* Proper size check in the add_descriptor ioctlAlso fixed in Linux 2.6.32.8.
+
  
;firewire-net:
+
:: This has been made possible by Openmoko's granting a range of IDs to the Linux IEEE 1394 subsystem.  See [[IEEE OUI Assignments]] for additional information.  This change cannot have negative impact on any standard protocols, but developers of private protocols may need to adapt if they relied on these root directory entries instead of their own unit directory entries.
:* Fix a crash on SMP systems.
+
  
;firewire-ohci:
+
:: The change was also backmerged into v3.12.51.
:* Always use packet-per-buffer mode for isochronous reception, not dual-buffer mode. Reasons to do so are different behavior of the modes under some circumstances, and hardware bugs in dual-buffer mode.
+
:* Fix possible crash with unusual isochronous reception parameters ([http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2009-4138 CVE-2009-4138]).  Also fixed in Linux 2.6.32.2, 2.6.31.9, 2.6.27.42.
+
:* Fix crashes or image corruption during video reception with TSB43AB23 on 64 bit systems with more than 2 GB RAM.  Also fixed in Linux 2.6.32.8.
+
:* Fix potential breakup of isochronous transmission on some controllers, e.g. probably O2Micro controllers.
+
  
;firedtv:
+
;snd-bebob:
:* Port to new firewire stack.  Depending on whether the kernel is being configured for ieee1394 (classic stack) or firewire (new stack) or both, the firedtv driver will automatically use the proper stackThis means that FireDTV users are no longer forced to use the old stack.
+
:* Fix initialization of some M-Audio devices with Linux on big-endian CPUsAlso fixed in v3.19.5 and v3.18.13.
  
 +
;snd-firewire-lib, snd-bebob, snd-dice, snd-fireworks:
 +
:* Fix device reference counting and shutdown.  Also fixed in v3.19.2.
  
== Linux 2.6.32 ==
 
  
''2 December 2009''
+
== Linux 3.0...3.19 ==
  
This release fixes the new FireWire drivers for operation with [http://www.ffado.org/ FFADO] (FireWire audio driver framework) and brings some other, minor updates.  There are also fixes in [[Release Notes - Libraries|libraw1394]] required in order to run FFADO on top of the new drivers; these fixes have been released in libraw1394 v2.0.5.
+
''July 2011 &ndash; February 2015''
  
;firewire-core, firewire-ohci, raw1394:
+
Support of various devices and controllers was improved.  IPv6 support was added to ''firewire-net'' (v3.10).  New drivers ware added:
:* Fix a few obscure bugs which were unlikely to show up in practice.
+
:* ''sbp-target'' lets a Linux node act as a storage device (v3.5),
 +
:* ''snd-isight'' for audio capture through Apple iSight FireWire webcam (v3.0),
 +
:* ''snd-scs1x'', a MIDI driver for Stanton SCS.1d and SCS.1m FireWire DJ controllers (v3.8),
 +
:* ''snd-dice'' for audio playback through some audio devices based on TC Applied Technologies' DICE chipset (v3.13), later also for audio capture and MIDI through basically all DICE based devices (v3.19),
 +
:* ''snd-bebob'' for audio I/O through BridgeCo DM1000/DM1100/DM1500 based devices with BeBoB firmware (v3.16),
 +
:* ''snd-fireworks'' for audio I/O through Echo Digital Audio Fireworks based devices (v3.16),
 +
:* ''snd-oxfw'' for audio I/O through Oxford Semiconductor OXFW970/971 based devices (v3.19).  ''snd-oxfw'' replaced ''snd-firewire-speakers'' in v3.19 and ''snd-scs1x'' in v4.5.
 +
The audio I/O drivers are an alternative to the existing userspace drivers which [http://ffado.org/ the FFADO project] provides.  While the FFADO drivers can only be used in conjunction with [http://jackaudio.org/ JACK], the kernelspace drivers can be used with any ALSA compatible application.  However, the kernelspace drivers only implement PCM streaming and MIDI streaming, whereas device control is meant to be provided by userspace applications like ffado-mixer.
  
;firewire-ohci:
+
See [[Release Notes/3.x]].
:* Fix start-on-cycle feature of isochronous transmissions and receptions. Especially needed for FFADO.
+
:* Expose isochronous transmit cycle timestamps to firewire-core and thus to userspace drivers.  Especially needed for FFADO.
+
  
;firewire-sbp2:
 
:* Fix potential bugs: login timeout, invalid SCSI status
 
  
;firedtv:
+
== Linux 2.6.30...2.6.39 ==
:* Fix automatic retuning of DVB-C cards after temporary loss of antenna signal.
+
:* Fix I/O to Conditional Access Module.
+
:* Improve module parameter for runtime debugging.
+
  
 +
''June 2009 &ndash; May 2011''
  
== Linux 2.6.31 ==
+
The older ieee1394 driver stack was removed from the kernel after it coexisted as an alternative to the current firewire drivers until kernel 2.6.36 inclusiveMany new features and fixes went into the newer firewire driversSome new drivers were added''firewire-net'' (IPv4 over 1394, replacing the eth1394 driver), ''nosy'' (a bus sniffer, formerly maintained outside of the kernel repository), and ''snd-firewire-speakers'' (for LaCie FireWire speakers and Griffin FireWave).
 
+
''9 September 2009''
+
 
+
This release brings improved support of fine-grained access permission policies for FireWire application programs in userspace, IP networking with the new FireWire driver stack, and support for FireWire disks larger than 2 TB (this is also available in some stable kernel sub-releases before 2.6.31, see below).
+
 
+
;firewire-core, firewire-ohci, firewire-sbp2:
+
:* No longer marked as "experimental" in the kernel configuration menu. Distributors who provided the older ieee1394 driver stack so far are encouraged to build and install both driver stacks. Note, the new stack does not yet support studio audio devices, nor FireDTV DVB interfaces(Support is currently in development.)  See [[Juju Migration]] for further guidance on switching to the new drivers.
+
:* Driver source files and header files have been reorganized.  This only affects kernel driver developers.
+
 
+
;firewire-core:
+
:* Added the sysfs attribute "units" to node representations.  Its path is /sys/bus/firewire/devices/fw[0-9]+/units and it contains tuples of specifier-ID:software-version of all units found on a node.<br> This is used in new udev rules, released in udev v144, which selectively grant non-root users access to FireWire character device files of AV/C devices (camcorders, set top boxes, audio devices and more) and IIDC cameras (alias DCAM, industrial cameras and webcams) while other device types remain inaccessible to unprivileged users by default.
+
:* Be even more careful with Broadcast_Channel CSR accesses to avoid clashes with buggy firmwares.
+
:* Fixed rarely occurring bugs related to shutdown of isochronous DMA contexts and to DMA-mapping on platforms with non-cachecoherent DMA. (The latter fix introduced a regression into 2.6.31-rc1, fixed since 2.6.31-rc9.)
+
 
+
;firewire-net:
+
:* Added as new driver for IPv4 over 1394 for the new firewire stack, replacement of et1394 in the old stack.  Both eth1394 and firewire-net are still considered experimental due to some remaining, though different, bugs in them.
+
 
+
;firewire-ohci:
+
:* Fix video reception on Ricoh R5C832.
+
:* Fix video reception from more than one camera simultaneously on Agere FW643.
+
 
+
;firewire-sbp2:
+
:* Added support for disks bigger than 2 TB.  The necessary fix in our two SBP-2 initiator drivers has also been released in kernel 2.6.30.5 and 2.6.27.30.<br>  Note, volume sizes bigger than 2 TB also require specific support in the SBP-2 target chipset of FireWire disk or RAID enclosures.  This is true for any operating system as initiator, not just Linux.  Check with your enclosure vendor if in doubt.
+
:* Fix potential crash after "status write for unknown orb" events.
+
 
+
;sbp2:
+
:* Added support for disks bigger than 2 TB.  See remarks at firewire-sbp2.
+
 
+
 
+
== Linux 2.6.30 ==
+
 
+
''9 June 2009''
+
 
+
Most of the changes relate to extensions to the <linux/firewire-cdev.h> API which are required for advanced usage by FireWire-enabled userspace applications, especially IIDC video capture.
+
 
+
With these updates, the newer firewire drivers are now superior to the older ieee1394 drivers in the fields of industrial video acquisition/ machine vision/ microscopy etc. &mdash; just like the new drivers have already been superior and preferred for mass storage (SBP-2) in the last two or three kernel releases.
+
 
+
(Regarding consumer video applications, the new drivers should now be functionally on par with &mdash; yet more secure than &mdash; the old drivers.  Alas the new drivers cannot be used with studio audio equipment yet.  IP networking with the new drivers has become available in kernel 2.6.31.)
+
 
+
;firewire-core:
+
:* Optionally expose the reception timestamp of each isochronous packet, not just of interrupt packets.  This change is accompanied by an update of the constant FW_CDEV_VERSION from 1 to 2.
+
:* Add ioctls for isochronous resource management (allocation and deallocation of isochronous channels and bandwidth).  These do not only accomplish what the corresponding libraw1394 functions can do, they also implement optional kernel-assisted reallocation and deallocation.<br>  This means that client programs do not need to implement reallocation in their bus reset handler anymore and often can get rid of bus reset handlers entirely.  Also, isochronous resources can be released by the kernel if the client program crashes or shuts down improperly.  The kernel-assisted variant of resource allocation also takes care of the grace period which is to be observed after bus resets.
+
:* Add ioctl to query the maximum transmission speed to/from a given node.
+
:* Add ioctl for broadcast write requests.  This is for example useful to control multiple similar cameras at once.  For device security reasons, broadcast write requests are restricted to addresses in Units Space.
+
:* Add ioctl for asynchronous stream transmission.  Asynchronous streams are addressed to channels instead of nodes (like isochronous streams are tied to channels) but transmitted after asynchronous bus arbitrations (like asynchronous write requests, unlike isochronous streams).
+
:* Add various consistency checks to enforce proper cdev API usage.
+
:* Disallow the FW_CDEV_IOC_ADD_DESCRIPTOR ioctl on any other /dev/fw* than those of local nodes.  This is because userland will typically maintain an access policy based on unit directories that are present on each node, and this ioctl may therefore influence accessibility of local nodes' device files.
+
:* Implement Broadcast_Channel register support for conformance with the 1394a bus management specification.
+
  
;firedtv:
+
See [[Release Notes/2.6.3x]].
:* Implement tuning of DVB-S2 boxes.  Also implemented in kernel 2.6.29.1.  This fixes tuning of standard definition channels.  Reception of high definition channels is not yet implemented.
+
  
  
Line 305: Line 202:
 
''February 2007 &ndash; March 2009''
 
''February 2007 &ndash; March 2009''
  
The new alternative firewire drivers were added and gradually stabilized.  Since the new drivers were not yet feature-complete, the older ieee1394 stacked remained preferred for production but received only few minor updates during this time frame.
+
The new alternative firewire drivers were added and gradually stabilized.  Since the new drivers were not yet feature-complete, the older ieee1394 stack remained preferred for production but received only few minor updates during this time frame.
  
 
See [[Release Notes/2.6.2x]].
 
See [[Release Notes/2.6.2x]].

Latest revision as of 13:58, 13 November 2016

Release Notes: Kernel Drivers

See Release Notes - Libraries for changelogs of some IEEE 1394 userspace libraries.

Release Status

The latest stable releases of Linux IEEE 1394 drivers are those in the latest released Linux 4.x kernels.

The drivers in Linux 2.4 were considered stable too but have not been updated anymore for a long time. Therefore they lack many features and compatibility updates which went into Linux 2.6.x...4.x releases.

The following release notes only summarize more notable changes. A complete list of IEEE 1394 related changes is available via kernel.org git:


Contents


[edit] Linux 4.9

tentative release notes as per v4.9-rc4

firewire-net
  • Add missing input validation. Invalid IP-over-1394 encapsulation headers could trigger buffer overflows, potentially leading up to remote code execution (CVE-2016-8633). Also fixed in v4.8.7 and v4.4.31.
  • Fix IP-over-1394 link fragmentation headers that were read and written incorrectly, which prevented fragmented reception from/ fragmented transmission to other stacks, including Mac OS X, Windows XP, and older Linux' eth1394. Also fixed in v4.8.7 and v4.4.31.


[edit] Linux 4.8

2 October 2016

snd-firewire-tascam
  • Fix possible deadlock in hwdep interface. Also fixed in v4.7.4 and v4.4.21.
snd-fireworks
  • Fix possible deadlock in hwdep interface. Also fixed in v4.7.4, v4.4.21, v4.1.34, v3.18.43.


[edit] Linux 4.7

24 July 2016

snd-dice
  • Add support for M-Audio Profire 610, and perhaps for Profire 2626.
snd-firewire-lib
  • Add tracepoints to dump a part of isochronous packet data in order to support debugging of device quirks and of kernel-internal packet processing. The patch changelog describes how to use this feature. A subsequent commit expands the dump format.
snd-firewire-lib, snd-bebob, snd-firewire-tascam, snd-fireworks
  • Remove matching of SYT fields of the outbound stream to those of the inbound stream since it proves to be unnecessary in practice. The same was already done in snd-dice in Linux v4.6. This simplifies the kernel code and allows for finer-grained tasklet scheduling.
snd-firewire-lib, snd-bebob, snd-firewire-digi00x, snd-firewire-tascam, snd-fireworks, snd-oxfw
  • Perform sound card registration at least 2 seconds after the last IEEE 1394 bus reset. This was already implemented for snd-dice in Linux v4.5 and is now adopted by the other FireWire audio drivers. It ensures that the bus and device firmware settle into a ready state before userspace initiate I/O to the device.


[edit] Linux 4.6

15 May 2016

snd-bebob
  • internal rework related to streaming recovery after bus reset
snd-dice
  • Change how the dependency between number of available PCM and MIDI channels versus sampling rate is handled. Also affects the hw_params ioctl interface. Userspace should set the desired sampling rate before starting PCM I/O.
  • Change how phase lock is ensured and how lock status is detected.
  • Remove matching of SYT fields of the outbound stream to those of the inbound stream. This synchronization happened when the device was configured for internal clock. It required a startup delay of the outbound stream, which caused DICE II based devices to remain silent at the first attempt to start streaming.
  • Add support for previously unavailable higher PCM channels on certain devices with high channel count, notably Focusrite Saffire PRO 40, Focusrite Liquid Saffire 56, and TC Electronic Studio Konnekt 48. These devices spread the PCM and MIDI channels across 2 tx + 2 rx IEEE 1394 channels instead of just 1 tx + 1 rx IEEE 1394 channel, as most other devices do.
snd-oxfw
  • improvements to MIDI I/O


[edit] Linux 4.5

13 March 2016

snd-dice
  • Improved handling of DICE II firmware bootstrapping during device start-up.
  • Avoid time-out when PCM streaming is started.
snd-firewire-tascam
  • Add support for TASCAM FW-1804.
snd-scs1x
  • The functionality of this driver was moved to the snd-oxfw driver, and the now obsolete snd-scs1x module has been removed.


[edit] Linux 4.4

10 January 2016

firewire-ohci
  • Work around JMicron JMB38x initialization quirk. Affected isochronous transmission, e.g. audio via FFADO or ALSA. Also fixed in v4.3.3, v4.2.8, v4.1.15, v3.18.26, v3.16.35, v3.14.59, v3.12.52, v3.10.95, v3.4.113, v3.2.74.
snd-bebob
  • Fix device identifier of Mackie Onyx 1220/1620/1640 FireWire I/O card.
snd-dice
  • Fix device identifier of Mackie Onyx Blackbird and Onyx-i series.
snd-firewire-digi00x
  • New driver for Digidesign audio interfaces: Digi 002 Console, Digi 002 Rack, Digi 003 Console, Digi 003 Rack, Digi 003 Rack+. Written by Takashi Sakamoto.
snd-firewire-lib
  • Restructured and extended for wider protocol support. Data block processing is split from isochronous packet processing. This work was required for integration of snd-firewire-digi00x and snd-firewire-tascam because devices which are supported by these drivers do not comply with IEC 61883-6. Written by Takashi Sakamoto.
snd-firewire-tascam
  • New driver for TASCAM audio interfaces: FW-1082, FW-1884. Written by Takashi Sakamoto.
snd-oxfw
  • Fix Mackie Onyx Satellite packet discontinuity when device is used in base station mode.
  • Add support for TASCAM FireOne.
  • Fix calculation of MIDI ports.
  • Fix for statically linked (i.e. non-modular) builds.


[edit] Linux 4.3

1 November 2015

No functional changes to the FireWire subsystem.


[edit] Linux 4.2

30 August 2015

snd-bebob
  • Add support for
Digidesign Mbox 2 Pro
Behringer FCA610, FCA1616
  • Improve BeBoB v3 support (PrismSound Orpheus, Behringer UFX1604, Behringer FCA610).
  • Improved clock source detection. Add SYT-Match support.
snd-firewire-lib
  • Internal changes related to packet handling.
snd-fireworks
  • Fix packet discontinuity with newer firmwares. Also fixed in v4.1.6 and v3.18.21.


[edit] Linux 4.1

21 June 2015

No functional changes to the FireWire subsystem.


[edit] Linux 4.0

12 April 2015

firewire-core
The vendor ID and model ID in the Configuration ROM root directory of Linux hosts was changed from 0xd00d1e:0x000001 to 0x001f11:0x023901. This change makes firewire-core's local Configuration ROM comply with IEEE's OUI assignment rules.
This has been made possible by Openmoko's granting a range of IDs to the Linux IEEE 1394 subsystem. See IEEE OUI Assignments for additional information. This change cannot have negative impact on any standard protocols, but developers of private protocols may need to adapt if they relied on these root directory entries instead of their own unit directory entries.
The change was also backmerged into v3.12.51.
snd-bebob
  • Fix initialization of some M-Audio devices with Linux on big-endian CPUs. Also fixed in v3.19.5 and v3.18.13.
snd-firewire-lib, snd-bebob, snd-dice, snd-fireworks
  • Fix device reference counting and shutdown. Also fixed in v3.19.2.


[edit] Linux 3.0...3.19

July 2011 – February 2015

Support of various devices and controllers was improved. IPv6 support was added to firewire-net (v3.10). New drivers ware added:

  • sbp-target lets a Linux node act as a storage device (v3.5),
  • snd-isight for audio capture through Apple iSight FireWire webcam (v3.0),
  • snd-scs1x, a MIDI driver for Stanton SCS.1d and SCS.1m FireWire DJ controllers (v3.8),
  • snd-dice for audio playback through some audio devices based on TC Applied Technologies' DICE chipset (v3.13), later also for audio capture and MIDI through basically all DICE based devices (v3.19),
  • snd-bebob for audio I/O through BridgeCo DM1000/DM1100/DM1500 based devices with BeBoB firmware (v3.16),
  • snd-fireworks for audio I/O through Echo Digital Audio Fireworks based devices (v3.16),
  • snd-oxfw for audio I/O through Oxford Semiconductor OXFW970/971 based devices (v3.19). snd-oxfw replaced snd-firewire-speakers in v3.19 and snd-scs1x in v4.5.

The audio I/O drivers are an alternative to the existing userspace drivers which the FFADO project provides. While the FFADO drivers can only be used in conjunction with JACK, the kernelspace drivers can be used with any ALSA compatible application. However, the kernelspace drivers only implement PCM streaming and MIDI streaming, whereas device control is meant to be provided by userspace applications like ffado-mixer.

See Release Notes/3.x.


[edit] Linux 2.6.30...2.6.39

June 2009 – May 2011

The older ieee1394 driver stack was removed from the kernel after it coexisted as an alternative to the current firewire drivers until kernel 2.6.36 inclusive. Many new features and fixes went into the newer firewire drivers. Some new drivers were added: firewire-net (IPv4 over 1394, replacing the eth1394 driver), nosy (a bus sniffer, formerly maintained outside of the kernel repository), and snd-firewire-speakers (for LaCie FireWire speakers and Griffin FireWave).

See Release Notes/2.6.3x.


[edit] Linux 2.6.20...2.6.29

February 2007 – March 2009

The new alternative firewire drivers were added and gradually stabilized. Since the new drivers were not yet feature-complete, the older ieee1394 stack remained preferred for production but received only few minor updates during this time frame.

See Release Notes/2.6.2x.


[edit] Linux 2.6.12...2.6.19

June 2005 – November 2006

This is a stabilization phase of the ieee1394 driver stack in Linux 2.6.

See Release Notes/2.6.1x.

Personal tools