Documentation/Platforms/PowerPC: Difference between revisions

From QEMU
No edit summary
 
(243 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<P><h1>PowerPC Macintosh Emulator</h1><BR>
== PowerPC Emulator (32-bit) ==
<h2>QEMU Installation Directions for Mac OS X</h2><BR>
=== Description ===
<u>System Requirements:</u><BR>
This page is about qemu-system-ppc.
Mac OS 10.5 or higher<BR>
'''Note''': Information below true for qemu-system-ppc builds as of 14-03-2019 <br>
The clang compiler shipped with Xcode 4.2 or higher, or GCC 4.3 or higher<BR>
 
Additional Requirements (install in order):<BR>
The following machines are emulated through qemu-system-ppc:
1. libffi: <FONT COLOR="#0000EE"><U>https://sourceware.org/libffi/</U></FONT><BR>
 
2. gettext: <FONT COLOR="#0000EE"><U>http://www.gnu.org/software/gettext/</U></FONT><BR>
<table>
3. glib: <FONT COLOR="#0000EE"><U>http://ftp.gnome.org/pub/GNOME/sources/glib/</U></FONT><BR>
<tr style="text-decoration:underline;">
4. pkg-config: <FONT COLOR="#0000EE"><U>http://www.freedesktop.org/wiki/Software/pkg-config/</U></FONT><BR>
<td width=300px>Machine model selector</td><td>Provides</td>
5. autoconf: <FONT COLOR="#0000EE"><U>http://www.gnu.org/software/autoconf/autoconf.html</U></FONT><BR>
</tr>
6. automake: <FONT COLOR="#0000EE"><U>http://www.gnu.org/software/automake/</U></FONT><BR>
<tr>
7. libtool: <FONT COLOR="#0000EE"><U>http://www.gnu.org/software/libtool/</U></FONT><BR>
<td>-M g3beige </td><td>Heathrow based PowerMAC (default)</td>
8. pixman: <FONT COLOR="#0000EE"><U>http://www.pixman.org/</U></FONT><BR>
</tr>
* You may find it easiest to get these from a third-party packager such as Homebrew, Macports, or Fink.<BR>
<tr>
After downloading the QEMU source code, double-click it to expand it.<BR>
<td>-M mac99 </td><td>Mac99 based PowerMAC<tr>
Then configure and make QEMU:<BR>
</tr>
./configure --disable-gtk --disable-sdl --target-list=ppc-softmmu<BR>
<tr>
make<BR>
<td>-M 40p </td><td>IBM RS/6000 7020 (40p)</td>
If you have a recent version of Mac OS X (OSX 10.7 or better with Xcode 4.2 or better) we recommend building QEMU with the default compiler provided by Apple, for your version of Mac OS X (which will be 'clang'). The configure script will automatically pick this.<BR>
</tr>
Note: If after the configure step you see a message like this:<BR>
<tr>
ERROR: Your compiler does not support the __thread specifier for Thread-Local Storage (TLS). Please upgrade to a version that does.<BR>
<td>-M bamboo </td><td>Bamboo</td>
you may have to build your own version of gcc from source. Expect that to take several hours. More information can be found here: <FONT COLOR="#0000EE"><U>https://gcc.gnu.org/install/</U></FONT> <BR>
</tr>
These are some of the third party binaries of gcc available for download:<BR>
<tr>
Homebrew: <FONT COLOR="#0000EE"><U>http://brew.sh/</U></FONT><BR>
<td>-M mpc8544ds </td><td>Mpc8544ds</td>
<FONT COLOR="#0000EE"> &#149; <U>https://www.litebeam.net/gcc/gcc_472.pkg</U></FONT><BR>
</tr>
<FONT COLOR="#0000EE"> &#149; <U>http://www.macports.org/ports.php?by=name&amp;substr=gcc</U></FONT><BR>
<tr>
You can have several versions of GCC on your system. To specify a certain version, use the &#150;cc and &#150;cxx options.<BR>
<td>-M none </td><td>Empty machine</td>
./configure --cxx=&lt;path of your c++ compiler&gt; --cc=&lt;path of your c compiler&gt; &lt;other options&gt;<B><BR>
</tr>
</B><BR>
<tr>
<BR>
<td>-M ppce500 </td><td>Generic paravirt e500 platform</td>
<h2>Guest Compatibility</h2>
</tr>
<tr>
<td>-M prep </td><td>PowerPC PREP platform (deprecated in favour of the 40p machine )</td>
</tr>
<tr>
<td>-M ref405ep </td><td>Ref405ep</td>
</tr>
<tr>
<td>-M amigaone </td><td>Eyetech AmigaOne/Mai Logic Teron</td>
</tr>
<tr>
<td>-M sam460ex </td><td>aCube Sam460ex</td>
</tr>
<tr>
<td>-M virtex-ml507 </td><td>Xilinx Virtex ML507 reference design</td>
</table>
 
=== Build directions ===
  ./configure --target-list=ppc-softmmu && make
Due to mouse issues when using the default GTK GUI in Windows, it is advisable to use the SDL-based GUI when compiling on/for that platform:
  ./configure --target-list=ppc-softmmu --enable-sdl && make
 
=== Pre-built binaries for Windows and OSX ===
Pre-built binaries for Windows can be found here: https://qemu.weilnetz.de/w64/ <br>
Pre-built binaries for OSX are provided at the emaculation website: https://www.emaculation.com/forum/viewtopic.php?f=34&t=8848 <br>
Experimental builds for Windows/OSX with e.g., sound support are provided at the emaculation website: https://www.emaculation.com/forum/viewtopic.php?f=34&t=8848&p=52102#p52104 and here: https://www.emaculation.com/forum/viewtopic.php?f=34&t=9028
 
=== Additional guides ===
Some guides detailing running Mac OS/ OS X or Amiga-like OSes are available off-site:<br>
https://www.emaculation.com/doku.php/qemu/ <br>
http://zero.eik.bme.hu/~balaton/qemu/amiga/
 
=== PowerMac G4 and G3 emulation ===
 
PowerPC Mac G4 (Mac Model PowerPC3,1) and PowerPC Mac G3 emulation<br>
 
The PowerPC Mac G4 -m mac99 machine model selector has three options:
 
<table>
<tr style="text-decoration:underline;">
<td width=300px>Machine model selector options</td><td>Provides</td>
</tr>
<tr>
<td>-M mac99,via=pmu </td><td>pmu power management, providing USB mouse and keyboard</td>
</tr>
<tr>
<td>-M mac99,via=pmu-adb </td><td>pmu power management with adb bus for older OSs not supporting USB</td>
</tr>
<tr>
<td>-M mac99,via=cuda </td><td>cuda power management with adb bus (this is the default)</td>
</tr>
</table>
 
Optional commands:
 
<table>
<tr style="text-decoration:underline;">
<td width=300px>Optional commands</td><td width=200px>Default</td><td>Provides</td>
</tr>
<tr>
<td>-prom-env "auto-boot?=true"</td><td>yes</td><td>Automatic boot at openbios prompt</td>
</tr>
<tr>
<td>-prom-env "boot-args=-v" </td><td>no</td><td>Verbose start-up of OSX guests</td>
</tr>
<tr>
<td>-prom-env "vga-ndrv?=true" </td><td>yes</td><td>On the fly resolution/colour depth switching for Mac OS/OS X guests<td>
</tr>
<tr>
<td>-device VGA,edid=on </td><td>no</td><td>Provides additional screen resolutions for Mac OS/OS X guests<td>
</tr>
</table>
 
==== Mac OS/OSX and Linux guest compatibility ====
 
<table>
<table>
<tr style="text-decoration:underline;">
<tr style="text-decoration:underline;">
<td width=110px>Operating System</td><td>Status</td>
<td width=300px>Operating system</td><td width=200px>Status</td><td>Remarks</td>
</tr>
<tr>
<td>Mac OS 8.0 to 8.6</td><td>Not supported</td>
</tr>
<tr>
<td>Mac OS 9.0</td><td>Boots, installs, runs</td><td>Requires 9.0.4 with rom version 5.2.1 and above (e.g., 9.0.4 for the Cube)</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 9.1</td><td>Does not boot</td>
<td>Mac OS 9.1</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 9.2</td><td>Boots - but several extensions need to be removed because of crashing</td>
<td>Mac OS 9.2</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 10.0</td><td>Does not successfully boot</td>
<td>Mac OS 10.0</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 10.1</td><td>Untested</td>
<td>Mac OS 10.1</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 10.2</td><td>Successfully boots and installs</td>
<td>Mac OS 10.2</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 10.3</td><td>Can boot, unknown if it installs</td>
<td>Mac OS 10.3</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 10.4</td><td>Can boot, but doesn't install</td>
<td>Mac OS 10.4</td><td>Boots, installs, runs</td>
</tr>
</tr>
<tr>
<tr>
<td>Mac OS 10.5</td><td>Untested</td>
<td>Mac OS 10.5</td><td>Boots, installs, runs</td><td>Requires -m mac99,via=pmu to run</td>
</tr>
</tr>
<tr>
<tr>
<td>Debian Linux 5</td><td>Boots and installs</td>
<td>Mac OSX Server 1.2v3</td><td>Boots, installs, runs</td><td>No networking due to lack of gigabit ethernet support</td>
</tr>
</tr>
<tr>
<tr>
<td>Ubuntu Linux 5</td><td>Severe video corruption prevents using it</td>
<td>Lubuntu 14</td><td>Boots, installs, runs</td><td>Requires -g 1024x768x8 to see text while installing</td>
</tr>
<tr>
<td>Fedora 12</td><td>Boots, installs, runs</td><td>Requires -g 1024x768x8 to see text while installing</td>
</tr>
<tr>
<td>Debian 10</td><td>Boots, installs, runs</td><td>Requires -g 1024x768x8 to see text while installing</td>
</tr>
<tr>
<td>OpenSuse 11</td><td>Boots, installs, runs</td><td>Requires -device rtl8139 for networking, -g 1024x768x8 to see text while installing</td>
</tr>
<tr>
<td>Yellow Dog Linux 6.2</td><td>Boots, installs, runs</td><td>Requires -device rtl8139 for networking, -g 1024x768x8 to see text while installing</td>
</tr>
</tr>
</table>
</table>


<BR>
==== Guest installation instructions ====
<h2>Guest Installation</h2>
 
<u>Mac OS 10.2</u><br>
==== Mac OS 9.x to Mac OS X 10.4 ====
Booting from the installation media does work. The beigeg3 target works very well with this operating system.<BR>
Command-line options to install Mac OS:<br>
<BR>
  ./qemu-system-ppc -L pc-bios -boot d -M mac99 -m 512 -hda <hd image file> -cdrom <iso file of installation media>  
<u>Mac OS 10.4</u><BR>
 
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>
Command-line options to run Mac OS:<br>
Booting from the mac99 target ends with the message &#147;Still waiting for root device&#148; being printed repeatedly.<BR>
  ./qemu-system-ppc -L pc-bios -boot c -M mac99 -m 512 -hda <hd image file>
It is still possible to make Mac OS 10.4 work in QEMU. I installed Mac OS 10.4 onto a flash drive from a PowerPC Macintosh. Then using Disk Utility to make an image file of the flash drive made a bootable image file for QEMU. The format of the flash drive has to be Mac OS Extended Journaled (HFS+ journaled). If the image file is a .dmg file, replace the extension with .img to make it work in QEMU. <BR>
 
If you wish to access the internet thru the Mac OS 10.4 guest, you can by adding this to QEMU command options: <BR>
==== Mac OS X 10.5 ====
   -net none -netdev user,id=mynet0 -device usb-net,netdev=mynet0<BR>
Command-line options to install Mac OS X 10.5:<br>
<BR>
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 512 -hda <hd image file> -cdrom <iso file of installation media>
<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].  
Command-line options to run Mac OS X 10.5:<br>
<br>Mac OS 9 is able to boot to the desktop if these extensions are removed:
  ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 512 -hda <hd image file>
<ul>
 
<li>Apple Audio Extension</li>
==== Mac OS X Server 1.2v3 ====
<li>Apple Enet</li>
Installation requires several steps. Only use an .img HD, qcow2 will not work: <br>
<li>Multiprocessing folder</li>
Step 1: boot from installation CD, use disk utility to partition disk as Apple Server, start the installation and let it fail. Quit Qemu and reboot with command line in step 2.
<li>Open Transport aslm modules</li>
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu-adb -m 256 -net none -prom-env "auto-boot?=true"  -prom-env "boot-args=-v" \
<li>Text Encoding Converter</li>
  -cdrom OSXServer1.2v3.iso -hda OSXServer1.2v3.img
</ul>
 
<BR>
Step 2: initial installation (note machine and CPU, otherwise no desktop is shown).  
A custom version of OpenBIOS is need to boot Mac OS 9. Use it like this:-bios &lt;path&gt;/openbios-ppc<BR>
  ./qemu-system-ppc -L pc-bios -boot d -M g3beige -cpu G3 -m 256 -prom-env "boot-args=-v" -prom-env "auto-boot?=false" -net none \
Turn off networking because it causes Mac OS 9 to crash: -net none<BR>
  -hda OSXServer1.2v3.img -cdrom OSXServer1.2v3.iso
<BR>
 
This is the suggested options to use to run Mac OS 9:<BR>
At the boot prompt enter "boot cd:9,\\:tbxi" Initial installation starts. Quit Qemu after completion.
  ./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>
Step 3: Installation continued. Boot with the following command line to complete the installation.
<u>Debugging tips</u><BR>
  ./qemu-system-ppc -L pc-bios -boot c -M g3beige -cpu G3 -m 256 -prom-env "boot-args=-v" -prom-env "auto-boot?=true" -net none \
Macsbug can be used to tell you what exactly stopped booting. The link for it is below.<BR>
  -hda OSXServer1.2v3.img -cdrom OSXServer1.2v3.iso
 
Step 4: Boot the installed system:
   ./qemu-system-ppc -L pc-bios -boot c -M g3beige -cpu G3 -m 256 -prom-env "boot-args=-v" -prom-env "auto-boot?=true" -net none \
  -hda OSXServer1.2v3.img -cdrom OSXServer1.2v3.iso
 
==== Lubuntu 14 ====
Installation:
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
  -hda lubuntu14.qcow2 -cdrom lubuntu-14.04.5-desktop-powerpc.iso
 
Running:
  ./qemu-system-ppc -L pc-bios -boot c -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
  -M mac99,via=pmu -m 1024 -hda lubuntu14.qcow2
 
==== Fedora 12 ====
Installing:
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
  -hda fedora12.qcow2 -cdrom Fedora-12-ppc-DVD.iso -g 1024x768x16
Running:
  ./qemu-system-ppc -L pc-bios -boot c -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
  -M mac99,via=pmu -m 1024 -hda fedora12.qcow2 -g 1024x768x32
 
==== Debian 10 (Buster) ====
Note: To get a graphical desktop, at software selection, remove the default desktop environment and install only Xfce<br>
Installing:
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
  -hda debian10.qcow2 -cdrom debian-10.0-powerpc-NETINST-1.iso -g 1024x768x8
Running:
  ./qemu-system-ppc -L pc-bios -boot c -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
  -M mac99,via=pmu -m 1024 -hda debian10.qcow2 -g 1024x768x32
 
At the Linux boot prompt enter "Linux modprobe.blacklist=bochs_drm" <br>
 
Pre-installed images of Debian 6 (Squeeze) and 7 (Wheezy) (both minimal and with desktop) can be found here: https://people.debian.org/~aurel32/qemu/powerpc/
 
These images boot with:
  ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 1024 \
  -hda debian_wheezy_powerpc_desktop.qcow2 -g 1024x768x32
 
==== OpenSuse 11 ====
Installing: <br>
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 512 -net nic,model=rtl8139 \
  -net user -hda opensuse11.qcow2 -cdrom opensuse11.iso -g 1024x768x16
 
Once the license screen appears, press Ctrl-Alt-Shift-X to open a terminal. Follow https://en.opensuse.org/SDB:Install_openSUSE_on_an_Apple_PPC_computer to create partitions with pdisk. Write the map after partitioning and continue with Yast. Once Yast arrives at partitioning, select Expert partitioning, select the Hard disk and click Rescan disk.
<br>
Leave hda2 as it is.<br>
Edit hda3 to format as Ext2, mount at /boot and set fstab option to: Mount in /etc/fstab by to Device Path (instead of Device ID)<br>
Edit hda4 to format as Swap and set fstab option to: Mount in /etc/fstab by to Device Path (instead of Device ID)<br>
Edit hda5 to format as Ext3, mount at / and set fstab option to: Mount in /etc/fstab by to Device Path (instead of Device ID)<br>
 
Accept the partitioning and continue with formatting. Continue installing. There will be an error while the boot manager is being installed. Ignore it, do not retry and wait for the installation to finish and the system reboots. Quit Qemu at the openbios screen and edit your command line:
  ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 512 -net nic,model=rtl8139 \
  -net user -hda opensuse11.qcow2 -cdrom opensuse11.iso -g 1024x768x32
 
==== Yellow Dog Linux 6.2 ====
Installing: <br>
  ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
  -netdev user,id=network01 -device rtl8139,netdev=network01 \
  -cdrom <installation-image> -hda <hard disk image> -g 1024x768x16
 
Running: <br>
  ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 1024 \
  -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
  -netdev user,id=network01 -device rtl8139,netdev=network01 \
  -hda <hard disk image> -g 1024x768x16
 
=== IBM RS/6000 7020 (40p) ===
 
The 40p machine can be booted with the sandalfoot zImage from:
http://www.juneau-lug.org/zImage.initrd.sandalfoot
 
Booting:
  ./qemu-system-ppc -M 40p -cdrom zImage.initrd.sandalfoot -boot d
 
<!-- Booting AIX 5.1 (will become available in Qemu 4.1, take q40pofw-serial.rom from https://github.com/artyom-tarasenko/openfirmware/releases/download/20190406-AIX-boots/q40pofw-serial.rom) qemu-system-ppc -M 40p -bios q40pofw-serial.rom -serial telnet::4441,server -hda aix-hdd.qcow2 -cdrom \
/path/to/aix-5.1-cd1.iso  -vga none -nographic -->
 
=== Bamboo ===
 
  ./qemu-system-ppc -m bamboo
 
=== Mpc8544ds ===
 
  ./qemu-system-ppc -m mpc8544ds
 
=== Empty machine ===
 
  ./qemu-system-ppc -m none
 
=== Generic paravirt e500 platform ===
 
  ./qemu-system-ppc -m ppce500
 
=== PowerPC PREP platform (deprecated in favour of the 40p machine) ===
 
  ./qemu-system-ppc -m prep
 
=== Ref405ep ===
 
  ./qemu-system-ppc -m ref405ep
 
=== Eyetech AmigaOne/Mai Logic Teron ===
 
The AmigaNG boards (amigaone, pegasos2, sam460ex) are primarily used for running Amiga-like OSes (AmigaOS 4, MorphOS and AROS) but these can also run Linux.
 
Eyetech AmigaOne/Mai Logic Teron (amigaone)
The amigaone machine emulates an AmigaOne XE mainboard by Eyetech which is a rebranded Mai Logic Teron board with modified U-Boot firmware to support AmigaOS 4.
 
Emulated devices:
* PowerPC 7457 CPU (can also use``-cpu g3, 750cxe, 750fx`` or ``750gx``)
* Articia S north bridge
* VIA VT82C686B south bridge
* PCI VGA compatible card (guests may need other card instead)
* PS/2 keyboard and mouse
 
To boot, a modified U-Boot binary is needed. While released under GPL, its source is lost so it cannot be included in QEMU.
A binary is available at https://www.hyperion-entertainment.com/index.php/downloads?view=files&parent=28.
The ROM image is in the last 512kB of the file, which, on a linux host, can be extracted with the command:
 
  tail -c 524288 updater.image > u-boot-amigaone.bin
 
The BIOS emulator in the firmware is unable to run QEMU‘s standard vgabios so VGABIOS-lgpl-latest.bin is needed instead.
This can be downloaded from http://www.nongnu.org/vgabios.
 
You can find some Linux images that work on the amigaone machine at the following link:
https://sourceforge.net/projects/amigaone-linux/files/debian-installer/
 
Booting:
 
  ./qemu-system-ppc -machine amigaone -bios u-boot-amigaone.bin \
  -cdrom "A1 Linux Net Installer.iso" \
  -device ati-vga,model=rv100,romfile=VGABIOS-lgpl-latest.bin
 
From the firmware menu that appears select Boot sequence, Amiga Multiboot Options and set Boot device 1 to Onboard VIA IDE CDROM.
Then hit escape until the main screen appears, hit escape once more and from the exit menu select either Save settings and exit or Use settings for this session only.
It may take a long time loading the kernel into memory but eventually it boots and the installer becomes visible.
The ati-vga RV100 emulation is not complete yet so only frame buffer works, DRM and 3D is not available.
 
=== aCube Sam460ex ===
 
Booting:
  ./qemu-system-ppc -machine sam460ex -rtc base=localtime \
  -drive if=none,id=cd,file=Sam460InstallCD-53.58.iso,format=raw \
  -device ide-cd,drive=cd,bus=ide.1
 
=== Xilinx Virtex ML507 reference design ===
 
  ./qemu-system-ppc -m virtex-ml507
 
== Debugging tips ==
=== Command line options ===
  -d unimp,guest_errors
(logs unimplemented features and guest errors to stdout)
 
  -trace 'pmu_*'
(logs all PMU accesses to stdout)
 
  -trace 'usb*'
(logs all USB accesses to stdout)
 
=== Macsbug ===
Macsbug can be used with Mac OS guest 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>
<BR>
<BR>
Via QEMU's command-line options:<br>
  -prom-env aapl,debug=2000000
In OpenBIOS type:<BR>
In OpenBIOS type:<BR>
dev /<BR>
dev /<BR>
Line 109: Line 366:
To boot from a hard drive image:<BR>
To boot from a hard drive image:<BR>
boot hd:,\\:tbxi<BR>
boot hd:,\\:tbxi<BR>
<BR>
 
<h2>Useful Links</h2>
=== Debugging qemu-system-ppc with GDB on an x86 Linux host ===
 
To build gdb-powerpc-linux on Linux, you need the normal build tools such as GCC installed.
Download the GDB source code. Version 7.9 is reported to work: http://ftp.gnu.org/gnu/gdb/gdb-7.9.tar.gz
Unpack it and cd into the dir, then build and install with:
 
  ./configure -target=powerpc-linux --enable-sim-powerpc
  make && sudo make install
 
Launch qemu-system-ppc(64) with -s and -S. Qemu will pause and listen on port 1234 for GDB.
Set -prom-env "auto-boot?=false" --nographic on the command line for the Qemu instance to be debugged.
 
  qemu-system-ppc -s -S -prom-env "auto-boot?=false" --nographic
 
Open another terminal and launch the GDB you just built:
 
  gdb-powerpc-linux
  target remote localhost:1234
  continue
 
You can set a breakpoint in GDB, like this:
 
  break *0x20dccc
 
Type "boot" in the terminal running Qemu.
 
== Emulated hardware issues ==
=== Mac OS ===
-Only Mac OS 9.x support sound well. Use an experimental build.<br>
-Mac OS 9.x will not boot with 64 Mb or less memory. They will also not boot with more than 1024 Mb.<br>
 
== Links ==
Installation images: <BR>
[http://cdimage.ubuntu.com/lubuntu/releases/14.04/release/lubuntu-14.04.5-desktop-powerpc.iso Lubuntu 14.04 PPC release]<BR>
[http://iso.linuxquestions.org/download/451/1507/http/download.opensuse.org/openSUSE-11.0-DVD-ppc.iso OpenSuse 11 PPC release]<BR>
[https://archives.fedoraproject.org/pub/archive/fedora/linux/releases/12/Fedora/ppc/iso/Fedora-12-ppc-DVD.iso Fedora 12 PPC release]<BR>
[http://cdimage.ubuntu.com/ubuntu-mate/releases/16.04.4/release/ubuntu-mate-16.04.1-desktop-powerpc.iso Ubuntu Mate 16.04 PPC release] <BR>
[http://nappe.acc.umu.se/mirror/cdimage/ports/10.0/powerpc/iso-cd/debian-10.0-powerpc-NETINST-1.iso Debian 10 PPC release]<br>
[http://dl.sda1.eu/linux/yellowdog/yellowdog-6.2-ppc-DVD_20090629.iso Yellow Dog Linux 6.2]<br>
 
[http://www.emaculation.com/forum/viewtopic.php?f=34&t=7047&sid=67661b0a18610c86b115cdff98d68010 Google Summer of Code Discussion for Mac OS 9]<BR>
[http://www.emaculation.com/forum/viewtopic.php?f=34&t=7047&sid=67661b0a18610c86b115cdff98d68010 Google Summer of Code Discussion for Mac OS 9]<BR>
[http://www.macgui.com/downloads/?file_id=22125 Macsbug 6.6.3] - debugger for Mac OS 9<BR>
[http://www.macgui.com/downloads/?file_id=22125 Macsbug 6.6.3] - debugger for Mac OS 9<BR>
[https://opensource.apple.com/static/iso/ Darwin OS installation iso file]<BR>
[https://opensource.apple.com/static/iso/ Darwin OS installation iso file]<BR>
[http://sourceforge.net/projects/jqemu/ JQEMU] - graphical manager for QEMU (requires Java)<BR>
[http://sourceforge.net/projects/jqemu/ JQEMU] - graphical manager for QEMU (requires Java)<BR>
[http://wiibrew.org/wiki/Assembler_Tutorial PowerPC Assembly Language Tutorial]<br>
[https://lists.nongnu.org/mailman/listinfo/qemu-ppc QEMU PowerPC mailing list]<br>
[http://lowendmac.com/1997/beige-power-mac-g3-1997/ Beige Power Mac G3 info]<br>
[http://lowendmac.com/1999/power-mac-g4-sawtooth/ Sawtooth Power Mac G4 info]<br>
<BR>
<BR>
<h2>Pictures</h2><BR>
 
== Pictures ==
[[File:ProjectBuilder.png|300px|Project Builder running inside of QEMU]]<span style="margin:20px;"></span>
[[File:ProjectBuilder.png|300px|Project Builder running inside of QEMU]]<span style="margin:20px;"></span>
[[File:MacPong2001.jpg|300px|Pong 2001 Carbon]] <BR><br>
[[File:MacPong2001.jpg|300px|Pong 2001 Carbon]] <BR><br>
[[File:NortonUtilities.jpg|300px|Norton Utilities]]<span style="margin:20px;"></span>
[[File:NortonUtilities.jpg|300px|Norton Utilities]]<span style="margin:20px;"></span>
[[File:AboutDialog.jpg|300px|Host and Guest About Dialogs]]<BR>
[[File:AboutDialog.jpg|300px|Host and Guest About Dialogs]]<BR>
[[File:MacOS9_with_Graphing_Calculator.png|300px|Mac OS 9 with Graphing Calculator running]]<span style="margin:20px;"></span>
[[File:Doom_running_in_Mac_OS_9.png|300px|Doom running in Mac OS 9.2]]<BR>
[[File:OpenSUSE.png|300px|OpenSUSE]]<BR>
<BR>
<BR>
<h2>How do I help</h2>
 
== 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:<BR>
QEMU has many systems that can always be improved. Here is a brief list of possible areas you may want to work on:<BR>
<ul>
<ul>
Line 130: Line 435:
<li>PowerPC emulation</li>
<li>PowerPC emulation</li>
<li>User interface</li>
<li>User interface</li>
<li>OpenBIOS (firmware)</li>
<li>[https://www.openfirmware.info/Welcome_to_OpenBIOS OpenBIOS (firmware)]</li>
<li>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.</li>
<li>Implement a 3D video card</li>
<li>Implement a 3D video card</li>
<li>Implement a network interface card that is compatible with Mac OS 9 and Mac OS X. The rtl8139 is already implemented and might need a few tweaks to work in the Mac OS. </li>
<li>Improve various hardware (via-cuda, ata controller, etc..)</li>
<li>Improve various hardware (via-cuda, ata controller, etc..)</li>
</ul><br>
</ul><br>
Line 142: Line 445:
<li>Embedded Programming</li>
<li>Embedded Programming</li>
</ul>
</ul>
<BR>
<h2>Contacts</h2>
<h2>Contact</h2>
Maintainer: David Gibson [mailto:david@gibson.dropbear.id.au david@gibson.dropbear.id.au]<BR>
If there are any issues with this page, please [mailto:programmingkidx@gmail.com contact me]
If there are any issues with this page, please [mailto:programmingkidx@gmail.com contact me]<br>
<BR>
<BR>
Last Updated: December 5, 2015

Latest revision as of 19:36, 17 February 2024

PowerPC Emulator (32-bit)

Description

This page is about qemu-system-ppc. Note: Information below true for qemu-system-ppc builds as of 14-03-2019

The following machines are emulated through qemu-system-ppc:

Machine model selectorProvides
-M g3beige Heathrow based PowerMAC (default)
-M mac99 Mac99 based PowerMAC
-M 40p IBM RS/6000 7020 (40p)
-M bamboo Bamboo
-M mpc8544ds Mpc8544ds
-M none Empty machine
-M ppce500 Generic paravirt e500 platform
-M prep PowerPC PREP platform (deprecated in favour of the 40p machine )
-M ref405ep Ref405ep
-M amigaone Eyetech AmigaOne/Mai Logic Teron
-M sam460ex aCube Sam460ex
-M virtex-ml507 Xilinx Virtex ML507 reference design

Build directions

 ./configure --target-list=ppc-softmmu && make

Due to mouse issues when using the default GTK GUI in Windows, it is advisable to use the SDL-based GUI when compiling on/for that platform:

 ./configure --target-list=ppc-softmmu --enable-sdl && make

Pre-built binaries for Windows and OSX

Pre-built binaries for Windows can be found here: https://qemu.weilnetz.de/w64/
Pre-built binaries for OSX are provided at the emaculation website: https://www.emaculation.com/forum/viewtopic.php?f=34&t=8848
Experimental builds for Windows/OSX with e.g., sound support are provided at the emaculation website: https://www.emaculation.com/forum/viewtopic.php?f=34&t=8848&p=52102#p52104 and here: https://www.emaculation.com/forum/viewtopic.php?f=34&t=9028

Additional guides

Some guides detailing running Mac OS/ OS X or Amiga-like OSes are available off-site:
https://www.emaculation.com/doku.php/qemu/
http://zero.eik.bme.hu/~balaton/qemu/amiga/

PowerMac G4 and G3 emulation

PowerPC Mac G4 (Mac Model PowerPC3,1) and PowerPC Mac G3 emulation

The PowerPC Mac G4 -m mac99 machine model selector has three options:

Machine model selector optionsProvides
-M mac99,via=pmu pmu power management, providing USB mouse and keyboard
-M mac99,via=pmu-adb pmu power management with adb bus for older OSs not supporting USB
-M mac99,via=cuda cuda power management with adb bus (this is the default)

Optional commands:

Optional commandsDefaultProvides
-prom-env "auto-boot?=true"yesAutomatic boot at openbios prompt
-prom-env "boot-args=-v" noVerbose start-up of OSX guests
-prom-env "vga-ndrv?=true" yesOn the fly resolution/colour depth switching for Mac OS/OS X guests
-device VGA,edid=on noProvides additional screen resolutions for Mac OS/OS X guests

Mac OS/OSX and Linux guest compatibility

Operating systemStatusRemarks
Mac OS 8.0 to 8.6Not supported
Mac OS 9.0Boots, installs, runsRequires 9.0.4 with rom version 5.2.1 and above (e.g., 9.0.4 for the Cube)
Mac OS 9.1Boots, installs, runs
Mac OS 9.2Boots, installs, runs
Mac OS 10.0Boots, installs, runs
Mac OS 10.1Boots, installs, runs
Mac OS 10.2Boots, installs, runs
Mac OS 10.3Boots, installs, runs
Mac OS 10.4Boots, installs, runs
Mac OS 10.5Boots, installs, runsRequires -m mac99,via=pmu to run
Mac OSX Server 1.2v3Boots, installs, runsNo networking due to lack of gigabit ethernet support
Lubuntu 14Boots, installs, runsRequires -g 1024x768x8 to see text while installing
Fedora 12Boots, installs, runsRequires -g 1024x768x8 to see text while installing
Debian 10Boots, installs, runsRequires -g 1024x768x8 to see text while installing
OpenSuse 11Boots, installs, runsRequires -device rtl8139 for networking, -g 1024x768x8 to see text while installing
Yellow Dog Linux 6.2Boots, installs, runsRequires -device rtl8139 for networking, -g 1024x768x8 to see text while installing

Guest installation instructions

Mac OS 9.x to Mac OS X 10.4

Command-line options to install Mac OS:

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

Command-line options to run Mac OS:

 ./qemu-system-ppc -L pc-bios -boot c -M mac99 -m 512 -hda <hd image file>

Mac OS X 10.5

Command-line options to install Mac OS X 10.5:

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 512 -hda <hd image file> -cdrom <iso file of installation media>

Command-line options to run Mac OS X 10.5:

 ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 512 -hda <hd image file>

Mac OS X Server 1.2v3

Installation requires several steps. Only use an .img HD, qcow2 will not work:
Step 1: boot from installation CD, use disk utility to partition disk as Apple Server, start the installation and let it fail. Quit Qemu and reboot with command line in step 2.

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu-adb -m 256 -net none -prom-env "auto-boot?=true"  -prom-env "boot-args=-v" \
 -cdrom OSXServer1.2v3.iso -hda OSXServer1.2v3.img

Step 2: initial installation (note machine and CPU, otherwise no desktop is shown).

 ./qemu-system-ppc -L pc-bios -boot d -M g3beige -cpu G3 -m 256 -prom-env "boot-args=-v" -prom-env "auto-boot?=false" -net none \
 -hda OSXServer1.2v3.img -cdrom OSXServer1.2v3.iso

At the boot prompt enter "boot cd:9,\\:tbxi" Initial installation starts. Quit Qemu after completion.

Step 3: Installation continued. Boot with the following command line to complete the installation.

 ./qemu-system-ppc -L pc-bios -boot c -M g3beige -cpu G3 -m 256 -prom-env "boot-args=-v" -prom-env "auto-boot?=true" -net none \
 -hda OSXServer1.2v3.img -cdrom OSXServer1.2v3.iso

Step 4: Boot the installed system:

 ./qemu-system-ppc -L pc-bios -boot c -M g3beige -cpu G3 -m 256 -prom-env "boot-args=-v" -prom-env "auto-boot?=true" -net none \
 -hda OSXServer1.2v3.img -cdrom OSXServer1.2v3.iso

Lubuntu 14

Installation:

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
 -hda lubuntu14.qcow2 -cdrom lubuntu-14.04.5-desktop-powerpc.iso

Running:

 ./qemu-system-ppc -L pc-bios -boot c -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
 -M mac99,via=pmu -m 1024 -hda lubuntu14.qcow2

Fedora 12

Installing:

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
 -hda fedora12.qcow2 -cdrom Fedora-12-ppc-DVD.iso -g 1024x768x16 

Running:

 ./qemu-system-ppc -L pc-bios -boot c -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
 -M mac99,via=pmu -m 1024 -hda fedora12.qcow2 -g 1024x768x32

Debian 10 (Buster)

Note: To get a graphical desktop, at software selection, remove the default desktop environment and install only Xfce
Installing:

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
 -hda debian10.qcow2 -cdrom debian-10.0-powerpc-NETINST-1.iso -g 1024x768x8

Running:

 ./qemu-system-ppc -L pc-bios -boot c -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
 -M mac99,via=pmu -m 1024 -hda debian10.qcow2 -g 1024x768x32

At the Linux boot prompt enter "Linux modprobe.blacklist=bochs_drm"

Pre-installed images of Debian 6 (Squeeze) and 7 (Wheezy) (both minimal and with desktop) can be found here: https://people.debian.org/~aurel32/qemu/powerpc/

These images boot with:

 ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 1024 \
 -hda debian_wheezy_powerpc_desktop.qcow2 -g 1024x768x32

OpenSuse 11

Installing:

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 512 -net nic,model=rtl8139 \
 -net user -hda opensuse11.qcow2 -cdrom opensuse11.iso -g 1024x768x16 

Once the license screen appears, press Ctrl-Alt-Shift-X to open a terminal. Follow https://en.opensuse.org/SDB:Install_openSUSE_on_an_Apple_PPC_computer to create partitions with pdisk. Write the map after partitioning and continue with Yast. Once Yast arrives at partitioning, select Expert partitioning, select the Hard disk and click Rescan disk.
Leave hda2 as it is.
Edit hda3 to format as Ext2, mount at /boot and set fstab option to: Mount in /etc/fstab by to Device Path (instead of Device ID)
Edit hda4 to format as Swap and set fstab option to: Mount in /etc/fstab by to Device Path (instead of Device ID)
Edit hda5 to format as Ext3, mount at / and set fstab option to: Mount in /etc/fstab by to Device Path (instead of Device ID)

Accept the partitioning and continue with formatting. Continue installing. There will be an error while the boot manager is being installed. Ignore it, do not retry and wait for the installation to finish and the system reboots. Quit Qemu at the openbios screen and edit your command line:

 ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 512 -net nic,model=rtl8139 \
 -net user -hda opensuse11.qcow2 -cdrom opensuse11.iso -g 1024x768x32

Yellow Dog Linux 6.2

Installing:

 ./qemu-system-ppc -L pc-bios -boot d -M mac99,via=pmu -m 1024 \
 -netdev user,id=network01 -device rtl8139,netdev=network01 \
 -cdrom <installation-image> -hda <hard disk image> -g 1024x768x16

Running:

 ./qemu-system-ppc -L pc-bios -boot c -M mac99,via=pmu -m 1024 \
 -prom-env "boot-device=hd:,\yaboot" -prom-env "boot-args=conf=hd:,\yaboot.conf" \
 -netdev user,id=network01 -device rtl8139,netdev=network01 \
 -hda <hard disk image> -g 1024x768x16

IBM RS/6000 7020 (40p)

The 40p machine can be booted with the sandalfoot zImage from: http://www.juneau-lug.org/zImage.initrd.sandalfoot

Booting:

 ./qemu-system-ppc -M 40p -cdrom zImage.initrd.sandalfoot -boot d


Bamboo

 ./qemu-system-ppc -m bamboo

Mpc8544ds

 ./qemu-system-ppc -m mpc8544ds

Empty machine

 ./qemu-system-ppc -m none

Generic paravirt e500 platform

 ./qemu-system-ppc -m ppce500

PowerPC PREP platform (deprecated in favour of the 40p machine)

 ./qemu-system-ppc -m prep

Ref405ep

 ./qemu-system-ppc -m ref405ep

Eyetech AmigaOne/Mai Logic Teron

The AmigaNG boards (amigaone, pegasos2, sam460ex) are primarily used for running Amiga-like OSes (AmigaOS 4, MorphOS and AROS) but these can also run Linux.

Eyetech AmigaOne/Mai Logic Teron (amigaone) The amigaone machine emulates an AmigaOne XE mainboard by Eyetech which is a rebranded Mai Logic Teron board with modified U-Boot firmware to support AmigaOS 4.

Emulated devices:

* PowerPC 7457 CPU (can also use``-cpu g3, 750cxe, 750fx`` or ``750gx``)
* Articia S north bridge
* VIA VT82C686B south bridge
* PCI VGA compatible card (guests may need other card instead)
* PS/2 keyboard and mouse

To boot, a modified U-Boot binary is needed. While released under GPL, its source is lost so it cannot be included in QEMU. A binary is available at https://www.hyperion-entertainment.com/index.php/downloads?view=files&parent=28. The ROM image is in the last 512kB of the file, which, on a linux host, can be extracted with the command:

 tail -c 524288 updater.image > u-boot-amigaone.bin

The BIOS emulator in the firmware is unable to run QEMU‘s standard vgabios so VGABIOS-lgpl-latest.bin is needed instead. This can be downloaded from http://www.nongnu.org/vgabios.

You can find some Linux images that work on the amigaone machine at the following link: https://sourceforge.net/projects/amigaone-linux/files/debian-installer/

Booting:

 ./qemu-system-ppc -machine amigaone -bios u-boot-amigaone.bin \
 -cdrom "A1 Linux Net Installer.iso" \
 -device ati-vga,model=rv100,romfile=VGABIOS-lgpl-latest.bin

From the firmware menu that appears select Boot sequence, Amiga Multiboot Options and set Boot device 1 to Onboard VIA IDE CDROM. Then hit escape until the main screen appears, hit escape once more and from the exit menu select either Save settings and exit or Use settings for this session only. It may take a long time loading the kernel into memory but eventually it boots and the installer becomes visible. The ati-vga RV100 emulation is not complete yet so only frame buffer works, DRM and 3D is not available.

aCube Sam460ex

Booting:

 ./qemu-system-ppc -machine sam460ex -rtc base=localtime \
 -drive if=none,id=cd,file=Sam460InstallCD-53.58.iso,format=raw \
 -device ide-cd,drive=cd,bus=ide.1

Xilinx Virtex ML507 reference design

 ./qemu-system-ppc -m virtex-ml507

Debugging tips

Command line options

 -d unimp,guest_errors

(logs unimplemented features and guest errors to stdout)

 -trace 'pmu_*'

(logs all PMU accesses to stdout)

 -trace 'usb*'

(logs all USB accesses to stdout)

Macsbug

Macsbug can be used with Mac OS guest 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

Debugging qemu-system-ppc with GDB on an x86 Linux host

To build gdb-powerpc-linux on Linux, you need the normal build tools such as GCC installed. Download the GDB source code. Version 7.9 is reported to work: http://ftp.gnu.org/gnu/gdb/gdb-7.9.tar.gz Unpack it and cd into the dir, then build and install with:

 ./configure -target=powerpc-linux --enable-sim-powerpc
 make && sudo make install

Launch qemu-system-ppc(64) with -s and -S. Qemu will pause and listen on port 1234 for GDB. Set -prom-env "auto-boot?=false" --nographic on the command line for the Qemu instance to be debugged.

 qemu-system-ppc -s -S -prom-env "auto-boot?=false" --nographic

Open another terminal and launch the GDB you just built:

 gdb-powerpc-linux
 target remote localhost:1234
 continue

You can set a breakpoint in GDB, like this:

 break *0x20dccc

Type "boot" in the terminal running Qemu.

Emulated hardware issues

Mac OS

-Only Mac OS 9.x support sound well. Use an experimental build.
-Mac OS 9.x will not boot with 64 Mb or less memory. They will also not boot with more than 1024 Mb.

Links

Installation images:
Lubuntu 14.04 PPC release
OpenSuse 11 PPC release
Fedora 12 PPC release
Ubuntu Mate 16.04 PPC release
Debian 10 PPC release
Yellow Dog Linux 6.2

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)
PowerPC Assembly Language Tutorial
QEMU PowerPC mailing list
Beige Power Mac G3 info
Sawtooth Power Mac G4 info

Pictures

Project Builder running inside of QEMU Pong 2001 Carbon

Norton Utilities Host and Guest About Dialogs
Mac OS 9 with Graphing Calculator running Doom running in Mac OS 9.2
OpenSUSE

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 3D video card
  • Improve various hardware (via-cuda, ata controller, etc..)


Knowledge in these areas could help:

  • PowerPC Assembly
  • 68K Assembly
  • Embedded Programming

Contacts

Maintainer: David Gibson david@gibson.dropbear.id.au
If there are any issues with this page, please contact me