Tuesday, November 8, 2011

Mac emulator for Touchpad - Basilisk II

Emulator IPK & ROM

A very functional build of Basilisk II is now ready for anyone with an HP TouchPad!

Everything essential works fine, including the display, touchscreen, sound, onscreen keyboard, and networking. Things are still a bit hack-ish in this early stage (meaning that there's no configuration GUI, nor is the emulator without its quirks), as lots of changes to the code were and are still required in order to get this running smoothly on webOS.

Quick Setup Guide:
1. Download the attached IPK, and install as you normally would.

2. Basilisk II requires a ROM file from an actual Mac in order to run. You need to supply this file, as it's technically illegal to distribute and use a ROM, even from an old Mac, if you don't own the hardware. If you Google "quadra 650 rom", take a look at the first result... this might help you. This build is pre-configured to use a Quadra 650 ROM file. To install it, place it at /media/internal/basiliskii/quadra650.rom

3. You'll now need to install a hard disk image with Mac system software. Keep in mind that Basilisk II only runs very early versions of the Mac OS (up to 8.1, I believe)... so don't try to run anything newer. Early versions of the system (up to 7.5.x) are available for free from Apple. You can either prepare a system image using Basilisk II on your desktop computer, or you can download a prepared image of System 7.5.5 (highly recommended) at the provided link above.

4. Place the hard disk image at /media/internal/basiliskii/MacOS755.hfv

5. Launch Basilisk II, and let the fun begin!

6. If you wish to customize the configuration or the location of the required files, edit the CONFIG file -- it's located at /media/cryptofs/apps/usr/palm/applications/com.nickburkhart.basiliskii/CONFIG

Notes about current quirks (these will all be resolved in future releases):

- The coloration of the video will appear a bit off until you set the color depth to "256 colors" from within the Monitors control panel in the emulated Mac OS.
- The on-screen keyboard will appear, but only if the emulated OS is in "256 colors" mode.
- You can also change the screen resolution from within the Monitors control panel; I added a special 1024x526 mode to the video driver to accommodate an XS onscreen keyboard. You may have to re-set the screen resolution on every launch, for the time being.
- The on-screen keyboard cannot yet be hidden and called up at will.
- To enable networking through your TouchPad's Wifi connection, ensure that DHCP is enabled in the TCP/IP control panel.
- The default keymapping leaves much to be desired -- useful Mac keys (command, etc.) are not mapped at the moment.

You will have no problem getting this up and running if you follow the recommended steps above. Please let me know if you encounter any problems or have any ideas! I will release source code once it's not so embarrassingly messy.

1 comment: