dsg/aten-ipmi-tools
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
111 commits 1 branch 0 tags 578 KiB
Find a file
Exact
Davíð Steinn Geirsson 40f8649126 fix(aten-gui): bundle emoji font via fontconfig for button glyphs 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 21:36:53 +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-gui): bundle emoji font via fontconfig for button glyphs 2026-03-12 21:36:53 +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