FWCONTROL(8)

NAME
fwcontrol - FireWire control utility

SYNOPSIS
fwcontrol [-rt] [-c node] [-d node] [-o node] [-s node] [-l file] [-g gap_count] [-b pri_req] [-R filename] [-S filename]

DESCRIPTION
The fwcontrol utility is designed to provide a way for users to access and control the FireWire subsystem. Without options, fwcontrol will output a list of devices those are/were connected to the bus.

-r  Initiate bus reset.

-t  Show the topology map.

-c node
    Show the configuration ROM on the node.

-d node
    Hex dump of the configuration ROM.

-o node
    Send a link-on phy packet to the node.

-s node
    Write to RESET_START register on the node.

-l file
    Load hex dump file of the configuration ROM and parse it.

-g gap_count
    Broadcast gap_count by phy_config packet.

-i pri_req
    Set PRIORITY_BUDGET register on all supported nodes.

-R filename
    Receive DV stream and dump it to a file. Use Ctl-C to stop the receiving. Some DV cameras seem not to send the stream if a bus manager exits. If you cannot get the stream, try the following commands.

        sysctl hw.firewire.try_bmr=0; fwcontrol -r

    The resulting file contains raw DV data excluding isochronous header and CIP header. It can be handled by libdv in the dports(7) collection.

-S filename
    Send a DV file as isochronous stream.

FILES

/dev/fw0

EXAMPLES
Each DV frame has fixed size and it is easy to edit those frame order.

    fwcontrol -R original.dv

Receive stream.

    dd if=original.dv of=first.dv bs=120000 count=30

Get first 30 frames(NTSC).

    dd if=original.dv of=second.dv bs=120000 skip=30 count=30

Get second 30 frames(NTSC).

    cat second.dv first.dv | fwcontrol -S /dev/stdin

Swap first and second 30 frames and send them to DV recorder.

For PAL, replace 'bs=120000' with 'bs=144000'.

SEE ALSO
firewire(4), fwe(4), fwohci(4), sbp(4)

HISTORY
The fwcontrol utility first appeared in FreeBSD 5.0.

AUTHORS
Hidetoshi Shimokawa <simokawa@FreeBSD.org>

BUGS
This utility is still under development and provided for debug purpose.