xref: /freebsd/share/man/man4/fwdv.4 (revision 2b9ed8da552c5825bf261214665a48f81999db0d)
123a6997eSAbdelkader Boudih.\"
223a6997eSAbdelkader Boudih.\" Copyright (c) 2026 Abdelkader Boudih <freebsd@seuros.com>
323a6997eSAbdelkader Boudih.\"
423a6997eSAbdelkader Boudih.\" SPDX-License-Identifier: BSD-2-Clause
523a6997eSAbdelkader Boudih.\"
6*2b9ed8daSAbdelkader Boudih.Dd July 12, 2026
723a6997eSAbdelkader Boudih.Dt FWDV 4
823a6997eSAbdelkader Boudih.Os
923a6997eSAbdelkader Boudih.Sh NAME
1023a6997eSAbdelkader Boudih.Nm fwdv
1123a6997eSAbdelkader Boudih.Nd AV/C DV capture driver for FireWire camcorders
1223a6997eSAbdelkader Boudih.Sh SYNOPSIS
1323a6997eSAbdelkader Boudih.Cd "device firewire"
1423a6997eSAbdelkader Boudih.Cd "device fwdv"
1523a6997eSAbdelkader Boudih.Sh DESCRIPTION
1623a6997eSAbdelkader BoudihThe
1723a6997eSAbdelkader Boudih.Nm
1823a6997eSAbdelkader Boudihdriver provides DV frame capture from AV/C tape devices attached via
1923a6997eSAbdelkader BoudihIEEE 1394 (FireWire), including DV camcorders, VCRs, and DV converters.
2023a6997eSAbdelkader Boudih.Pp
21*2b9ed8daSAbdelkader BoudihThe driver attaches to unit directories in the device CSR configuration ROM
22*2b9ed8daSAbdelkader Boudihwith
23*2b9ed8daSAbdelkader Boudih.Va unit_spec_id
24*2b9ed8daSAbdelkader Boudih0x00a02d (1394 Trade Association) and
25*2b9ed8daSAbdelkader Boudih.Va unit_sw_version
26*2b9ed8daSAbdelkader Boudih0x010001 (AV/C).
27*2b9ed8daSAbdelkader BoudihWhen a matching device is present on the
2823a6997eSAbdelkader Boudih.Xr firewire 4
29*2b9ed8daSAbdelkader Boudihbus, the driver creates
3023a6997eSAbdelkader Boudih.Pa /dev/fwdvX
3123a6997eSAbdelkader Boudihand begins receiving IEC 61883 isochronous packets on first open,
3223a6997eSAbdelkader Boudihassembling complete DV frames.
3323a6997eSAbdelkader BoudihApplications read raw DV frames from the character device
3423a6997eSAbdelkader Boudihand control tape transport through
3523a6997eSAbdelkader Boudih.Xr ioctl 2 .
3623a6997eSAbdelkader Boudih.Pp
3723a6997eSAbdelkader BoudihBoth NTSC and PAL SD-DV streams are detected from the incoming CIP header.
3823a6997eSAbdelkader BoudihDVCPRO HD frame sizing is also recognized.
3923a6997eSAbdelkader Boudih.Sh IOCTLS
4023a6997eSAbdelkader Boudih.Bl -tag -width ".Dv FWDV_GINFO"
4123a6997eSAbdelkader Boudih.It Dv FWDV_GINFO Pq Vt "struct fwdv_info"
4223a6997eSAbdelkader BoudihReturn driver state, active ISO channel, detected DV system, frame size,
4323a6997eSAbdelkader Boudihframe counters, dropped frame count, device EUI-64, and vendor/model strings
4423a6997eSAbdelkader Boudihfrom the device configuration ROM.
4523a6997eSAbdelkader Boudih.It Dv FWDV_PLAY
4623a6997eSAbdelkader BoudihSend the AV/C play command to tape subunit 0.
4723a6997eSAbdelkader Boudih.It Dv FWDV_STOP
4823a6997eSAbdelkader BoudihSend the AV/C stop command to tape subunit 0.
4923a6997eSAbdelkader Boudih.It Dv FWDV_FFWD
5023a6997eSAbdelkader BoudihSend the AV/C fast-forward command to tape subunit 0.
5123a6997eSAbdelkader Boudih.It Dv FWDV_REW
5223a6997eSAbdelkader BoudihSend the AV/C rewind command to tape subunit 0.
5323a6997eSAbdelkader Boudih.El
5423a6997eSAbdelkader Boudih.Sh SYSCTLS
5523a6997eSAbdelkader Boudih.Bl -tag -width ".Va hw.firewire.fwdv.iso_channel"
5623a6997eSAbdelkader Boudih.It Va hw.firewire.fwdv.iso_channel
5723a6997eSAbdelkader BoudihFallback isochronous receive channel.
5823a6997eSAbdelkader BoudihThe default is 63.
5923a6997eSAbdelkader BoudihIf the device output plug control register reports an active channel, that
6023a6997eSAbdelkader Boudihdevice-reported channel is used instead.
6123a6997eSAbdelkader BoudihThis value can be set as a tunable in
6223a6997eSAbdelkader Boudih.Xr loader.conf 5 .
6323a6997eSAbdelkader Boudih.El
6423a6997eSAbdelkader Boudih.Sh FILES
6523a6997eSAbdelkader Boudih.Bl -tag -width ".Pa /dev/fwdvX" -compact
6623a6997eSAbdelkader Boudih.It Pa /dev/fwdvX
6723a6997eSAbdelkader BoudihDV capture character device.
6823a6997eSAbdelkader BoudihRead to obtain raw DV frames.
6923a6997eSAbdelkader Boudih.El
7023a6997eSAbdelkader Boudih.Sh SEE ALSO
7123a6997eSAbdelkader Boudih.Xr firewire 4 ,
7223a6997eSAbdelkader Boudih.Xr fwohci 4
7323a6997eSAbdelkader Boudih.Pp
7423a6997eSAbdelkader BoudihAV/C Digital Interface Command Set General Specification 4.1,
7523a6997eSAbdelkader Boudih1394 Trade Association Document 2001012.
7623a6997eSAbdelkader Boudih.Pp
7723a6997eSAbdelkader BoudihIEC 61883-1 and IEC 61883-2.
7823a6997eSAbdelkader Boudih.Sh HISTORY
7923a6997eSAbdelkader BoudihThe
8023a6997eSAbdelkader Boudih.Nm
8123a6997eSAbdelkader Boudihdriver first appeared in
8223a6997eSAbdelkader Boudih.Fx 16.0 .
8323a6997eSAbdelkader Boudih.Sh AUTHORS
8423a6997eSAbdelkader Boudih.An Abdelkader Boudih Aq Mt freebsd@seuros.com
85