ptsctl(1)

💖 ptsctl — PTS Module Controller 💖

okay bestie, welcome to ptsctl(1), straight out of the Qualcomm Atheros Open Powerline Toolkit. it's a whole little vibe: you talk to a Production Test System over a local RS-232 port and set the attenuation. that's it, that's the girl. 🎀

✨ SYNOPSIS ✨

ptsctl [options]

🌸 DESCRIPTION 🌸

so what this does is set the attenuation level on the Qualcomm Atheros Production Test System, using a local RS-232 communication port. that's the whole plot. 🦋

heads up though — the port settings have to be configured before you run this program. the settings are: 9600 baud, no parity, 8 data and 1 stop bit. like, it will not hold your hand on that one.

more info lives in the datasheet at http://www.weedtech.com/wtssr-m.pdf. go read it, i believe in you 💅

👑 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. but if the environment string PTSCTL is defined then it takes precedence over the default serial port. and this option then takes precedence over either default. so it's like a whole hierarchy, very main character energy 🌈
• -g attenuation — the desired line/ground attenuation in Decibels. the value may be expressed in decimal, binary, or hexadecimal. binary values start with 0b and hexadecimal values start with 0x. the default for this option is 127 dB. no cap.
• -n attenuation — the desired line/neutral attenuation in Decibels. the value may be expressed in decimal, binary, or hexadecimal. binary values start with 0b and hexadecimal values start with 0x. the default for this option is 127 dB. twins with -g, honestly 🫶
• -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. pick your fighter 🎀
• -r — read and display undecorated attenuator settings on stdout. settings 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 others are missing then settings are displayed but not changed. if this setting appears with either or both of the other two then the settings are changed, then read, then displayed. it's giving "read and then also write, bestie" 💀
• -w wait — wait time in milliseconds. serial I/O operations are slow and a delay is needed after each write operation. unfortunately, different operating systems require different wait times. this option lets you adjust the time. the default is 10 milliseconds, which should be adequate on most systems. (key word: most 🙈)

🔥 EXAMPLES 🔥

first up: turn the Device Under Test power on and configure the line/neutral attenuator for 72dB attenuation. line/ground attenuation 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

next one: configure the controller for 42 dB attenuation on line/neutral and 100 dB on line/ground. there is no need to turn the Device Under Test on again because it remains on until turned off. iconic behaviour honestly ⭐

# ptsctl -n 42 -g 100

next: configure the controller for 56 dB attenuation on line/ground and 127 dB on line/neutral, and turn the Device Under Test off. 🌸

# ptsctl -p off -g 56

next: read the attenuator settings and display them in 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

and 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. slay 🦋

# 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)

go read those too, i know you will 💅

💅 CREDITS 💅

• Charles Maier
• Nathaniel Houghton

and that's the whole page, bestie 🫶 this was ptsctl(1) from open-plc-utils-0.0.3, dated November 2013 — yes she's a vintage queen and she still ate. 💖✨🎀