BAYCOMEPP(8)

📦 version 0.10, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 BAYCOMEPP(8) 💖

Linux AX.25 Utilities Manual · the Baycom EPP modem driver, but make it cute

✨ NAME ✨

baycomepp — Baycom EPP modem driver 🦋

🌸 SYNOPSIS 🌸

baycomepp [ -lknvcaz ] [-p portaddr] [-m modestr] [--epp] [--ecp]
[--eppconv] [--eppafsk] [--ifname name] [--hwaddr callsign] [--ipaddr
ipaddress] [--netmask netmask] [--broadcast broadcast]

🎀 DESCRIPTION 🎀

okay bestie, so baycomepp is a user mode driver for the Baycom EPP modem family 💅 and it's lowkey iconic.

Right now it supports:

  • the conventional EPP modem (the one using the IDT 72xxx FIFO's) 🔥
  • and the FPGA (Xilinx XCS10) variant ✨

The driver automatically initializes the FPGA modem depending on the mode you asked for. main character energy tbh

The way it keeps its resident memory footprint tiny — like, approx 20kBytes plus your standard system shared libraries like libc — is that all the initialization code lives inside a shared library called baycomfpga_init.so 🫶 so smol, so efficient.

This driver can also automatically attach itself to the kernel network stack as a network interface (usually called ax0) 👑 and for that it needs the Linux Kernel MKISS driver (so enable CONFIG_MKISS, no cap).

💖 OPTIONS 💖

baycomepp accepts the following options, and yes, we're going through every single one 🍓

  • -h, --help — shows you an overview of the available command line parameters and then exits. cute little menu moment ✨
  • -v, --verbose — makes the output more verbose. you can stack this one, it may be cumulated 💬
  • -p, --port — sets the base address of the EPP capable parallel port that the modem is hooked up to. use the 0x prefix for hexadecimal numbers 🔢
  • -m, --mode — sets various ``firmware'' options 👀
  • -n, --no-daemon — doesn't start up in the background as a daemon. also logs received and transmitted packets to stdout 📜
  • -l, --log — logs to syslog 🪵
  • -k, --kill — kills running baycomepp daemons. don't start the driver proper 💀
  • --epp — start up in EPP FSK mode. requires the FPGA version ⚡
  • --eppafsk — start up in EPP AFSK mode. requires the FPGA version ⚡
  • --ecp — start up in ECP FSK mode. requires the FPGA version ⚡
  • --eppconv — start up in conventional EPP FSK mode. requires the conventional version ⚡
  • --ifname — set the name of the interface (requires Linux 2.2.x) 🏷️
  • --hwaddr — set the hardware address (callsign) of the interface 📻
  • --ipaddr — set the ip address of the interface 🌐
  • --netmask — set the netmask of the interface 🕸️
  • --broadcast — set the broadcast address of the interface 📢

🌈 FIRMWARE OPTIONS 🌈

these ones go in -m / --mode, and they're giving ✨firmware config✨

  • intclk — uses FPGA internal clock; don't use this if an external oscillator is on board 🙈
  • extclk — uses the external oscillator; recommended if the internal modem is used, because the frequency of the FPGA oscillator is not accurate enough 👑
  • intmodem — uses the internal modem 📶
  • extmodem — uses a DF9IC type modem connected to the high speed modem connector 🔌
  • divider=x — sets the clock divider for the internal modem (baud=fquartz/16/divider) ➗
  • loopback — sets an internal modem loopback 🔁
  • extstat — allows extended status readback 👀
  • noextstat — disallows extended status readback 🚫

🫶 SEE ALSO 🫶

ifconfig (8), sethdlc (8), 🌟

💜 AUTHOR 💜

baycomepp was written by Thomas Sailer, HB9JNX/AE4WA (sailer@ife.ee.ethz.ch). obsessed, honestly 💅

BaycomEPP 0.2 · 13 May 1998 — that's the version and the date bestie, and that's a wrap, periodt 💖✨🎀

📦 where this page comes from