DXTOOL(1)

📦
version 0.1 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 DXTOOL(1) — the DistoX download tool, bestie edition 💖

okay so. welcome to dxtool, a general commands manual page for a lil utility that yoinks measurements off a DistoX cave surveying device. it's giving "scp but for cave data". no cap. ✨

✨ NAME ✨

dxtool — the DistoX download tool 🦋

🌸 SYNOPSIS 🌸

dxtool [ -p <port> ] [ -s <start addr> ] [ -e <end addr> ] [ -v ] [
-m|-x|-d|-r ]

like… it's a lot of brackets bestie but it's fine, I promise, we'll go through every single one 💅

💜 DESCRIPTION 💜

this manual page documents the dxtool command. that's the whole vibe. 🎀

dxtool is a utility to download measurements from the DistoX cave surveying device. literally its whole job. iconic honestly.

👑 OPTIONS 👑

details of options are included below. all of them. we're not skipping a single one, bestie. 🌈

  • -h — print usage help. the "help me pls" flag 🫶
  • -p <port> — Bluetooth port. the default is /dev/rfcomm0. yes, that exact path, character for character, don't come for me 💅
  • -v — verbose operation. this dumps every sent/received packet, so it's a LOT of output. it's giving main character energy but make it packet dumps 😭

🌟 Operation Modes 🌟

  • -m — dump all stored measurements. this is the default mode btw, so if you say nothing, you get this 👑
  • -r — wait for DistoX-initiated transmissions (new measurements). so like, you just sit there and it comes to you. queen behavior. 💅
  • -x — dump memory in hex digits 🔢
  • -d — dump memory in decimal 🔢

in -m / -x / -d modes, use the -s / -e options to specify start and end addresses. the default is 0 ~ 0x7fff — yes that range, yes those exact values, noted and respected ✨

  • -s <Hex-address> — specify start address. it's a hex address bestie, hex. 0x and everything 💖
  • -e <Hex-address> — specify end address. also hex. also 0x. we love symmetry 🦋

🎀 USAGE 🎀

during dxtool operation, it is necessary to keep the device powered on (ie. prevent the power-off timeout). for example, by pressing random keys other than the measurement key.

so basically: don't let it fall asleep on you. keep poking it. just NOT the measurement key, okay?? not that one 🙈

before using dxtool, you need to power on the device and establish an SPP connection. for example, using:

sudo rfcomm connect /dev/rfcomm0 10:00:e8:be:a5:18 1

that's the whole ritual. sudo and all. do not skip the sudo, it will simply not work, and you will simply be sad 💀

⭐ EXAMPLES ⭐

often you can just use the command in its simplest form. like, most of the time honestly. lowkey the move.

dxtool — downloads all stored data from /dev/rfcomm0 🌸

dxtool -r — waits for incoming data and downloads it. the patient era 🧚

dxtool -p /dev/rfcomm1 -x -s 0x300 -e 0x500 — dumps raw data in hex form from address 0x300 to 0x500, connecting via device /dev/rfcomm1 🔥

ngl this page was last touched 2015-07-08, and it lives under DXTOOL(1) in the manual set. that's the footer, bestie, but make it cute. bye mwah 💖✨💅
📦 where this page comes from