FWCTL(8)

NAME
fwctl - IEEE1394 control utility

SYNOPSIS
fwctl [-prt] [-b pri_req] [-c node] [-d node] [-g gap_count] [-l file] [-m EUI64 | hostname] [-o node] [-R filename] [-S filename] [-s node] [-u bus_num]

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

The following options are available:

-b pri_req
    Set the PRIORITY_BUDGET register on all supported nodes.

-c node
    Show the configuration ROM on the node.

-d node
    Hex dump of the configuration ROM.

-g gap_count
    Broadcast gap_count by phy_config packet.

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

-m EUI64 | hostname
    Set default fwmem target. Hostname will be converted to EUI64.

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

-p  Dump PHY registers.

-R filename
    Receive DV stream and dump it to a file. Use Ctrl-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.ieee1394if.try_bmr=0
        fwctl -r

    The resulting file contains raw DV data excluding isochronous header and CIP header. It can be handled by the pkgsrc/multimedia/libdv package.

-r  Initiate bus reset.

-S filename
    Send a DV file as isochronous stream.

-s node
    Write to the RESET_START register on the node.

-t  Show the topology map.

-u bus_num
    Specify the IEEE1394 bus number to be operated on.

FILES

/dev/fw0.0

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

    fwctl -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 | fwctl -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
fwip(4), fwohci(4), ieee1394if(4), sbp(4)

HISTORY
The fwctl command first appeared in FreeBSD 5.0, as fwcontrol. It was added to NetBSD 4.0 under its present name.

AUTHORS
Hidetoshi Shimokawa <simokawa@FreeBSD.org> KIYOHARA Takashi <kiyohara@NetBSD.org>

BUGS
This utility is still under development and provided for debugging purposes.