DMASCC_CFG(8)

πŸ“¦ version 0.0.10-rc5+git20230513+d3e6d4f, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ DMASCC_CFG(8) β€” the dmascc device glow-up guide ✨

okay bestie, gather round, because this is the Linux Programmer's Manual page for dmascc_cfg, and she is that girl πŸ’…


πŸŽ€ NAME πŸŽ€

dmascc_cfg β€” configure dmascc devices


🌸 SYNOPSIS 🌸

dmascc_cfg <interface> [<options>]

πŸ¦‹ DESCRIPTION πŸ¦‹

so basically, dmascc_cfg is the little tool you use to configure dmascc devices β€” think PI2 and PackeTwin cards, the whole squad πŸ’–

here's the tea on permissions tho: the --show option is for everybody, any user can run it, no gatekeeping. but every other option? that's root only, no cap. sorry babes, that's just how it is 🫢


✨ OPTIONS ✨

  • --speed frequency β€” sets the frequency of the baud rate generator to frequency. if you set it to 0, that disables the baud rate generator and the digital PLL entirely. and like, pls use the --show option to check whether the frequency you picked could actually be approximated with sufficient accuracy β€” don't just rawdog a number and hope, bestie 😭
  • --nrzi [0|1] β€” 0 selects NRZ mode, 1 selects NRZI mode. pick your fighter.
  • --clocks integer β€” sets the clock mode. you may OR together three choices β€” and fr fr, other values are not supported and may cause strange results πŸ’€

TX clock pin:

  • 0x00 input
  • 0x05 output TX clock *
  • 0x06 output baud rate generator *
  • 0x07 output digital PLL *

TX clock source:

  • 0x00 RX clock pin
  • 0x08 TX clock pin #
  • 0x10 baud rate generator
  • 0x18 digital PLL +

RX clock source:

  • 0x00 RX clock pin
  • 0x20 TX clock pin
  • 0x40 baud rate generator
  • 0x60 digital PLL +
* Not allowed on PI2 Port A if J3 is installed.
# TX clock pin must be configured as input.
+ Speed must be equal to 32 times the baud rate.
  • --txdelay milliseconds β€” sets the transmit delay to milliseconds. maximum is 2500 ms, so don't get greedy πŸ“
  • --txtime seconds β€” sets the maximum time the transmitter may be active to seconds. she has a curfew.
  • --sqdelay milliseconds β€” sets the squelch delay to milliseconds. maximum delay is 2500 ms.
  • --slottime milliseconds β€” sets the slot time to milliseconds. maximum slottime is 2500 ms.
  • --waittime milliseconds β€” sets the minimum time between the transmitter turning off to when it turns on, to milliseconds. maximum wait time is 2500 ms. she needs a moment, okay? πŸ™ˆ
  • --persist f β€” sets the persistence parameter to f. must be between 0 and 255 (inclusive). both ends, babes, 0 and 255 count.
  • --dma channel β€” sets the DMA channel to channel. can be 1 or 3. setting it to 0 disables DMA.

πŸ’€ BUGS πŸ’€

okay so this is the part where I hold your hand: dmascc_cfg does not check the parameters for validity. like, at all. zero vibe check.

The driver or kernel may crash if you specify invalid values.

so if you feed her nonsense, the driver or the kernel may literally crash. not a drill, not a cute little oopsie. double check ur numbers before you hit enter, i am begging πŸ˜­πŸ™


πŸ‘‘ AUTHORS πŸ‘‘

  • Klaus Kudielka
  • This manual page written by Craig Small <csmall@small.dropbear.id.au>

and that's the whole page, bestie πŸ’œ this one's from the Linux manual, dated 30 June 1999 β€” vintage, iconic, still serving. mwah πŸ’…βœ¨πŸŽ€