firewire-phy-command is a utility to set low-level configuration parameters and to manage port power
saving.
In the following commands, numbers must be specified in decimal, or in hexadecimal with a "0x" prefix.
node is either the device file (/dev/fw*) of the node that is to be accessed, or the node number.
The following commands are available:
firewire-phy-commandconfig [rootnode] [gapcountgapcount]
The root parameter specifies the node that is forced to become the next root node.
The gapcount parameter specifies a timing parameter used to optimize performance. This must be
derived from the actual worst-case round-trip delay between any two nodes.
At least one of root or gapcount must be specified.
The configuration changes take effect after the next bus reset, which must be issued immediately
after this command; see the reset command below.
firewire-phy-commandpingnode
Send a ping packet to node node, and print node's answer (its self ID) together with the round-
trip time.
firewire-phy-commandreadnode [pageport] register
Read a PHY register on node node and print the register value.
Registers 0 to 7 are global; registers 8 to 15 are paged and require both a page number and a port
number.
firewire-phy-commandnopnodeportfirewire-phy-commanddisablenodeportfirewire-phy-commandenablenodeportfirewire-phy-commandsuspendnodeportfirewire-phy-commandresumenodeportfirewire-phy-commandclearnodeport
Send a remote command packet to port port of node node, and print the new port status.
nop Do nothing, just return the status. This can be used to read the port status, or to check
whether a port exists.
disable
Disable the port and its connected peer port. This is the equivalent of breaking the
connection between the port and the cable.
enable Re-enable a disabled port.
suspend
Suspend the connection between the port and its peer port, and recursively suspend all
other active ports on the peer port's node.
resume Resume the port and all other ports in the suspended domain.
clear Clear the port's fault status bit(s). If a port entered the suspended state in a faulted
condition because its peer port did not suspend correctly, clearing the fault is required
after the resume to continue normal operation.
firewire-phy-commandresume
Broadcast a resume packet to all ports on the bus.
firewire-phy-commandlinkonnode
Send a link-on packet, which instructs node node to switch on, i.e., to come out of powersaving
mode.
firewire-phy-commandreset
Issue a bus reset.