DOKK / manpages / debian 12 / plc-utils-extra / ptsctl.1.en
ptsctl(1) Qualcomm Atheros Open Powerline Toolkit ptsctl(1)

ptsctl - PTS Module Controller

ptsctl [options]

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.

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.

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.

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.

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.

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.

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

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.

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


Charles Maier
Nathaniel Houghton

November 2013 open-plc-utils-0.0.3