Emaculation.com

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
pearpc_setup [2018/10/22 06:47] – [Introduction] clockwisepearpc_setup [2018/10/28 06:20] – [Setting up PearPC for Windows] clockwise
Line 1: Line 1:
 ====== Setting up PearPC for Windows ====== ====== Setting up PearPC for Windows ======
  
-(Updated September 4, 2018)+(Updated October 28, 2018)
  
 ===== Introduction ===== ===== Introduction =====
Line 9: Line 9:
 Setting up the emulator is fun and easy!  But before you begin installing, there are a few things that you need to assemble: Setting up the emulator is fun and easy!  But before you begin installing, there are a few things that you need to assemble:
  
-  * A copy of Mac OS X.  You can use versions 10.1 to 10.4.  The screenshots and instructions in this guide assume an image made from an installation DVD of 10.4.  Installing from multiple disk images is more difficult, and you can read about it [[https://emaculation.com/forum/viewtopic.php?f=25&t=8472|here]].  **Note**:  While PearPC can read physical CDs, it cannot read physical DVDs.+  * A copy of Mac OS X.  You can use **versions 10.1 to 10.4**.  See below for important notes about issues with specific versions.
   * [[http://pearpc.sourceforge.net/downloads.html|PearPC 0.5.0]].  This is the most recent stable release of the emulator.   * [[http://pearpc.sourceforge.net/downloads.html|PearPC 0.5.0]].  This is the most recent stable release of the emulator.
-  * A front-end called [[https://web.archive.org/web/20171230205322/http://www.kxlan.co.uk/Jamie/Pearpc%20VBGUI%20install%202.0.exe|PearPC VirtualBox GUI]] which can be used to set up the emulator. Note that this includes a compressed 6 gb disk image that often is identified as an "arc-bomb" or a trojan by some virus scanners.  Rest assured that this archive does not contain a virus. +  * A 6 gb [[http://www.emaculation.com/pearpc/macosx_6gb.rar|hard disk image]] to install Mac OS X on.  It is best to use this image.  If you create your own, note that the size of the image must be a multiple of 516096.
-  * A bootable 6 gb [[http://www.emaculation.com/pearpc/macosx_6gb.rar|hard disk image]].  Use this one instead of the images included with the PearPC VirtualBox GUI.+
  
-===== Dealing with Mac OS X =====+===== Versions of Mac OS X =====
  
-It is much easier to install OS X on your emulated computer from an .ISO imagerather than from a physical OS X installation disk.  In Windows, you can create an .ISO from a physical disk using something like [[http://www.magiciso.com/|MagicISO]].  If necessary, you can perhaps download an ISO from a torrent site.  If you have a **.TOAST** or a **.CDR** image, just change the extension to **.ISO**.  If you download a **.DMG** image, try using [[http://www.ezbsystems.com/ultraiso/|UltraISO]] or [[dmg2iso]] to convert it to ISO.+There are a few things to keep in mind: 
 + 
 +  * You can use physical install CDs of Mac OS X 10.1 to 10.4.  This is probably the easiest option, but I haven't tested it on a modern system. 
 +  * You cannot use a physical install DVD of 10.4.  PearPC doesn't read DVDs. 
 +  * You might be able to use an ISO of a Mac OS X 10.4 install DVD, **but this does not work on my system**. 
 +  * You cannot use ISO images of Mac OS X 10.4 installation disksas they must be switched during the installation process, which PearPC does not support. 
 +  * You can use ISO images of Mac OS X 10.1, 10.2 and 10.3 installation disks.  **This seems to be the best option, and is what this guide mostly reflects.** 
 + 
 +In Windows, you can create an .ISO from a physical OS X disk using something like [[http://www.magiciso.com/|MagicISO]].  If you have downloaded a **.TOAST** or a **.CDR** image, just change the extension to **.ISO**.  If you have downloaded a **.DMG** image, try using [[dmg2iso]] to convert it to ISO.
  
-There are a few more notes about converting **.DMG** files in our [[dmg2iso]] article. 
  
 ===== Getting Started ===== ===== Getting Started =====
  
-Download PearPC and the VirtualBox GUI.  Install the GUI and locate "ppc.exe."  Replace this file with "ppc.exe" from the 0.5.0 archive you downloaded earlier (the version contained in the VirtualBox GUI is out-of-date).  Next, extract the 6 gb hard disk image provided above.+Download all of the above and place in a single directory.
  
 +Before you can run the emulator you must first create a PearPC configuration file, as there is no graphical user interface.  To do this, copy the following into a text editor and (after revising it) save it as PearPC.cfg
  
-(Note that the download buttons included in the GUI are not needed)+  ppc_start_resolution = "800x600x32"  
 +  ppc_start_full_screen = 0 
 +  redraw_interval_msec = 50 
 +  key_compose_dialog = "F11" 
 +  key_change_cd_0 = "none" 
 +  key_toggle_mouse_grab = "F12" 
 +  key_toggle_full_screen = "Alt+Return" 
 +  prom_bootmethod = "select" 
 +  prom_env_bootargs = "" 
 +  prom_env_machargs = "" 
 +  prom_driver_graphic = "video.x" 
 +  page_table_pa = 0x00300000 
 +  cpu_pvr = 0x00088302 
 +  memory_size = 0x10000000 
 +  pci_ide0_master_installed = 1 
 +  pci_ide0_master_image = "C:\Downloads\macosx_6gb.img" 
 +  pci_ide0_master_type = "hd" 
 +  pci_ide0_slave_installed = 1 
 +  pci_ide0_slave_image = "C:\Downloads\Panther\Panther_Disc1.iso" 
 +  pci_ide0_slave_type = "cdrom" 
 +  pci_3c90x_installed = 0 
 +  pci_3c90x_mac = "DE:AD:CA:FE:12:34" 
 +  pci_rtl8139_installed = 0 
 +  pci_rtl8139_mac = "PE:AR:PC:58:25:01" 
 +  pci_usb_installed = 0 
 +  pci_serial_installed = 0 
 +  nvram_file = "nvram"
  
-Start the VirtualBox GUI and click "new" to set up your emulator.+You will obviously need to change the paths to the master image and the slave image.  For more notes about what this means consult the [[http://pearpc.sourceforge.net/config.html|PearPC documentation]] A few things are worth mentioning here:
  
-Follow the prompts to first give your setup a name and select an Operating System.  Nextyou will select the hard disk image you expanded earlier.  Third, if you are using an ISO image of OS Xyou will browse to and select it.+  * Lowering "redraw_internal_msec" will make the mouse move more smoothly and will make the emulator feel a lot more responsive.  Howeverit may lead to frequent freezes.  
 +  * The above value in "memory_size" refers to 128 MB.  Changing that to "memory_size=0x20000000" will set it to 512 MB.  If you experience crashesleave it at 128 MB.
  
-{{:virtualbox1.png?300|}}+**Note**You can automate this process by creating a config file using [[https://github.com/SistemaRayoXP/PearPC-Config-File-Generator/blob/master/PearPC%20Config.zip|PearPC Config File Generator]].
  
 +===== Launching the Emulator =====
  
-**Figure One:  Default Settings in PearPC VirtualBOX GUI**+You cannot just run "ppc.exe" to get started.  Instead, you must open a command prompt and browse to the directory containing the emulator.  Run the following:
  
-PearPC should now run.  But you can adjust some of the default settings by clicking the headers.+**ppc PearPC.cfg 
 +**
  
-==== Video ====+As an alternative, you can create a shortcut to ppc.exe and modify the "target" to include PearPC.cfg, as follows: 
 + 
 +{{:pearpcshortcut.png?400|}} 
 + 
 +After you have properly launched the emulator, you should see a menu like the following.  To install Mac OS X, choose to boot from the cdrom (once you have installed you can boot from the disk). 
 + 
 +{{::pearpcbootmenu.png?400|}}
  
-You might want to increase your resolution a bit, to make it easier to see the OS X installation screens (they might not scale down to fit a 640x480 screen).  
  
-The default **redraw interval rate** is optimal, but for a possibly faster emulation (with jerkier mouse movements) try increasing it.  Lower this number to make the emulated system seem more responsive. 
  
-==== System ==== 
  
-Note that if you have trouble installing Tiger, try setting the memory to 128 MB.  Increase it afterwards for faster performance.  Note also that Tiger may not work correctly when emulating a G4 processor. 
  
-The USB option "tells PearPC to simulate a sort of placebo USB hub," ([[http://wiki.pearpc.net/index.php?title=Dissecting_the_PearPC_Configuration_File|ref]]), and does not give the emulated system access to USB devices. 
  
-==== Network ==== 
  
-Consult [[http://web.archive.org/web/20130704022145/http://wiki.pearpc.net/index.php?title=ICS_Networking_for_XP/Vista|PearPC.net]]. 
  
  
 ===== Installing Mac OS X ===== ===== Installing Mac OS X =====
-Click start to run the emulator.  Installing OS X is fairly straightforward, but some instructions and screenshots follow.  When the installation is finished, the emulated system will shut down.  Before restarting, remove the install ISO from the VirtualBox GUI to prevent it from being booted from again.+Installing OS X is fairly straightforward, but some screenshots follow.  When the installation is finished, the emulated system will shut down.  Note that for Mac OS X 10.3 and earlier you can install a usable version of the operating system just from the first disk.  Just choose to cancel when asked for the second disk  If you do wish to install features from the second disk do not boot from it. Instead, add the second disk to your config file, but boot from the hard disk image. 
 + 
 +{{::pearpcinstallpanther1.png?400|}} 
 + 
 + 
 +{{::pearpcpantherinstall2.png?400|}} 
 + 
 + 
 +{{:pantherload.png?400|}} 
 + 
 + 
 +{{::pantherdesktop.png?400|}} 
 + 
 + 
 +===== Setting up Networking ===== 
 + 
 +Consult [[http://web.archive.org/web/20130704022145/http://wiki.pearpc.net/index.php?title=ICS_Networking_for_XP/Vista|this guide]] from PearPC.net. 
 + 
 + 
 +===== Troubleshooting ===== 
 + 
 +Q: I launch "ppc.exe" (with my config file) but nothing happens. 
 + 
 +A:  This will occur if the path to your disk image or ISO is incorrect.  Check them.  It may also happen if you are using a disk image that has the wrong file size.  Use the one in this guide. 
 + 
 +
 + 
 +Q: I get an error that says "we are hanging here" 
 + 
 +A: This happens (sometimes) when you try to boot from a DVD image of Mac OS X 10.4.  See the comment at the beginning of this guide. 
 + 
 +
 + 
 +Q:  I get a black box on a grey screen when I try to boot. 
 + 
 +A: Try Removing **"prom_env_bootpath = "** from your config file. 
 + 
 +
 + 
 +Q:  The mouse sometimes freezes up, and I am forced to restart the emulator. 
 + 
 +A:  This is a long-standing bug.  Sorry.
  
-The OS X installer should start to boot.  You will first be prompted to select a language.  You will then see a splash screen looking something like figure two, below.+-
  
-{{:virtualbox2.png?300|}}\\  +Q The mouse is way too jerky and unresponsive.
-**Figure Two:  A splash screen**+
  
-If you are installing on to the bootable disk image linked to at the beginning of the guide, you will not need to partition it.  Just follow the on-screen instructions to install OS X.  Installation might take from thirty minutes to a couple of hours.  To speed this up, you can do a "custom" install without foreign language files or extra printer drivers.+A:  Lower the value of **redraw_interval_msec** in the config file.  Lowering that value will make the emulator feel more response (experiment with the number) but it may increase the frequency of cursor freeze-ups (see above)
  
-{{:virtualbox3.png?300|}}\\  +-
-**Figure Three:  About to install OS X**+
  
 +Q:  Can I access USB devices?
  
-{{:virtualbox4.png?300|}}\\  +A No.  Note that the "pci_usb_installed" option in the config file does not provide access to usb devices plugged into the host system.
-**Figure Four:  OS X 10.4 (Tiger)**+