NAME

edsu - Qualcomm Atheros Ethernet II Data Send Utility

SYNOPSIS

edsu [options] file [file] [...]

DESCRIPTION

Send one or more files as a series of Ethernet II (IEEE 802.2) frames. Input files are sequentially read and sent over network as a continuous stream of standard Ethernet frames. All frames (except perhaps the last frame for each file) will contain 1500 bytes of file data. The receiving host may elect to concatenate frame data as frames arrive.

This program can be used to test remote Atheros UART-enabled powerline devices. The remote UART-enabled powerline device will remove frame headers and forward frame data to the local host as a serial data stream. No protocol is imposed on the serial data stream. For example, there is no indication of frame or file start or end within the stream. The retmote powerline device must be in Transparent Mode and configured to accept frames from the sending host. The remote host must also be ready to handle serial data as it arrives.

OPTIONS

-d xx:xx:xx:xx:xx:xx

The Ethernet address of the destination device. If the destination device is a Linux, Mac OSX or Windows host then program edru can be used to receive and write frame data to stdout as a serial stream. If the destination device is an Atheros UART-enabled powerline device then received frame data will be converted to a serial data stream and forwared to the host connected to that device. In that case, the UART-enabled powerline device must be programmed with the address of the sending host.

-e ethertype

The protocol (or ethertype) of interest expressed as a 16-bit hexadecimal integer. Prefix "0x" is optional. This filters out frames having any other ethertype. The default is ETH_P_802_2 as defined in if_ether.h.

-i interface

The host interface used to send frames. The program default is "eth1" on Linux, "en0" on MacOSX or OpenBSD and "2" on Windows; however, if environment string "PLC" is defined, it supersedes the program default. Any interface specified on the command line supersedes all others.

-p seconds

Pause time in seconds between sending each frame. Pauses may be necessary when the destination device is a UART-enabled powerline device because each frame must be converted and transmitted serially from the remote device to the remote host. Permitted pause times are 0 through 255 seconds. The default is 0.

-q

Quiet mode. This option has no effect at this time.

-v

Verbose mode. This option displays outgoing frames on stdout in hexadecimal dump format as they are sent.

ARGUMENTS

file

The name of a text or binary file accessible from the local host.

EXAMPLES

The following example sends files abc.txt then def.bin to the remote Atheros UART-enabled powerline device 00:B0:52:BA:BE:55 over network interface eth1. There is a constant 1 second delay between each frame sent so that remote UART-enabled powerline devices have time to convert and forward each frame to their local host.

# edsu -ieth1 -d 00:b0:52:BA:BE:55 abc.txt def.bin

SEE ALSO

amp(1), edru(1) efsu(1),

CREDITS

Charles Maier