Virtual SD Card Guide: Difference between revisions

From Dolphin Emulator Wiki
Jump to navigation Jump to search
(Not fully tested (Hackintosh at the moment . . .))
No edit summary
Line 4: Line 4:


== Creating a Virtual SD Card ==
== Creating a Virtual SD Card ==
It is recommend you create one with size at least 512MB for large homebrew apps, for example, Project M, and no more than 2GB for best compatibility as there are compatibility issues with some homebrew apps trying to run under an SDHC card on the real hardware.
=== Easy Dolphin SDCard Maker – Windows only ===
=== Easy Dolphin SDCard Maker – Windows only ===
If the '''sd.raw''' does not exist or you prefer to start over from scratch with size more than 128MB, you can create '''sd.raw''' using ''[https://sites.google.com/site/anon4453/tools/easy-dolphin-sdcard-maker Easy Dolphin SDCard Maker]''. It is recommend you create one with size at least 512MB for large homebrew apps, for example, Project M, and no more than 2GB for best compatibility as there are compatibility issues with some homebrew apps trying to run under an SDHC card on the real hardware.
A simple user created UI for Windows is available here: ''[https://sites.google.com/site/anon4453/tools/easy-dolphin-sdcard-maker Easy Dolphin SDCard Maker]''


=== Command Line and Executable Files ===
=== Command Line and Executable Files ===
#Go to [http://developer.android.com/sdk/index.html#Other SDK Tools Only] and download one for your system.
Go to [http://developer.android.com/sdk/index.html#Other SDK Tools Only] and download one for your system. Unzip it. The file '''mksdcard''' from <var>\tools\</var> will be used throughout this section.
#Unzip it.
#Drag and drop '''mksdcard''' from <var>\tools\</var> into the Terminal/Command Prompt window then type:
 
<pre>2048M <directory>sd.raw</pre>


*<kbd>2048M</kbd> being 2GB, and if desired, replace it with different size like <kbd>512M</kbd> for 512MB.
Open the Command Prompt or Terminal then follow the supposed command line:
*Replace <directory> with the destination location for sd.raw (I.E. to replace Dolphin's sd.raw under OS X: <var>~/Library/Application\ Support/Dolphin/Wii/sd.raw</var>)
<pre>mksdcard 2048M sd.raw</pre>
*[http://developer.android.com/tools/help/mksdcard.html More command information]
*Drag and drop '''mksdcard''' file from <var>\tools\</var> into the command window for the full directory pointing to mkscard.
*Type <kbd>2048M</kbd> for 2GB, or if desired, replace it with different size like <kbd>512M</kbd> (512MB), <kbd>1024M</kbd> (1GB), etc.
*To replace the virtual SD Card, simply drag and drop an existing '''sd.raw''' file into the command window. (The virtual SD card on OS X will most likely located in <var>~/Library/Application\ Support/Dolphin/Wii/sd.raw</var>)<br />Or elsewhere to create new.


== Editing a Virtual SD Card ==
== Editing a Virtual SD Card ==
=== Windows ===
=== Windows ===
The '''sd.raw''' file can be edited using ''[http://www.winimage.com/download.htm WinImage]''.
The virtual SD card can be edited using ''[http://www.winimage.com/download.htm WinImage]''.


=== OS X ===
=== OS X ===
In the Terminal, type the following to mount the SD card:
In Terminal window, type the following to mount the virtual SD card:
 
<pre>hdiutil attach -imagekey diskimage-class=CRawDiskImage ~/Library/Application\ Support/Dolphin/Wii/sd.raw</pre>
hdiutil attach -imagekey diskimage-class=CRawDiskImage ~/Library/Application\ Support/Dolphin/Wii/sd.raw
The virtual SD card can then be ejected through Finder when done being edited.
 
The SD card can then be ejected through Finder when done being edited.


=== Linux ===
=== Linux ===
The '''sd.raw''' file can be edited by mounting it to a virtual disk:
The virtual SD card can be edited by mounting it to a virtual disk:
 
<pre>mount -o defaults,umask=000 sd.raw /media/sdcard</pre>
<pre>mount -o defaults,umask=000 sd.raw /media/sdcard</pre>
When you are done, simply unmount it like this:
When you are done, simply unmount it like this:
<pre>umount /media/sdcard</pre>
<pre>umount /media/sdcard</pre>



Revision as of 17:34, 26 June 2015

Dolphin can store data to a virtual SD card named sd.raw. It is stored under "%userprofile%\Documents\Dolphin Emulator\Wii" for Windows. By default, it will be created with the size of 128MB.

The virtual SD card is very important for homebrew apps on Dolphin. Project M and Mario Kart Wii custom tracks are the best example of this, as some homebrew apps can only work using files stored on the SD card of the real hardware for which they were designed.

Creating a Virtual SD Card

It is recommend you create one with size at least 512MB for large homebrew apps, for example, Project M, and no more than 2GB for best compatibility as there are compatibility issues with some homebrew apps trying to run under an SDHC card on the real hardware.

Easy Dolphin SDCard Maker – Windows only

A simple user created UI for Windows is available here: Easy Dolphin SDCard Maker

Command Line and Executable Files

Go to SDK Tools Only and download one for your system. Unzip it. The file mksdcard from \tools\ will be used throughout this section.

Open the Command Prompt or Terminal then follow the supposed command line:

mksdcard 2048M sd.raw
  • Drag and drop mksdcard file from \tools\ into the command window for the full directory pointing to mkscard.
  • Type 2048M for 2GB, or if desired, replace it with different size like 512M (512MB), 1024M (1GB), etc.
  • To replace the virtual SD Card, simply drag and drop an existing sd.raw file into the command window. (The virtual SD card on OS X will most likely located in ~/Library/Application\ Support/Dolphin/Wii/sd.raw)
    Or elsewhere to create new.

Editing a Virtual SD Card

Windows

The virtual SD card can be edited using WinImage.

OS X

In Terminal window, type the following to mount the virtual SD card:

hdiutil attach -imagekey diskimage-class=CRawDiskImage ~/Library/Application\ Support/Dolphin/Wii/sd.raw

The virtual SD card can then be ejected through Finder when done being edited.

Linux

The virtual SD card can be edited by mounting it to a virtual disk:

mount -o defaults,umask=000 sd.raw /media/sdcard

When you are done, simply unmount it like this:

umount /media/sdcard

Dolphin Setting

Go to Options > Configure... > Wii > and enable Insert SD Card.

Usage with Homebrew App

The external files used for the homebrew app must be stored within sd.raw and the homebrew app itself (boot.elf or boot.dol) must exist outside of it for Dolphin to load. Project M, for example, will load from SD root \projectm\ and Dolphin will need to launch Project M through \homebrew\apps\projectm\boot.elf, NOT in the virtual SD card. It is very ideal to have same copies paralleled between inside and outside of the virtual SD card, so you will have nothing to lose.

The homebrew app that was programmed to hack the Wii game will not work if you haven't set a particular Wii game as the default ISO! Within the Dolphin game list, open context menu (right-click) on any Wii game and click Set as default ISO. Do this before loading a homebrew app with Dolphin.