Skip to content

saturnus 0.2.0

Choose a tag to compare

View all tags
@ractive ractive released this 11 Oct 06:53
· 652 commits to main since this release
v0.2.0
3d9592c

saturnus 0.2.0 brings the transfer tool satx into the project: one tag now
releases two command-line tools, saturnus (the emulator) and satx
(Kermit and XModem transfers to a real HP 48 or 49 over a serial cable).
The site moved to a landing page with the emulator under it.

Get it

  • Web page, nothing to install: https://ractive.ch/saturnus/, the
    emulator at https://ractive.ch/saturnus/emulator/. Kept ROMs and
    states stay where they were; install the web app again from the new
    address.
  • Command line:
    • cargo install saturnus, cargo install satx;
    • Homebrew (macOS, Linux): brew trust --formula ractive/tap/saturnus
      once, then brew install ractive/tap/saturnus and
      brew install ractive/tap/satx;
    • Scoop (Windows): scoop bucket add ractive https://github.com/ractive/scoop-bucket,
      then scoop install saturnus and scoop install satx;
    • the archives below, saturnus-v0.2.0-<target> and
      satx-v0.2.0-<target> (checksums in saturnus-SHA256SUMS and
      satx-SHA256SUMS), or the Linux x86_64 packages saturnus and
      satx (.deb, .rpm, statically linked).
  • Desktop app: .dmg (macOS, Apple silicon, signed and notarised),
    .msi or -setup.exe (Windows x86_64), .deb, .rpm or .AppImage
    (Linux x86_64). Its Linux package is now saturnus-app, so it installs
    next to the command line's saturnus.
  • Libraries on crates.io, all at 0.2.0: saturnus-core (the core, no
    dependencies, builds for wasm32), saturnus-objects,
    saturnus-host, saturnus-drive, and satx's kermit-proto,
    xmodem-proto and satx-core.

Renamed, with no compatibility for the old names

  • The core library is the crate saturnus-core (use saturnus_core::…);
    the crate saturnus is now the command-line tool. saturnus-cli gets
    no new versions.
  • The CLI's Linux package is saturnus, the desktop app's
    saturnus-app.
  • The checksums file SHA256SUMS is now one per tool.

New

  • satx: send and receive files with an HP 48 or 49 by Kermit or
    XModem, from the command line, against a real calculator or the
    emulator. Shell completions come in its archives and packages.
  • Screen to a variable… and Screen to stack: the display goes onto
    the calculator as a 131 × 64 graphic. Also saturnus ctl screen --to-var NAME and --to-stack.
  • Saved states work alike in the browser and the app, one per model
    at a click, plus .sat files that also load in saturnus run --load.
  • A guided tour of the page, offered once on a first visit.
  • The command line's macOS binaries are signed and notarised.

The memory view, the dialogs, the ROM table, the messages and the docs
were reworked along the way; see CHANGELOG.md for the full list.

The Windows installers are not signed

SmartScreen says "Windows protected your PC": click "More info", then
"Run anyway".

ROMs are not included

saturnus ships no ROM. saturnus rom fetch --model <m>, the web page and
the app download the images hpcalc.org offers for use with emulators,
after asking. The HP 42S ROM was never released: dump your own
calculator (see the README).

Clean room and AI notice

saturnus is written from public hardware documentation and the observed
behaviour of the calculators' own ROMs, not from the source code of other
emulators, and contains no HP logos or wordmarks. Parts of the code were
generated by AI systems under human supervision; see AI_NOTICE. MIT
licence.

Assets 38
Loading