ASTRIBANK_TOOL(8)

💖 ASTRIBANK_TOOL 💖

okay bestie, so this is the manual page for astribank_tool — it's section 8 of the manual, which is the "system administration" girlies section, and honestly? iconic. let's get into it 🦋

✨ NAME ✨

astribank_tool — the Xorcom Astribank (xpp) control tool. no cap, that's literally what it is 💅

🌸 SYNOPSIS 🌸

astribank_tool [ options ] [ operation... ] -D device-path

astribank_tool [-h]

🎀 DESCRIPTION 🎀

So astribank_tool is the tool you use to control the USB-level functionality of an Astribank. That's the whole vibe.

One thing though — it operates on a single Astribank at a time. Singular. One. You gotta tell it which one via the -D command line option. No polyamory here, it's a monogamous tool 😭

⭐ OPTIONS ⭐

• -D device-path — Required. The device to read from/write to. This is bus_num/device_num, where bus_num and device_num are the first two numbers in the output of lsusb(8) or dahdi_hardware(8). Fyi on older versions of this tool you needed a complete path to the device, which would be /dev/bus/usb/bus_num/device_num, or /proc/bus/usb/bus_num/device_num. glow-up tbh ✨
• -p num — Set the TwinStar port number. Either 0 or 1. (TODO: explain). yeah bestie, the docs are gatekeeping a lil bit, that's just how it is 🙈
• -r type — Reset the Astribank and renumerate its USB connection to power on product ID. type can be: half or full. (TODO: explain those). again, no explanation, we simply vibe 💀

also, note the original spells it "Tyep" — a little typo moment, but we keep the option name as -r type because the facts stay facts 🫶

• -w 0|1 — Enable (1) or disable (0) the TwinStar watchdog. When it's enabled, the Astribank will jump to the second port if this system is "not working" and the system on the second port is available. very main character energy of it, honestly 👑
• -Q — Query astribank properties via MPP protocol.
• -n — Renumerate the Astribank product number (e.g: from 1161 to 1162). little number makeover, slay 💅
• -v — Increase verbosity. May be used multiple times. so you can be -v, or -vv, or -vvv if you're feeling extra 🔥
• -d mask — Set debug mask to mask. Default is 0, 0xFF is "everything". all the tea, all at once 🍓
• -h — Displays usage message. the classic cry-for-help flag, we love her 🌈

🦋 SEE ALSO 🦋

fxload(8), lsusb(8), astribank_hexload(8)

go read those next, bestie, they're the supporting cast 💜

👑 AUTHOR 👑

This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

and that's the whole page, periodt 💖 this manual page was dated 29 March 2009 and it lives in the ASTRIBANK_TOOL(8) section of the manual — thanks for coming to my TED talk, ily, bye 🎀✨