datenklo(1)

✨ datenklo(1) ✨

okay bestie, buckle up 🎀 this is datenklo, a lil program from the General Commands Manual, section 1 (that's the "you type it in a terminal" section, iykyk). She does AM7910/AM7911 modem stuff over your sound card, and honestly? she ate. 💅

🌸 NAME 🌸

datenklo — the docs live at http://osmocom-analog.eversberg.eu/docs/ 🦋

💖 SYNOPSIS 💖

datenklo [options] -M <mode>

that's it, that's the whole vibe. you give her some options and you gotta give her a mode with -M. periodt. ✨

🌈 OPTIONS 🌈

like, all of them. every single one. no skipping, bestie, we're doing this properly 🫶

• -h, --help — shows you this help. that's it. that's the whole job. 💀
• --config [~/]<path to config file> — hand her a config file to use. if the path starts with ~/, then the path is at your home dir 🏠. every line in the config file is one option, and lowkey important: you must not give the - or -- in there! none. zero. don't do it. 🙈
• -v, --verbose <level> | <level>,<category>[,<category>[,...]] | list — the verbose situation is a whole spectrum, bestie.
  • use list to get a list of all levels and categories 📋
  • verbose level: just the digit of the debug level (default = '3') 🔢
  • verbose level+category: a level digit followed by one or more categories → and if no category is specified, then all categories are selected. she's generous like that 💜
• -v, --verbose date — shows the date along with the debug output 📅✨
• -T, --am791x-type 7910 | 7911 — tell her which modem chip type you've got going on. (Default = 7911) 🔥
• -M, --mc <mode> — sets the mode setting of the AM7910/AM71911. use list to list all the modes 👑 (also yes, you basically always need this one, see the synopsis, no cap)
• -A, --auto-rts — automatically raises and drops the modem's RTS line for half duplex operation. TX data will be queued while a remote carrier is detected 🎀
• -B, --baudrate <RX rate> <TX rate> — the baud rate you give here overrides the baud rate that came from ioctl. and here's the spicy bit: a baud rate of <= 150 Bps for TX and/or RX will attach TX and/or RX to the back channel instead of the main channel 🌀 (yes, this is the trick, bestie)
• -D, --device — the device name. the prefix '/dev/ gets added automatically if you didn't give it. (default = '/dev/ttyDATENKLO0') 🔌
• -S, --stereo — generates two devices 👯. one device connects to the left channel and the other to the right channel of the audio device. the device number in the device name automatically goes up by one. and you must also define the mode twice, like:

-M <mode> -M <mode>

both of them. don't forget the second one, she WILL be mad 😭

• -a, --audio-device hw:<card>,<device> — sound card and device number (default = 'hw:0,0') 🔊
• -s, --samplerate <rate> — sample rate of the sound device (default = '48000') 🎵
• -b, --buffer <ms> — how many milliseconds are processed in advance (default = '50') ⏱️
• -l, --loopback <type> — does an audio loopback to test the modem 🧪
  • type 1: audio from the transmitter is fed into the receiver (analog loopback) 🔁
  • type 2: audio is crossed between two modem instances (use with -S) 🔀
• --fast-math — uses a fast math approximation, for slow CPU / ARM based systems 🐢➡️🐇
• --write-rx-wave <file> — writes the received audio to the given wave file 📝
• --write-tx-wave <file> — writes the transmitted audio to the given wave file 📝
• --read-rx-wave <file> — replaces the received audio with the given wave file 📂
• --read-tx-wave <file> — replaces the transmitted audio with the given wave file 📂

that's the whole page, bestie. every flag, every default, every little detail — nothing left behind, we don't do that here 🫶 💖 ✨ 🎀

and for the cute lil sign-off: this page is datenklo(1), same name top and bottom, and yeah it's from the General Commands Manual — so if you ever forget what you read, just remember the footer said datenklo(1) and the header said datenklo(1) and it was all one glorious vibe 🌈💅 go forth and modem, queen 👑