NAME

       plcotst - PLC One-Time Self-Test Manager

SYNOPSIS

       plcotst [options] [device] [device] [...]

DESCRIPTION

       Manage  the PLC One-Time Self-Test feature on Atheros powerline devices.  Normally, selftest is performed
       once, on startup at the factory, but it can  also  be  configured  and  run  again  using  this  utility.
       Selftest results are stored by the firmware and can be read using this utility, as well.  The selftest is
       configured  when configuration options are specified on the command line; otherwise, selftest results are
       read or cleared.

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

OPTIONS

       -c version
              Configuration version number.  Permitted values are 0 through 255.  The default is 0.  This option
              applies to both selftest configuration and selftest results.

       -C     Clear stored selftest results.  This option clears stored selftest results.  This  option  implies
              selftest results and supercedes options -d, -f, -m, -r and -R, if present on the command line.

       -d seconds
              Delay  selftest  after reboot.  Permitted delay times are 0 through UINT_MAX seconds.  The default
              is 0 seconds.  This option implies selftest configuration and supercedes option -C, if present  on
              the command line.

       -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.

       -f count
              Run the flash memory selftest count times.  Valid values are 0 through UINT_MAX.  The default is 0
              which effectively suppresses the test.  This option implies selftest configuration and  supercedes
              option -C, if present on the command line.

       -m count
              Run the memory selftest count times.  Valid values are 0 through UINT_MAX.  The default is 0 which
              suppresses effectively the test.  This option implies selftest configuration and supercedes option
              -C, if present on the command line.

       -q     Suppresses status messages on stderr.

       -r flag
              Run  selftest  after reboot.  Permitted values are 0 through 255.  Expected values are 0 for false
              and 1 for true.  The default is 1.  If the memory test count and flash test count are  both  0  no
              testing will occur when the time comes.  This option implies selftest configuration and supercedes
              option -C, if present on the command line.

       -R flag
              Reset device after selftest.  Permitted values are 0 through 255.  Expected values are 0 for false
              and  1  for  true.   The  default  is  0.   This option applies to selftest configuration only and
              supercedes option -C, if present on the command line.

       -t timeout
              Read timeout in milliseconds.  Values range from 0 through UINT_MAX.  This  is  the  maximum  time
              allowed for a response.  The default is shown in brackets on the program menu.

       -v     Print  additional  information  on stdout.  In particular, this option dumps incoming and outgoing
              packets which can be saved as text files for reference.

       -?,--help
              Print program help summary on stdout.  This option takes precedence  over  other  options  on  the
              command line.

       -!,--version
              Print  program  version information on stdout.  This option takes precedence over other options on
              the command line.  Use this option when sending screen dumps to Atheros Technical Support so  that
              they know exactly which version of the Linux Toolkit you are using.

ARGUMENTS

       device The Ethernet hardware address of some powerline device.  More than one address may be specified on
              the  command  line.   If  more than one address is specified then operations are performed on each
              device in turn.  The default address is local.  as explained in the DEVICES section.

EXAMPLES

       The following example prints stored test results for the local device on stdout because  no  options  are
       specified on the command line.

          # plcotst

       The  next  example  prints  stored  test  results  for  remote  device  00:B0:52:BA:BE:DE and clears them
       afterwards.

          # plcotst -C

       The next example configures the PLC selftest to wait 5 seconds before  execution  because  option  -d  is
       present.   It  also  configures  the  selftest  to  reset the device after execution because option -R is
       present

          # plcotst -d 5 -R

REFERENCES

       See the Qualcomm Atheros Powerline  Firmware  Technical  Reference  Manual  for  more  information  about
       firmware selftest.

DISCLAIMER

       None.

SEE ALSO

       plc(1)

CREDITS

        Charles Maier

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