edsu(1)

💌 edsu(1) — bestie edition

okay so you found yourself a page from the Qualcomm Atheros Open Powerline Toolkit and you're like "what is this" — don't worry, I got you. this is edsu, aka the Qualcomm Atheros Ethernet II Data Send Utility. she sends files over the wire in Ethernet frames. that's the whole vibe. 🦋

✨ NAME ✨

edsu — Qualcomm Atheros Ethernet II Data Send Utility

✨ SYNOPSIS ✨

edsu [options] file [file] [...]

✨ DESCRIPTION ✨

so basically 💅 you hand edsu one or more files and she sends them out as a whole series of Ethernet II (IEEE 802.2) frames. the input files get read sequentially and blasted over the network as one continuous stream of standard Ethernet frames. every frame (except, like, maybe the very last frame of each file, no biggie) carries a full 1500 bytes of file data. the receiving host can just concatenate frame data as frames arrive — that's on them, we're not the boss of them.

now here's the fun part 🌸 this program is for testing remote Atheros UART-enabled powerline devices. the remote UART-enabled powerline device rips the frame headers off and forwards the frame data to its local host as a serial data stream. and like — there is no protocol imposed on that serial data stream, periodt. for example, there's literally no indication of frame start, frame end, file start or file end anywhere in the stream. it's giving raw. the remote powerline device must be in Transparent Mode and configured to accept frames from the sending host, and the remote host also has to be ready to handle serial data as it arrives. both sides gotta show up, bestie 🤝

✨ OPTIONS ✨

• -d xx:xx:xx:xx:xx:xx — the Ethernet address of the destination device. if that destination is a Linux, Mac OSX or Windows host then the program edru can be used to receive and write frame data to stdout as a serial stream. if the destination is an Atheros UART-enabled powerline device then the received frame data gets converted into a serial data stream and forwarded to the host connected to that device — and in that case, the UART-enabled powerline device must be programmed with the address of the sending host. 🎀
• -e ethertype — the protocol (or ethertype) you care about, written as a 16-bit hexadecimal integer. the 0x prefix is optional, do not stress. this filters out frames that have any other ethertype. default is ETH_P_802_2, as defined in if_ether.h. ✨
• -i interface — the host interface used to send frames. the program default is "eth1" on Linux, "en0" on MacOSX or OpenBSD, and "2" on Windows. however — if the environment string "PLC" is defined, it supersedes the program default. and any interface you specify on the command line supersedes all others. she said hierarchy, she said priority 💅
• -p seconds — pause time in seconds between sending each frame. pauses may be necessary when the destination device is a UART-enabled powerline device, because each frame has to be converted and transmitted serially from the remote device to the remote host. permitted pause times are 0 through 255 seconds. default is 0. 🌸
• -q — Quiet mode. this option has no effect at this time, so like… cute flag, no notes. 💀
• -v — Verbose mode. this one displays outgoing frames on stdout in hexadecimal dump format as they are sent. chef's kiss for debugging 🔥

✨ ARGUMENTS ✨

• file — the name of a text or binary file accessible from the local host. any file, she doesn't judge 🫶

✨ EXAMPLES ✨

the following example sends the files abc.txt then def.bin to the remote Atheros UART-enabled powerline device 00:B0:52:BA:BE:55 over network interface eth1. there's a constant 1 second delay between each frame sent, so that remote UART-enabled powerline devices have time to convert and forward each frame to their local host. iconic behaviour honestly ⭐

# edsu -ieth1 -d 00:b0:52:BA:BE:55 abc.txt def.bin

✨ SEE ALSO ✨

amp(1), edru(1) efsu(1),

✨ CREDITS ✨

Charles Maier 👑

and that's the whole page, bestie!! this one's from open-plc-utils-0.0.3, dated November 2013 — yeah she's an elder but she still ate 💖 go send some frames, ily, bye!! 🦋✨