FWCONTROL(8)

NAME

     fwcontrol -- FireWire control utility

SYNOPSIS

     fwcontrol [-u bus_num] [-prt] [-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 FreeBSD FireWire subsystem.  Without options, fwcontrol
     will output a list of devices that are/were connected to the bus.

     The following options are available:

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

     -r      Initiate bus reset.

     -t      Show the topology map.

     -p      Dump PHY registers.

     -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 the 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 the PRIORITY_BUDGET register on all supported nodes.

     -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.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 FreeBSD
	     Ports Collection.

     -S filename
	     Send a DV file as isochronous stream.

EXAMPLES

     Each DV frame has a fixed size and it is easy to edit the 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''.

FILES

     /dev/fw0.0

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 debugging pur-
     poses.