edsu.1
Author: cmaier@cmassoc.net

    edsu(1)                                      Qualcomm Atheros Open Powerline Toolkit                                     edsu(1)

    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 ret‐
           mote 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  inter‐
                  face 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 <cmaier@qca.qualcomm.com>

    open-plc-utils-0.0.3                                        Mar 2014                                                     edsu(1)

[PREV] [HOME] [NEXT]