PWMSET(1)

✨ PWMSET ✨

okay so bestie, welcome to the General Commands Manual page for pwmset — section 1, the real ones. it's giving waveform couture and honestly? obsessed. 💅

🌸 NAME 🌸

pwmset — Configures a PWM's output waveform

🎀 SYNOPSIS 🎀

pwmset [-c chipno] [-p pwmno] [-e] [-s sleepns] [-P periodlength]
       [-D dutylength] [-O dutyoffset] [-v]

🦋 DESCRIPTION 🦋

okay so here's the tea. pwmset's purpose is to configure a PWM device to emit a certain waveform. that's the whole vibe. 💖

which PWM are we even talking about? that's chipno and pwmno's job — they specify the PWM to program. and the waveform itself? described by periodlength, dutylength and dutyoffset. three little numbers, one gorgeous wave. no cap. 🌊

💖 OPTIONS 💖

• -c chipno — every PWM chip has an identifying chip number, like its own little government name. pwmset configures a PWM line provided by chip number chipno. and chipno defaults to 0. she starts at zero, she's humble like that. 🫶
• -p pwmno — each PWM chip provides a number of PWM outputs, so we gotta pick one. pwmset configures the pwmnoth PWM output of the selected chip. pwmno defaults to 0 too. twins! ✨
• -e — requests that the specified waveform is implemented exactly. and if that isn't possible? pwmset fails. no compromises, no half-measures, no "close enough." she said exact or nothing, and honestly? main character energy. 💀
• -s sleepns — okay so here's a spooky one: it is unspecified what happens with the PWM's output once control over it is given up. we simply do not know. mystery. 🙈 after the waveform is programmed, let pwmset keep control over the PWM for sleepns nanoseconds. the default value for sleepns is 5000000000, i.e. five seconds. yes that's a lot of digits, she's worth it.
• -P periodlength — periodlength in nanoseconds defines the length of the period of the waveform to be set. that's your wave's full loop, top to bottom. 🌈
• -D dutylength — in nanoseconds, defines the length of the active part of the waveform to be set. the loud part. the on part. the part that eats. 🔥
• -O dutyoffset — in nanoseconds, defines the offset between the start of a period and the start of the period's active part. so like, the lil delay before the action kicks in. the fashionably late of waveforms. 💜
• -v — emit some information during runtime. chatty queen. she's telling you what's happening and you're gonna listen. 👑

🔎 SEE ALSO 🔎

• pwmround(1)
• pwmtestperf(1)

⭐ friendly reminder: -e means exact or bust, and -s is standing between you and the great unspecified beyond. know what you're doing before you give up control, bestie. 🎀

and that's the page!! 💖 brought to you by the General Commands Manual, filed under PWMSET(1) because that's her name and she's keeping it. stay configured, stay exact, and go emit a gorgeous waveform for me. 🦋✨💅