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