libx48ng/README.md
Gwenhael Le Moine 4fd2511451
Add back the debugger
This reverts commit 3e78821d4a.
2023-09-15 09:53:39 +02:00

1.6 KiB

x48ng -- HP48 CPU emulator

(I'm not very good at writing, see ./README_0.6.4 for the original README)

This is my fork of x48-0.6.4 where I deviate from the original code and do my own thing.

What have I done:

  1. renamed it to x48ng to avoid confusion
  2. merged in a SDL1 version I found @ https://code.google.com/archive/p/x48-sdl/source/default/source
  3. removed the code supporting Solaris, HP-UX, etc.
  4. removed the autotools-based build system and wrote a simple Makefile instead
  5. added a x48ng.desktop file and an icon

Bugs to fix

See https://github.com/gwenhael-le-moine/x48ng/issues

What more I would like to do:

short term

  • clean-up further.
  • update manpage for sdl version
  • split the core emulator in a lib and have the GUI use that to cleanly separate the two.
  • port from sdl1.2 to sdl2
  • bring back the debugger?
  • can something be merged from droid48? [ https://github.com/shagr4th/droid48 ]

long(er) term

  • GUI in gtk(4)?
  • support the HP49g ROM?

Compilation

GUI

This branch is SDL1 only.

Installation

  1. Run sudo make install PREFIX=/usr DOCDIR=/usr/doc/x48ng MANDIR=/usr/man DESTDIR=/tmp/package filling in your own values for PREFIX, DOCDIR, MANDIR and DESTDIR.
  2. once installed run /usr/share/x48ng/setup-x48ng-home.sh to setup your ~/.x48ng/. It sets up a HP 48GX with a 128KB card in port 1 and a 4MB card in port 2
  3. run x48ng and enjoy

Development

  • make FULL_WARNINGS=yes to compile with all warnings
  • make clean and make mrproper to clean between compilation runs
  • make pretty-code to format the code using clang-format and the provided .clang-format