PWMTESTPERF(1)

📦 version 1.0~rc2, in ubuntu questing, ubuntu resolute, ubuntu stonking

💖 PWMTESTPERF 💖

okay bestie, so this is a page from the General Commands Manual (that's section 1, the iconic one) about a lil command called pwmtestperf, and honestly? it's giving debug-tool energy and i'm obsessed. let's get into it 🫶

✨ NAME ✨

pwmtestperf — applies a simple test pattern to a PWM output 💅

✨ SYNOPSIS ✨

pwmtestperf [-c chipno] [-p pwmno] [-P periodlength] [-S step] [-v]

that's it. that's the whole vibe. no cap. 🎀

✨ Description ✨

so pwmtestperf is a debug tool, right? its whole main character job is to test repeated setting of the output waveform that a PWM emits. like, over and over, we're poking that waveform and seeing what happens. 🔥

the PWM this test messes with is chosen by chipno and pwmno. pick your chip, pick your output, and go.

now here's the part that's actually lowkey genius: the period is fixed, and you set it with periodlength. meanwhile the duty length gets bumped up by step on every step, going from 0 all the way up to periodlength. so it climbs, climb, climbs. 🦋

and if step is negative? then it's the reverse situation — it decreases from periodlength down to 0. the way that it just walks backwards down the whole range... periodt.

✨ Options ✨

  • -c chipno — every PWM chip has its own identifying chip number, like a little name tag. pwmtestperf configures a PWM line provided by chip number chipno. and chipno defaults to 0, so if you don't say anything it just goes with the first one. easy. ✨
  • -p pwmno — each PWM chip hands out a number of PWM outputs, like a friendship bracelet situation. pwmtestperf configures the pwmnoth PWM output of the chip you selected. pwmno defaults to 0 too. 💖
  • -P periodlength — periodlength, measured in nanoseconds, defines the length of the periods of the waveform that's gonna be set. this is the fixed one, the anchor, the stable queen. 👑
  • -S step — step, also in nanoseconds, defines how much the duty length gets increased by each step. (or decreased if it's negative — going backwards is still valid bestie, no judgement.) 🌸
  • -v — emit some information during runtime. basically it yaps while it works. love that for us. 🗣️💜

✨ SEE ALSO ✨

go read those too, they're part of the same friend group fr fr 🧚

heads up: this is a debug tool, not your production bestie. it's here to hammer a PWM output with repeated waveform settings, so know what you're pointing it at before you point it. 🙈

okay that's the whole page, ty for coming to my ted talk 💅✨ from the General Commands Manual, this has been PWMTESTPERF(1) — stay slay, stay in section 1, and go set some waveforms. bye bestie!! 🎀🦋💖

📦 where this page comes from