NAME

       plcmdio32 - Qualcomm Atheros 32-bit MDIO Register Editor

SYNOPSIS

       plcmdio32 [options] [device] [device] [...]

DESCRIPTION

       Read  or  write global MDIO registers using multiple VS_MDIO_COMMAND vendor-specific management messages.
       Commands are entered using 32-bit register and data  values  then  converted  to  threeequivalen   16-bit
       commands.   The default operation is to read a register.  Registers are written only if data is specified
       on the command line.  Thsi program replaces program int6kmdio2.

       This program writes MDIO instructions using 802.3ae Clause 45  (address,  data  and  mask)  format.   See
       program  int6kmdio  for a similar program to write instructions using 802.3 Clause 22 (phy, reg, data and
       mask) format.

       This program is part of the Qualcomm Atheros Powerline Toolkit.  It replaces legacy  program  int6kmdio2.
       See the plc man page for an overview and installation instructions.

OPTIONS

       -a address
              The  19-bit  global  register  address.   Some  devices  may  not  support all possible addresses.
              Addresses may be expressed in decimal, hexadecimal or binary notation.  Hexadecimal values must be
              prefixed with "0x" or "0X".  Binary values must be prefixed with "0b" or "0B".

       -d data
              A 32-bit data value to be inserted into the specified  register.   The  specified  data  value  is
              written  when  this option is present; otherwise the specified register is read and the content is
              displayed.  Data values may be expressed in decimal, hexadecimal or binary notation.   Hexadecimal
              values are prefixed with "0x" or "0X".  Binary values are prefixed with "0b" or "0B".

       -e     Redirects  stderr  messages  to  stdout.   By  convention status and error messages are printed on
              stderr while primary program output is printed on stdout.  This option prints all output on stdout
              in cases where this is desired.

       -h     When writing 32-bit values, write to the high-order register before the low-order register.   This
              option  is  needed  in cases where the value in one register may affect the interpretation of some
              value written to the other register.  This is not a common situation.

       -i interface
              Select the host Ethernet interface.  All requests are  sent  via  this  host  interface  and  only
              reponses  received  via this host interface are recognized.  The default interface is eth1 because
              most people use eth0 as their principle network connection; however, if environment  string  "PLC"
              is defined then it takes precedence over the default interface.  This option then takes precedence
              over either default.

       -q     Suppresses status messages on stderr.

       -v     Prints  additional  information  on  stdout.   In  particular, this option dumps outgoing Ethernet
              packets on stdout.

       -?,--help
              Displays program help information on stderr.  This option takes precedence over all other  options
              on the command line except version information.

       -!,--version
              Displays  program  version  information  on  stderr.   This option takes precedence over all other
              options on the command line except help information.  Use this option when sending screen dumps to
              Atheros technical staff.

ARGUMENTS

       device The MAC address of some powerline device.  More than one address may be specified.  If  more  than
              one  address  is  specified  then  operations  are  performed on each device in turn.  The default
              address is local.  See DEVICES for information about symbolic device addresses.

DEVICES

       Powerline devices use Ethernet Media Access Control (MAC) addresses.  A MAC address  is  a  48-bit  value
       entered  as  12 hexadecimal digits in upper, lower or mixed character case.  Octets may be separated with
       colons for clarity.  For example, "00b052000001", "00:b0:52:00:00:01" and "00b052:000001" are  valid  and
       equivalent.

       The following MAC addresses are special and may be entered by name instead of number.

       all    Same as "broadcast".

       broadcast
              A  synonym  for  the  Ethernet  broadcast address, FF:FF:FF:FF:FF:FF.  All devices, whether local,
              remote or foreign recognize messages sent to this address.  A remote device is any device  at  the
              far end of a powerline connection.  A foreign device is any device not manufactured by Atheros.

       local  A   synonym   for   the   Qualcomm   Atheros  vendor  specific  Local  Management  Address  (LMA),
              00:B0:52:00:00:01.  All local Atheros devices  recognize  this  address  but  remote  and  foreign
              devices  do  not.   A  remote  device  is  any device at the far end of a powerline connection.  A
              foreign device is any device not manufactured by Atheros.

REFERENCES

       See the Qualcomm Atheros HomePlug AV Firmware Technical Reference Manual for technical information.

DISCLAIMER

       Atheros HomePlug AV Vendor Specific Management Message structure and content is proprietary  to  Qualcomm
       Atheros, Ocala FL USA.  Consequently, public information may not be available.  Qualcomm Atheros reserves
       the  right  to modify message structure and content in future firmware releases without any obligation to
       notify or compensate users of this program.

EXAMPLES

       None.

SEE ALSO

       plc(1), plcmod(1), plcmdio16(1), mdioblock(1), mdioblock2(1), mdiodump(1), mdiogen(1)

CREDITS

        Nathaniel Houghton
        Charles Maier

open-plc-utils-0.0.3                              November 2013                                     plcmdio32(1)