psin(1)

👑 psin — like, the manual page, but make it make sense 💅

okay bestie, welcome to psin(1) from the Qualcomm Atheros Open Powerline Toolkit 🌈 — yes that whole mouthful, we're doing this together, hold my iced coffee 🧚

---

✨ NAME ✨

psin — Import PIB Prescalers 💖

---

🌸 SYNOPSIS 🌸

psin [options] [<stdin] file

---

💖 SYNOPSIS 💖 (yeah bestie, twice, the original said it twice and I'm not gonna lie to you)

so what this actually does: it reads an amplitude map from stdin and inserts it into an existing PIB file (the source spells it nexisting, which is honestly iconic 💀 — we're keeping it, no cap), replacing the previous amplitude map. slay.

this program is the vibe check that lets you load custom amplitude maps into a PIB file. you can also pipe a map directly from one PIB file to another 🫶 — no middleman, we love a direct line.

Atheros can provide standard amplitude maps (prescalers) that conform to most national or international EMI regulations ✨. generally speaking, these maps should not be modified… but there are execeptions (again, that's the source spelling, and honestly? we respect the chaos 😭).

this program is part of the Qualcomm Atheros Powerline Toolkit. see the AMP man page for an overview and installation instructions 📖

---

⚠️ CAVEATS ⚠️

okay this is the important part, sit UP bestie 🍓

the Atheros Windows Device Manager figures out the type of prescalers stored in the PIB by inspecting the ToneMaskType code — which is also stored in the PIB but is not part of the prescaler set. sneaky little thing.

so if you use this program to store a new prescaler set in a PIB and you don't update the ToneMaskType code to reflect that change? the Windows Device Manager will keep displaying the previous prescaler type 💀 which will confuse Windows Device Manager users. not the serve we were going for.

use program setpib to set the ToneMaskType code, and program pskey to verify the true prescaler type. periodt. 👑

---

💅 OPTIONS 💅

None.

that's it. that's the options section. she has no options, she's booked and busy on stdin alone 😌

---

🎀 ARGUMENTS 🎀

• file — the name of an Atheros Parameter Information Block (PIB) file. the original prescalers get replaced and the checksum is re-computed 🔥. by convention, PIB files have a .pib extension, but this program does not enforce that convention, and it does not make any assumption based on filename or extension — but it will reject invalid PIB files, so don't try it 🚫. only one file may be specified on the command line, bestie, we're not doing a whole group chat of files.

---

🦋 FILES 🦋

an amplitude map consists of 1155 frequency-amplitude pairs ✨. each pair is a decimal index and a hexadecimal scaler value.

• the index represents a frequency from 1.8 mhz through 30 mhz
• the scaler represents the amplitude attenuation applied at that frequency

the frequency and attenuation are computed like this:

frequency = (index + 74) / 40.96
decibels = 20 * log10 (scaler / 256)

math girlies rise 🧮💜

---

⭐ EXAMPLE ⭐

the following example loads prescaler file abc.psc into PIB file abc.pib 🌈. heads up: the ToneMaskType code is not updated by this operation, and it should be updated separately to avoid confusing Windows Device Manager users. program setpib is one means of updating this code 👑

# psin < abc.psc abc.pib

---

💀 DISCLAIMER 💀

PIB file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA. consequently, public information is not available. Qualcomm Atheros reserves the right to modify PIB file structure or content in future firmware releases without any obligation to notify or compensate users of this program. yeah. they said that. 😭

tampering with prescaler settings may violate national or international electo-magnetic emission standards and lead to fines or penalties. 🚨 Qualcomm Atheros shall not be held responsible for any consequences of modifications made to prescaler sets provided to their customers.

so like… be normal about your prescalers, bestie 🙈

---

🌈 SEE ALSO 🌈

• psgraph(7)
• pskey(1)
• psout(1)
• setpib(1)

---

👑 CREDITS 👑

• Charles Maier
• Nathaniel Houghton

absolute legends, ty for your service 🫶

---

and that's the whole page, babes 💖 this was open-plc-utils-0.0.3, dated November 2013 — yeah she's an elder but she ATE, and now you know her. go update your ToneMaskType. mwah 🎀✨