Quick Start Guide 03/27/2017 Egan Ford NOTE: READ ALL INSTRUCTIONS Prereqs: * 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 ``` * Ubuntu: ``` sudo apt-get install git libgtk2.0-dev ``` * RedHat/CentOS, Fedora: ``` sudo yum install git gtk2-devel ``` * Arch: ``` sudo pacman -S git gtk2 ``` ------------------------------------------------------------------------ Start up X11 and use xterm ------------------------------------------------------------------------ Download x49gp source: ``` git clone https://github.com/chwdt/x49gp.git ``` ------------------------------------------------------------------------ Build: ``` cd x49gp make ``` ------------------------------------------------------------------------ Install (optional): ``` make install ``` ------------------------------------------------------------------------ Run: ``` ./x49gp ``` When installed, there should be an applications menu entry to run x49gp. Installing also enables running it from the terminal in any directory: ``` x49gp ``` ------------------------------------------------------------------------ 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.: Restore backup: ``` 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 ------------------------------------------------------------------------ Start Over: * clean slate? ``` rm -r ~/.config/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 ``` ------------------------------------------------------------------------ Known Limitations: * HPGCC SD Card I/O - `libfsystem` unavailable. - `f*` calls unstable (HPGCC2) - `f*` calls stable (HPGCC3) ------------------------------------------------------------------------