Provided by: plc-utils-extra_0.0.6+git20230504.1ba7d5a0-1_amd64 bug

NAME

       ptsctl - PTS Module Controller

SYNOPSIS

       ptsctl [options]

DESCRIPTION

       Set  attenuation  level on the Qualcomm Atheros Production Test System using a local RS-232 communication
       port.  The port settings must be configured before running this program.   Settings  are  9600  baud,  no
       parity, 8 data and 1 stop bit.  See datasheet http://www.weedtech.com/wtssr-m.pdf for more information.

OPTIONS

       -f file
              The  name  of the serial port.  On Linux, the name is usually "/dev/ttyS[0-4]".  On OS/X, the name
              is usually "/dev/cua[0-4]".  On Windows, the name is "com[0-9]:".  The default is "/dev/ttyS0"  on
              Linux  and "com1:" on Windows.  If environment string "PTSCTL" is defined then it takes precedence
              over the default serial port.  This option then takes precedence over either default.

       -g attenuation
              The desired line/ground attenation in Decibels.  The value may be expressed in decimal, binary, or
              hexadecimal.  Binary varues start with "0b" and hexadecimal values start with "0x".   The  default
              for this option is 127 dB.

       -n attenuation
              The  desired  line/neutral attenation in Decibels.  The value may be expressed in decimal, binary,
              or hexadecimal.  Binary varues start with "0b"  and  hexadecimal  values  start  with  "0x".   The
              default for this option is 127 dB.

       -p power
              Turn  on  or  off  the  Device  Under  Test  power.   The  value  of  power  can be 1=on or 0=off.
              Alternately, keywords "on" and "off" can be used.

       -r     Read and display undecorated attenuator  settings  on  stdout.   Setting  appear  as  two  decimal
              integers  representing  the  attenuation in decibels.  The line/neutral setting appears first then
              the line/ground setting.  This option is independent of options -n and  -g.   If  this  option  is
              present  and  the  other  are  missing then settings are display but not changed.  If this setting
              appears with either or both of the  other  two  then  the  settings  are  changed  then  read  and
              displayed.

       -w wait
              Wait  time  in milliseconds.  Serial I/O operation are slow and a delay is needed after each write
              operation.  Unfortunately, different operating systems require different wait times.  This options
              lets you adjust the time.  The default is  10  milliseconds  which  should  be  adequate  on  most
              systems.

EXAMPLES

       The following example turns the Device Under Test power on and configures the line/neutral attenuator for
       72dB attenuation.  Line ground attenation is automatically set to 127 dB since it is not specified on the
       command line.  Option -p is not necessary if the Device Under Test power is already on.

          # ptsctl -p 1 -n 72

       The  next  example  configures  the  controller  for  42  dB  attenuation  on  line/neutral and 100 dB on
       line/ground.  There is no needed to turn the Device Under Test on  again  because  it  remains  on  until
       turned off.

          # ptsctl -n 42 -g 100

       The  next  example  configures  the  controller  for  56  dB  attenuation  on  line/ground  and 127 dB on
       line/neutral, and turns the Device Under Test off.

          # ptsctl -p off -g 56

       The next example reads the atteuator setting  and  displays  them  on  decimal  format  on  stdout.   The
       line/neutral setting appears first then the line/ground setting.  In this example, line/neutral has 55 dB
       attenuation and line/ground has 120 dB attenuation.

          # ptsctl -r
          55 120

       You  can also set the attenuation and read it back using one command.  The next example sets line/neutral
       attenuation to 10 db and line/ground attenuation to 50 db then reads the attenuator settings and displays
       them in the standard order, line/neutral then line/ground.

          # ptsctl -g 50 -r -n 10
          10 50

REFERENCES

       Information shown above applies to WTSSR-M Solid State Relay Module by  Weeder  Technologies,  90-A  Beal
       Pkwy NW, Fort Walton Beach FL 32548 USA; Tel +44 850 863 5723.

SEE ALSO

       plc(1), WTSSR-M(1), weeder(1)

CREDITS

        Charles Maier
        Nathaniel Houghton

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