summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/firewire.4 3.html
blob: 8b34ad1c0d7b9f6f5ddc514ae1d3ba0fb1755635 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<table class="head">
  <tr>
    <td class="head-ltitle">FIREWIRE(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">FIREWIRE(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">firewire</code> &#x2014;
    <span class="Nd">IEEE1394 High-performance Serial Bus</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following line
    in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device firewire</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
    the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>firewire_load=&quot;YES&quot;</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DEPRECATION_NOTICE"><a class="permalink" href="#DEPRECATION_NOTICE">DEPRECATION
  NOTICE</a></h1>
<p class="Pp">The <code class="Nm">firewire</code> driver is slated to be
    removed prior to <span class="Ux">FreeBSD 16.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp"><span class="Ux">FreeBSD</span> provides machine-independent bus
    support and raw drivers for <code class="Nm">firewire</code> interfaces.</p>
<p class="Pp">The <code class="Nm">firewire</code> driver consists of two
    layers: the controller and the bus layer. The controller attaches to a
    physical bus (like <a class="Xr">pci(4)</a>). The
    <code class="Nm">firewire</code> bus attaches to the controller. Additional
    drivers can be attached to the bus.</p>
<p class="Pp">Up to 63 devices, including the host itself, can be attached to a
    <code class="Nm">firewire</code> bus. The root node is dynamically assigned
    with a PHY device function. Also, the other <code class="Nm">firewire</code>
    bus specific parameters, e.g., node ID, cycle master, isochronous resource
    manager and bus manager, are dynamically assigned, after bus reset is
    initiated. On the <code class="Nm">firewire</code> bus, every device is
    identified by an EUI 64 address.</p>
<p class="Pp">Debugging over the firewire interface is possible with the
    <a class="Xr">dcons(4)</a> driver. Please see
    <a class="Lk" href="https://docs.freebsd.org/en/books/developers-handbook/kerneldebug/#kerneldebug-dcons">https://docs.freebsd.org/en/books/developers-handbook/kerneldebug/#kerneldebug-dcons</a>
    for details on how to setup debugging with firewire.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag Bl-compact">
  <dt><span class="Pa">/dev/fw0.0</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
  <dt><span class="Pa">/dev/fwmem0.0</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">dcons(4)</a>, <a class="Xr">fwe(4)</a>,
    <a class="Xr">fwip(4)</a>, <a class="Xr">fwohci(4)</a>,
    <a class="Xr">pci(4)</a>, <a class="Xr">sbp(4)</a>,
    <a class="Xr">eui64(5)</a>, <a class="Xr">fwcontrol(8)</a>,
    <a class="Xr">kldload(8)</a>, <a class="Xr">sysctl(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">firewire</code> driver first appeared in
    <span class="Ux">FreeBSD 5.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">firewire</code> driver was written by
    <span class="An">Katsushi Kobayashi</span> and <span class="An">Hidetoshi
    Shimokawa</span> for the <span class="Ux">FreeBSD</span> project.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">See <a class="Xr">fwohci(4)</a> for security notes.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">January 23, 2025</td>
    <td class="foot-os">FreeBSD 15.0</td>
  </tr>
</table>