1.\" 2.\" Copyright (c) 2026 Abdelkader Boudih <freebsd@seuros.com> 3.\" 4.\" SPDX-License-Identifier: BSD-2-Clause 5.\" 6.Dd July 12, 2026 7.Dt FWDV 4 8.Os 9.Sh NAME 10.Nm fwdv 11.Nd AV/C DV capture driver for FireWire camcorders 12.Sh SYNOPSIS 13.Cd "device firewire" 14.Cd "device fwdv" 15.Sh DESCRIPTION 16The 17.Nm 18driver provides DV frame capture from AV/C tape devices attached via 19IEEE 1394 (FireWire), including DV camcorders, VCRs, and DV converters. 20.Pp 21The driver attaches to unit directories in the device CSR configuration ROM 22with 23.Va unit_spec_id 240x00a02d (1394 Trade Association) and 25.Va unit_sw_version 260x010001 (AV/C). 27When a matching device is present on the 28.Xr firewire 4 29bus, the driver creates 30.Pa /dev/fwdvX 31and begins receiving IEC 61883 isochronous packets on first open, 32assembling complete DV frames. 33Applications read raw DV frames from the character device 34and control tape transport through 35.Xr ioctl 2 . 36.Pp 37Both NTSC and PAL SD-DV streams are detected from the incoming CIP header. 38DVCPRO HD frame sizing is also recognized. 39.Sh IOCTLS 40.Bl -tag -width ".Dv FWDV_GINFO" 41.It Dv FWDV_GINFO Pq Vt "struct fwdv_info" 42Return driver state, active ISO channel, detected DV system, frame size, 43frame counters, dropped frame count, device EUI-64, and vendor/model strings 44from the device configuration ROM. 45.It Dv FWDV_PLAY 46Send the AV/C play command to tape subunit 0. 47.It Dv FWDV_STOP 48Send the AV/C stop command to tape subunit 0. 49.It Dv FWDV_FFWD 50Send the AV/C fast-forward command to tape subunit 0. 51.It Dv FWDV_REW 52Send the AV/C rewind command to tape subunit 0. 53.El 54.Sh SYSCTLS 55.Bl -tag -width ".Va hw.firewire.fwdv.iso_channel" 56.It Va hw.firewire.fwdv.iso_channel 57Fallback isochronous receive channel. 58The default is 63. 59If the device output plug control register reports an active channel, that 60device-reported channel is used instead. 61This value can be set as a tunable in 62.Xr loader.conf 5 . 63.El 64.Sh FILES 65.Bl -tag -width ".Pa /dev/fwdvX" -compact 66.It Pa /dev/fwdvX 67DV capture character device. 68Read to obtain raw DV frames. 69.El 70.Sh SEE ALSO 71.Xr firewire 4 , 72.Xr fwohci 4 73.Pp 74AV/C Digital Interface Command Set General Specification 4.1, 751394 Trade Association Document 2001012. 76.Pp 77IEC 61883-1 and IEC 61883-2. 78.Sh HISTORY 79The 80.Nm 81driver first appeared in 82.Fx 16.0 . 83.Sh AUTHORS 84.An Abdelkader Boudih Aq Mt freebsd@seuros.com 85