dsg/aten-ipmi-tools
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
110 commits 1 branch 0 tags 578 KiB
Find a file
Davíð Steinn Geirsson f2123eb737 fix(aten-mount): distinguish handled vs ignored SCSI commands in log 
Add LUN field and handled/ignored status to SCSI debug log lines so
unknown opcodes (silently accepted per firmware behavior) are clearly
distinguishable from handled commands that return no data.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 20:01:25 +00:00
crates fix(aten-mount): distinguish handled vs ignored SCSI commands in log 2026-03-12 20:01:25 +00:00
.gitignore Add initial server RE, RE doc restructuring 2026-03-12 11:36:40 +00:00
Cargo.lock fix(aten-mount): fix PDU dispatch order and add SCSI debug logging 2026-03-12 18:51:40 +00:00
Cargo.toml feat: scaffold aten-kvm crate with public types 2026-03-11 21:35:34 +00:00
CLAUDE.md Add initial server RE, RE doc restructuring 2026-03-12 11:36:40 +00:00
flake.lock refactor: extract mount library package, add flake.nix 2026-03-11 14:28:22 +00:00
flake.nix fix(aten-mount): fix PDU dispatch order and add SCSI debug logging 2026-03-12 18:51:40 +00:00
ghidramcp_client.sh Add initial server RE, RE doc restructuring 2026-03-12 11:36:40 +00:00
ghidramcp_server.sh Add initial server RE, RE doc restructuring 2026-03-12 11:36:40 +00:00
KVM_PROTOCOL.md dos2unix on KVM_PROTOCOL.md, MOUNT_PROTOCOL.md and REVERSING_CLIENT.md 2026-03-12 13:38:03 +00:00
MOUNT_PROTOCOL.md dos2unix on KVM_PROTOCOL.md, MOUNT_PROTOCOL.md and REVERSING_CLIENT.md 2026-03-12 13:38:03 +00:00
README.md Add initial server RE, RE doc restructuring 2026-03-12 11:36:40 +00:00
REVERSING_CLIENT.md dos2unix on KVM_PROTOCOL.md, MOUNT_PROTOCOL.md and REVERSING_CLIENT.md 2026-03-12 13:38:03 +00:00
REVERSING_SERVER.md RE: cross-reference review, corrections, and gap-filling 2026-03-12 13:28:52 +00:00

README.md

aten-ipmi-tools

Open-source replacements for the ancient, insecure bundled management app shipped with old IPMI interfaces. Protocols were reverse engineered from the original Java client and native libraries as well as the server BMC firmware — see KVM_PROTOCOL.md, MOUNT_PROTOCOL.md, REVERSING_CLIENT.md and REVERSING_SERVER.md.

The target is Supermicro X9 boards with Nuvoton WPCM450 IPMI (aka "hermon"), but this likely works with other ATEN/ASpeed/Nuvoton IPMI implementations too.

Tools

aten-mount-cli

Mounts a local ISO image as a virtual CD-ROM on the BMC. Works by emulating a USB Mass Storage device over the ATEN virtual media TCP protocol.

aten-mount-cli [OPTIONS] <HOST> <ISO>

Options:
  -u, --user <USERNAME>   BMC username [default: admin]
  -p, --pass <PASSWORD>   BMC password [default: admin]
      --port <PORT>       BMC virtual media port [default: 623]

Press Ctrl+C to cleanly unmount.

aten-gui

KVM console viewer (Slint + winit). Connects to the BMC via the ATEN RFB protocol, decodes Hermon video frames, and displays the remote console with keyboard input.

aten-gui [OPTIONS] <HOST>

Options:
  -u, --user <USERNAME>   BMC username [default: admin]
  -p, --pass <PASSWORD>   BMC password [default: admin]
      --port <PORT>       BMC KVM port [default: 5900]

Building

cargo build --release
# or
nix build .#aten-mount   # CLI tool
nix build .#aten-gui     # GUI app