blob: d03d7c03312e7f4ed6ee0ff95e53bee83ccd67b9 [file] [log] [blame]
Linux FireWire subsystem
2024/04/02 Takashi Sakamoto
.. contents:: Contents
:depth: 2
:backlinks: top
This section provides the viewers the information about what to be described in the series of
documentation so that the viewers get an understanding of the subsystem by the provided
information in the documentation. However, the viewers get no learning and tasks from the
IEEE 1394 as known as FireWire is the technology established between the late of 1980's and the
beginning of 1990's. The specification is firstly published in 1995, then commercialized. Many
consumer equipments were produced until around 2010, then the market was shrank and disappeared.
As of 2023, IEEE 1394 is legacy technology.
Linux kernel has a subsystem for the technology. This document includes helpful information about
the subsystem. If interested in the subsystem itself, :doc:`About the subsystem <about>` is a good
entrance. If requiring update history of the documentation,
:ref:`About documentation <about-documentation>` will a good help.
Communication channel
This section provides the viewers the information about the way to communicate with the users and
developers, as well as code of conduct in the communication.
* `linux1394-devel <>`_ is dedicated
for upstream development
* `linux1394-user <>`_ is dedicated
for user support
Before using the channels, please take a look at
`Code of Conduct <>`_
in Linux kernel development community.
Support and Contribution
This section provides the viewers the information about contribution to the subsystem. Especially
the items which we expected and we do not expected.
As of 2023, few developers work to use the subsystem. We appreciate any type of help for it. For
example, below items are welcome.
* Donate Configuration ROM image for your device
* Distribution packaging for maintained libraries and tools
* Bug fixes for libraries
* Bug reports to kernel drivers
Due to the limited human resources you may not receive enough support in an user level, especially
applications in user space for which the original developer is already inactive. You could receive
less help for items below.
* How to use an application?
* Why my device is not available?
Provided documents
This section provides the viewers the information about included documents.
.. toctree::
* :doc:`About the subsystem <about>`
* The overview of subsystem is available.
* :doc:`Database of PHY device IDs <phy>`
* The database of PHY device embedded in 1394 OHCI hardware.
* :doc:`Migration from old driver stack <migration>`
* Linux kernel 2.6.37 or before includes old generation of stack. The guide provides the way to
migrate to the current generation of stack.
* :doc:`Specifications <specifications>`
* The subsystem is based on specifications relevant to IEEE 1394. The document provides their list.
* :doc:`Page design <design>`
* The look of document is governed by the consistent design. The document provides the information
about it.
This section provides the viewers the information about the subsystem, libraries, utilities, and
resources. Especially for package maintainers in Linux distribution the way to retrieve their
package archive.
In the subsystem, kernel stack is mainly maintained. Some library, utility, resource are available
in below repositories as well.
* Kernel stack
* `<>`_
.. * Maintained by Takashi Sakamoto
* Libraries
* `libhinawa <>`_
* `<>`_
* Operate OHCI 1394 hardware for asynchronous communication with GObject Introspection support
* `libhinoko <>`_
* `<>`_
* Operate OHCI 1394 hardware for isochronous communication with GObject Introspection support
* hinawa-rs
* `<>`_
* Provides FFI sys crate `hinawa-sys <>`_ and
user API crate `hinawa <>`_ for libhinawa as Rust language bindings
* hinoko-rs
* `<>`_
* Provides FFI sys crate `hinoko-sys <>`_ and
user API crate `hinoko <>`_ for libhinoko as Rust language bindings
* :doc:`libraw1394 <libraw1394>`
* `<>`_
* The latest release is
`v2.1.2 <>`_
(`v2.1.2 signature <>`_)
* :doc:`libiec61883 <libiec61883>`
* `<>`_
* The latest release is
`v1.2.0 <>`_
(`v1.2.0 signature <>`_)
* Utilities
* linux-firewire-utils
* `<>`_
* Linux FireWire bus inspection and configuration tools.
* Fork `<>`_ to replace ``crpp`` Python 2
* Resources
* (T.B.D)
Maintenance schedule
This section provides the viewers the information about schedule to maintain the subsystem for
the next six years.
As you know, IEEE 1394 is enough legacy. Sooner or later, users would leave. This subsystem has a
time table to close the project.
* 2023, 2024, 2025, 2026
* ``Done``: Replace the subsystem maintainer
* Set up repositories in `<>`_
* ``Done``: Refresh web site and update information
* Get any help from Linux Foundation to place documents for specification defined by 1394 Trade
* If no problems, upload the documents to the web site
* Fix issues of subsystem
* Pull requests to Linus
* Take over the administration of communication channels
* Adding the list archive of linux1394-devel to ` <>`_
* Invite repositories of external librararies (``libavc1394``, ``libdc1394``)
* Announcement to distribution package maintainers about the upstream shift
* 2027, 2028
* Close announcement to applications
* `FFMPEG <>`_
* `GStreamer <>`_
* `VLC <>`_
* `MythTV <>`_
* `UniCap <>`_
* `FFADO <>`_
* 2029
* Close the project
* Close the communication channels
* Resign the subsystem maintainer
After closing the project, the libraries, utilities, and resources are never updated, while
software archives are available in The kernel stack has no maintainer, and would be
possiblely removed from Linux operating system any day.
.. _about-documentation:
About documentation
This section provides the viewers the information about this documentation.
- the location of repository
- the hosting service
- the archive of old wiki
* The source of document is hosted in
* You can see the update history as well.
* The documentation is published at `<>`_
* The subdomain URL is `<>`_.
* The shared domain URL is `<>`_.
* The host system provides `hook script service <>`_.
* Some document is converted from `old archive <>`_.