Documentation/Platforms/PowerPC: Difference between revisions

From QEMU
No edit summary
(Update Mac OS 9 debugging documentation)
Line 2: Line 2:
<h3>[http://qemu.weilnetz.de/qemu-doc.html#compilation QEMU Installation Directions for Mac OS X, Windows, and Linux]</h3><BR>
<h3>[http://qemu.weilnetz.de/qemu-doc.html#compilation QEMU Installation Directions for Mac OS X, Windows, and Linux]</h3><BR>
<h2>Guest Compatibility</h2>
<h2>Guest Compatibility</h2>
<br>Note: this [https://docs.google.com/spreadsheets/d/1T0kkk8WpQ-eWBIdxBnXWCfeyClVVLJyXvvF2NED2U6Q/edit?usp=sharing spreadsheet] might have more update to date information.<br>
<br>Note: information based on QEMU version 2.7. This [https://docs.google.com/spreadsheets/d/1T0kkk8WpQ-eWBIdxBnXWCfeyClVVLJyXvvF2NED2U6Q/edit?usp=sharing spreadsheet] might have more update to date information.<br>
<table>
<table>
<tr style="text-decoration:underline;">
<tr style="text-decoration:underline;">
Line 62: Line 62:
This is the suggested command-line options to install Mac OS 10.2:<br>
This is the suggested command-line options to install Mac OS 10.2:<br>
   ./qemu-system-ppc -hda <hd image file> -m 400 -prom-env boot-args=-v -cdrom <iso file of installation media> -boot d
   ./qemu-system-ppc -hda <hd image file> -m 400 -prom-env boot-args=-v -cdrom <iso file of installation media> -boot d
<BR>
 
<u>Mac OS 10.4</u><BR>
<u>Mac OS 10.4</u><BR>
This is the suggested command-line options to install Mac OS 10.4:<br>
This is the suggested command-line options to install Mac OS 10.4:<br>
Line 73: Line 73:
Note:Mac OS 10.4 installation CD does not support the beigeg3 target. It will boot up, but a error dialog will say this machine isn&#146;t supported.<BR>
Note:Mac OS 10.4 installation CD does not support the beigeg3 target. It will boot up, but a error dialog will say this machine isn&#146;t supported.<BR>


<br>
<h2>Mac OS 9 Debugging tips</h2><BR>
<u>Mac OS 9</u><BR>
As of December 2015, Mac OS 9.2.1 cannot boot successfully into QEMU. Part of the reason is due to issues with OpenBIOS. The other reasons may be related to PowerPC emulation issues. There are ready-made image files and other helpful hints [http://www.emaculation.com/forum/viewtopic.php?f=34&t=7047&sid=0ef8922b24a51d2a9d546300aea69c64&start=250 here].
<br>Mac OS 9 is able to boot to the desktop if these extensions are removed:
<ul>
<li>Apple Audio Extension</li>
<li>Apple Enet</li>
<li>Multiprocessing folder</li>
<li>Open Transport aslm modules</li>
<li>Text Encoding Converter</li>
</ul>
<BR>
A custom version of OpenBIOS is need to boot Mac OS 9. Use it like this:-bios &lt;path&gt;/openbios-ppc<BR>
Turn off networking because it causes Mac OS 9 to crash: -net none<BR>
<BR>
This is the suggested options to use to run Mac OS 9:<BR>
  ./ppc-softmmu/qemu-system-ppc -bios &lt;path&gt;openbios-ppc -boot d -cdrom &lt;path&gt;os92_test.iso -M mac99 -m 512 -cpu G3 -net none<BR>
<BR>
<u>Debugging tips</u><BR>
Macsbug can be used to tell you what exactly stopped booting. The link for it is below.<BR>
Macsbug can be used to tell you what exactly stopped booting. The link for it is below.<BR>
Mac OS 9.2 comes with a built-in debugger. To use it, set the OpenBIOS variable &#147;APPL,debug&#148;:<BR>
Mac OS 9.2 comes with a built-in debugger. To use it, set the OpenBIOS variable &#147;APPL,debug&#148;:<BR>
Line 147: Line 129:
<BR>
<BR>
<BR>
<BR>
Last Updated: February 26, 2015
Last Updated: November 4, 2016

Revision as of 15:59, 4 November 2016

PowerPC Macintosh Emulator


QEMU Installation Directions for Mac OS X, Windows, and Linux


Guest Compatibility


Note: information based on QEMU version 2.7. This spreadsheet might have more update to date information.

Operating SystemStatus
Mac OS 8.0 to 8.6Prints error stating /rtas node is missing from OpenBIOS
Mac OS 9.09.0.4 boots and installs. Other versions may have issues.
Mac OS 9.1Boots and installs
Mac OS 9.2Boots and installs
Mac OS 10.0Boots and installs
Mac OS 10.1Boots and installs
Mac OS 10.2Boots and installs
Mac OS 10.3Boots and installs
Mac OS 10.4 Boots and installs
Mac OS 10.5Boots to installer, can install on USB disk, but disk doesn't boot. Mouse/keyboard only working with -device ich9-usb-uhci1,id=newusb -device usb-mouse,bus=newusb.0
Debian Linux 5Boots and installs
Ubuntu Linux 5Severe video corruption prevents using it
Lubuntu 12.04Boots live CD and installs, but installation does not boot


Guest Installation

Mac OS 9.x
This is the suggested command-line options to install Mac OS 9:

 ./qemu-system-ppc -hda <hd image file> -M mac99 -m 256 -cdrom <iso file of installation media> -boot d

Mac OS 10.2
Booting from the installation media does work. The beigeg3 target works very well with this operating system.
It is suggested that your initial hard drive image file be at least 5GB in size.

This is the suggested command-line options to install Mac OS 10.2:

 ./qemu-system-ppc -hda <hd image file> -m 400 -prom-env boot-args=-v -cdrom <iso file of installation media> -boot d

Mac OS 10.4
This is the suggested command-line options to install Mac OS 10.4:

 ./qemu-system-ppc -hda <hd image file> -M mac99 -m 512 -prom-env boot-args=-v -boot d -cdrom <iso file of installation media>

If you wish to access the internet thru the Mac OS 10.4 guest, you can by adding this to your QEMU command-line options: 

 -netdev user,id=mynet0 -device usb-net,netdev=mynet0

 or

 -netdev user,id=mynet0 -device rtl8139,netdev=mynet0

Note:Mac OS 10.4 installation CD does not support the beigeg3 target. It will boot up, but a error dialog will say this machine isn&#146;t supported.

Mac OS 9 Debugging tips


Macsbug can be used to tell you what exactly stopped booting. The link for it is below.
Mac OS 9.2 comes with a built-in debugger. To use it, set the OpenBIOS variable &#147;APPL,debug&#148;:

Via QEMU's command-line options:

 -prom-env aapl,debug=2000000


In OpenBIOS type:
dev /
2000000 encode-int *Note: the number can be replaced with the many options available
&#147; AAPL,debug&#148; property
then to boot from a cd type:
boot cd:,\\:tbxi

To boot from a hard drive image:
boot hd:,\\:tbxi

Useful Links

Google Summer of Code Discussion for Mac OS 9
Macsbug 6.6.3 - debugger for Mac OS 9
Darwin OS installation iso file
JQEMU - graphical manager for QEMU (requires Java)

Pictures


Project Builder running inside of QEMU Pong 2001 Carbon

Norton Utilities Host and Guest About Dialogs
Mac OS 9.0.4 Doom running in Mac OS 9.2


How do I help

QEMU has many systems that can always be improved. Here is a brief list of possible areas you may want to work on:

  • Documentation
  • Testing
  • Fixing operating system compatibility issues
  • PowerPC emulation
  • User interface
  • OpenBIOS (firmware)
  • Implement a sound card that is compatible with Mac OS 9 and Mac OS X. The usb-audio device is the closest to working on the Mac OS.
  • Implement a 3D video card
  • Improve various hardware (via-cuda, ata controller, etc..)


Knowledge in these areas could help:

  • PowerPC Assembly
  • 68K Assembly
  • Embedded Programming


Contact

If there are any issues with this page, please contact me

Last Updated: November 4, 2016

Retrieved from "https://wiki.qemu.org/index.php?title=Documentation/Platforms/PowerPC&oldid=6299"