config2cfg(1)

🎀 config2cfg — Atheros Configuration File Converter 🎀

okay bestie, welcome to config2cfg(1), brought to you by the Qualcomm Atheros Open Powerline Toolkit. it's giving "one job, does it perfectly" energy and honestly? we love that for it. 💅

✨ SYNOPSIS ✨

config2cfg [options] file [file] [...]

like, you hand it a file, it hands you a different file. iconic behavior fr fr. 🦋

🌸 DESCRIPTION 🌸

so the config2cfg program converts an SDRAM configuration file used by the Windows Device Manager into the configuration file format that the Qualcomm Atheros Powerline Toolkit speaks. it's basically a translator for two files that want to say the same thing but in wildly different fonts. 😭

this program is part of the Qualcomm Atheros Powerline Toolkit. for the overview and install instructions, go check the AMP man page — that's your orientation week, babe. ✨

💅 OPTIONS 💅

there are no options.

not me writing a whole OPTIONS section just to say nothing. but here we are. the man page did it, so I did it. 🫶

🌈 EXPLANATION 🌈

the Windows Device Manager format? it's 64 ASCII hexadecimal characters. files usually have a .config extension. file size is at least 64 characters. any excess characters are ignored on input — which means you can edit these files in literally any text editor, and there is no way to detect modification. from a programming standpoint, ASCII-to-binary conversion and checksum computation are required on input, and binary-to-ASCII conversion is required on output.

the Atheros Powerline Toolkit format is a whole different vibe: 32 binary bytes plus a 4 byte (32 bit) checksum. files usually have a .cfg extension. file size is always 36 characters. you can edit these with any hex editor, but bestie, listen — a new checksum must be computed and inserted after any change. no conversion or computation is needed on input or output, though. input is ready for direct insertion into a VS_SET_SDRAM message. no extra steps, just vibes. 👑

programs int6k and int6kf expect this latter format, so you can use this program to figure out whether a given file has the proper format. it's a vibe check for your config files. 🔥

⭐ OPTIONS ⭐

okay so yes, there's a second OPTIONS section. the original man page is extra like that, and I respect it. 💜

• file — the filename of a Windows Device Manager SDRAM configuration file. the file gets re-written, so the filename is preserved but the contents are not. Windows Device Manager SDRAM configuration files usually have a .config extension, but this program makes no assumption based on filename and does not enforce any filename conventions. it truly does not care what you named it. main character energy. 🎀
• -q — suppresses printing of progress messages. there are no progress messages in this version. so like, it's doing its best.
• -v — print additional information. there is no additional information printed in this version. the confidence, honestly. 💀
• -?, --help — print program help summary on stdout. this option takes precedence over other options on the command line. it's the boss of the command line, periodt.
• -!, --version — print program version information on stdout. this option takes precedence over other options on the command line. use this option when sending screen dumps to Atheros Technical Support so they know exactly which version of the Linux Toolkit you're using. help them help you, bestie. 🫶

🧚 EXAMPLES 🧚

example one: the glow-up check 🌟

this one reads the file abc.cfg and validates it. the message shown means the configuration file is the correct size, has a checksum, and there are no read errors. she's healthy, your honor.

> chkcfg abc.cfg
chkcfg: abc.cfg looks good

example two: the group chat 🌸

this one reads three files in succession and reports on each one. you can suppress the good news with the -q option — sometimes you just want the drama.

# chkcfg abc.cfg def.cfg ghi.cfg
chkcfg: abc.cfg looks good
chkcfg: def.cfg is corrupt
chkcfg: ghi.cfg looks good

example three: the reveal 👑

this one displays the SDRAM configuration values in every file whose name matches the wildcard pattern sdram*.cfg. we can confirm the values inside are correct for their filenames. program output could also have been sent to a file and saved for later reference — scrapbooking, but for configs. 🦋

# chknvm -qv sdram*.cfg
------- sdram32.cfg -------
        SIZE=0x02000000 (32mb)
        CONF=0x00143188
        TIM0=0x01E1D491
        TIM1=0x000883D6
        CNTRL=0x00003089
        REF=0x00000366
        CLOCK=0x00000001
------- sdram16.cfg -------
        SIZE=0x01000000 (16mb)
        CONF=0x00142F68
        TIM0=0x0115124E
        TIM1=0x000883D6
        CNTRL=0x00003089
        REF=0x00000493
        CLOCK=0x00000001

🚨 DISCLAIMER 🚨

the SDRAM file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA. consequently, public information is not available. Qualcomm Atheros reserves the right to change the file structure or content in future firmware releases without any obligation to notify or compensate users of this program. read that again, bestie. no notes, no refunds. 😭

👀 SEE ALSO 👀

• int6k(1)
• int6kf(1)
• modpib(1)
• chknvm(1)
• chkpib(1)

💖 CREDITS 💖

Charles Maier — the icon, the moment, the legend. 🌟

and that's the whole page, babes. this one came to you from the open-plc-utils-0.0.3 era, dated November 2013, and it's still serving. go convert something. iykyk. 💅✨🎀