1,489
edits
Difference between revisions of "HOWTO-Debug-Endian-Issues"
Jump to navigation
Jump to search
HOWTO-Debug-Endian-Issues (view source)
Revision as of 12:26, 28 December 2014
, 12:26, 28 December 2014Use es1370 for the soundhw parameter, and add the two different options
(Update third draft of HOWTO on Debugging Endian Issues.) |
(Use es1370 for the soundhw parameter, and add the two different options) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 32: | Line 32: | ||
START qemu-system-ppcw.exe ^ | START qemu-system-ppcw.exe ^ | ||
-name debianPPC ^ | -name debianPPC ^ | ||
-L Bios -vga std -soundhw | -L Bios -vga std -soundhw es1370 ^ | ||
-m 512M ^ | -m 512M ^ | ||
-boot menu=on,splash=./bootsplash.bmp,splash-time=3000 ^ | -boot menu=on,splash=./bootsplash.bmp,splash-time=3000 ^ | ||
| Line 42: | Line 42: | ||
pause | pause | ||
<br> | |||
Note that for the '''soundhw''' parameter, some valid options are es1370 and ac97. Choose the one that works for you. | |||
<br> | |||
* Install a PPC Linux distribution onto the QEMU PPC VM. | * Install a PPC Linux distribution onto the QEMU PPC VM. | ||
** [http://people.debian.org/~aurel32/qemu/powerpc/ | ** The full method here is to create a blank QCOW2 disk image file with the qemu-tools and then use this as the main emulated hard disk via the "-hda" option, then add a Linux PPC CDROM ISO image using the "-cdrom" option, start QEMU and do the distribution installation procedure as normal. | ||
** However, '''Debian Linux Squeeze for PPC''' is suggested as prebuilt disk images are available [http://people.debian.org/~aurel32/qemu/powerpc/ here]. Squeeze is preferred over Wheezy for this. | |||
* Enable VM network access proxied via the host system. | * Enable VM network access proxied via the host system. | ||
** QEMU should be providing a virtual ethernet network adapter to the VM, which will provide access to the internet via the host's | ** By default, QEMU should be providing a virtual ethernet network adapter to the VM, which will provide access to the internet via the host's connection. This can be checked by the normal methods such as ICMP ping within the VM OS. If this is not working, check on your host machine, then refer to the QEMU documentation for any missing configuration setting and to see if the hosted OS requires any device driver to allow this virtual device to work. | ||
* Install any OS updates to the VM. | |||
** Especially when using the prebuilt images, OS system updates should be done via the normal method to ensure up to date system libraries are installed. | |||
*** Debian: <pre>apt-get update</pre> | |||
* Install the ScummVM source code, required libraries and compile a debug build. | * Install the ScummVM source code, required libraries and compile a debug build. | ||
* Within the VM, this now be done as per a normal Linux | * Within the VM, this can now be done as per a normal Linux build. For further information, check our [[Compiling ScummVM/GCC|GCC compilation instructions]] page | ||
** Getting ScummVM source tree: <pre>git clone git://github.com/scummvm/scummvm.git</pre> | ** Getting ScummVM source tree: <pre>git clone git://github.com/scummvm/scummvm.git</pre> | ||
*** Refer to [[Developer_Central#Getting_started here]] for more help. | *** Refer to [[Developer_Central#Getting_started |here]] for more help. | ||
** Install any required libraries: <pre>apt-get install libsdl12dev</pre> | ** Install any required libraries: <pre>apt-get install libsdl12dev</pre> | ||
** Compiling ScummVM: <pre>cd scummvm && ./configure && make clean && make</pre> | ** Compiling ScummVM: <pre>cd scummvm && ./configure && make clean && make</pre> | ||
*** Refer to [[Compiling_ScummVM/GCC here]] for more help. | *** Refer to [[Compiling_ScummVM/GCC |here]] for more help. | ||
* Provide game data. | * Provide game data to the VM. | ||
** Though QEMU can provide access to host directories as emulated FAT formatted drives by this option: <pre> -drive file=fat:ro:some-directory</pre>, this only supports FAT-16 and is thus limited to 2GB maximum. It is suggested to use the <pre> -cdrom </pre> option with a ISO image instead. CD swapping is not possible, but it is fairly easy to create a ISO image from a set of files in the same way as prior to writing a CD. | |||
** Transferring data to the host VM by normal network file transfer is also possible i.e. SSH from the VM to host or another machine, HTTP download, etc. | |||
* Install debugging tools. | * Install debugging tools. | ||
** <pre>apt-get install gdb</pre> | |||
** <pre>apt-get install valgrind</pre> | |||
*** Note: Valgrind is currently broken on Debian Squeeze PPC. If you want to install this, you will need to add the apt repositories for "Wheezy" and install the updated version from there. | |||
* Debugging can then be done as per a normal native Linux machine, though patience may be required as the VM will be much slower than a native machine. | |||
A preinstalled standard desktop Debian Squeeze PPC QEMU hard disk image in qcow2 format can be provided by the ScummVM development team, but since this is over 5GB, this is currently only provided on request, rather than on the download site. | |||
== Debugging for Other Architectures == | |||
The instructions above should be valid for emulation and debugging of other uncommon machine architectures e.g. MIPS, provided that QEMU supports that architecture e.g. use qemu-system-mips, rather than ppc, and a Linux distribution or other Unix is available for that architecture as a installation CD ISO image. | |||
However, there are a few architectures which QEMU does not support, notably [https://en.wikipedia.org/wiki/SuperH SH]. However, there is another general purpose CPU/machine emulator called [http://gxemul.sourceforge.net/ GXemul] which does support this and some other more esoteric platforms. This is less supported than QEMU, but this procedure should be possible with some modifications. Any notes on this would be gratefully received by the team. | |||