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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
pearpc_setup [2018/09/04 01:22]
pearpc_setup [2018/10/28 06:20] (current)
clockwise [Setting up PearPC for Windows]
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 version ​**10.4 (Tiger)** or earlier. ​ You can use an OS X install CD, or a disk image that you've created or downloaded. ​ The screenshots and instructions in this guide are of 10.4, although other versions are set up in a very similar way.  **Note**: ​ You cannot use a physical **DVD image**.  ​The emulated Macintosh cannot read a DVD.  If you have a physical DVD, you need to make an image from it.  Searching your favorite torrent site for "​pearpc"​ might help here+  * 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 more 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]].  ​**Note**: The image is entirely blank, so it is compressed down to a small size, but it will take awhile (five minutes or more) to expand.  ​Be patient! ​ Note also that the hard disk image provided with the VirtualBox GUI doesn'​t seem to work (at least for me).+
-===== 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: 
 +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). 
-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. 
 +===== 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)**+
pearpc_setup.1536049347.txt.gz · Last modified: 2018/09/04 01:22 by clockwise
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki