Quick Start Guide 03/27/2017 Egan Ford email@example.com
NOTE: READ ALL INSTRUCTIONS
MacOS 10.12 64-bit:
- Install XQuartz, Xcode (from your installation media) in that order.
- Install Macports (macports.org), then:
sudo port install gtk2 pkgconfig gcc6 sudo port select --set gcc mp-gcc6 export PATH=/opt/local/bin:$PATH
sudo apt-get install git libgtk2.0-dev
- RedHat/CentOS, Fedora:
sudo yum install git gtk2-devel
sudo pacman -S git gtk2
Start up X11 and use xterm
Download x49gp source:
git clone https://github.com/chwdt/x49gp.git
cd x49gp make
When installed, there should be an applications menu entry to run x49gp. Installing also enables running it from the terminal in any directory:
First launch setup
On the first launch, the calculator will be missing a firmware, forcing the bootloader to complain and demand a fresh one. HP's official firmwares can be found at e.g.: https://www.hpcalc.org/hp49/pc/rom/ Some of the most popular of these are also included in x49gp's source directory. Alternatively, the most up-to-date version of NewRPL can be found at: https://hpgcc3.org/downloads/newrplfw.bin
Pick a firmware to use and store it in any directory along with its update.scp file. The update.scp file only contains the filename of the firmware (when renaming the firmware, make sure the new name fits into a DOS-style 8.3 naming scheme) followed by a DOS-style linebreak, so a missing update.scp can be rectified easily.
Right click on the screen, or press the menu key on a physical keyboard, to open the menu, and click on "Mount SD folder". Select the directory containing the firmware. Then, select the SD option from the bootloader's update source menu by clicking on the virtual key labeled "2" or by pressing the "2" key on a physical keyboard.
Now the bootloader is installing the firmware; wait until it finishes printing hex numbers to the virtual display, then follow its prompt to press Reset ( = F12 or the Reset entry in the menu) or Enter. The calculator should be fully usable after this procedure.
Do stuff, e.g.:
BACKUP 3 ->TAG RESTORE
Install ARMToolbox (HPGCC2):
2 SETUP.BIN 3 ->TAG RCL EVAL
(Right Click ON, Left Click C)
To Exit Emulator
Use any of:
Press Alt-F4 or your system's equivalent key combination
Open the menu using a right click on the screen or the menu key, then choose "Quit"
Press Ctrl-C in the launch terminal
- clean slate?
rm -r ~/.x49gp
- soft reset only?
With x49gp running, press F12, or right click on the screen and select "Reset" from the menu.
Debugging with x49gp
There is a GDB interface for debugging ARM programs, e.g. HPGCC2/3 applications or replacement firmwares. To use it, start x49gp from a terminal with the -d option, and start arm-none-eabi-gdb with an appropriate ELF file in another terminal. To connect to x49gp, type in the GDB console:
target remote :1234
- HPGCC SD Card I/O
f*calls unstable (HPGCC2)
f*calls stable (HPGCC3)