User:NeoAmsterdam/Customize Mini vMac's disk image: Difference between revisions

From OLPC
Jump to navigation Jump to search
mNo edit summary
(Clarified the exact sequence to cook up a disk image for the Mini vMac activity.)
Line 14: Line 14:
* gzip
* gzip
= Instructions =
= Instructions =
# Create a new disk image in Disk Utility<br />Make sure to use a read/write disk image that is large enough to contain all your software.
* '''Note:''' The disk image creation instructions are for Mac OS X. A [[File:Blank_vMac.DSK.gz|blank 40MB disk image]] is available for download to help non-OS X users get started.
# Create a new blank disk image that is large enough to contain all your software and that contains no partition layout information.<br />Check your existing Mini vMac's disk usage for a good idea how much space you'll need.<br /><tt>hdiutil create -size 40m -fs HFS -layout NONE 40MB.dmg</tt>
# Convert the disk image<br />Mini vMac expects disk images to be NDIF read/write format.
# Convert the disk image into an NDIF ("Classic" DiskCopy) read/write format.<br /><tt>hdiutil convert -format RdWr -o 40MB.img 40MB.dmg</tt>
# Install whatever you like to the disk image<br />I recommend System 6.0.8 or System 7.0.1; System 7.5.3 is possible but overkill.
# Now inside Mini vMac, install whatever you like to the disk image<br />I recommend System 6.0.8 or System 7.0.1; System 7.5.3 is possible but overkill.
# Compress and rename the disk image<br /><b><tt>gzip vMac.img && mv vMac.img.gz vMac.DSK.gz</tt></b>
# Copy the disk image to <tt>MiniVMac.activity/vMac.DSK.gz</tt>
# Once you're finished with Mini vMac, compress and rename the disk image<br /><tt>gzip 40MB.img && mv 40MB.img vMac.DSK.gz</tt>
# Copy the disk image to your XO. You'll find the default disk image located at <tt>MiniVMac.activity/vMac.DSK.gz</tt>

= See Also =
= See Also =
* [http://minivmac.sourceforge.net/faq.html#ROM About ROM Images]
* [http://minivmac.sourceforge.net/faq.html#ROM About ROM Images]

Revision as of 10:06, 1 July 2010

Warning

  • I will not provide Mac Plus ROM images.
    If you do not know why this is an issue, then don't run Mini vMac.

Note

  • You must provide Mini vMac a Mac Plus ROM image.
  • The Mini vMac activity has been crippled (relative to the "standard" version). As a result, it can access only one disk image.
  • Mini vMac has no "breakout" support - any file created under emulation will be inaccessible from the XO (and vice-versa).
  • This document assumes you are running Mini vMac on Mac OS X and have enabled Disk Utility's "hidden" features.

Requirements

  • A Mac Plus ROM image
  • Mini vMac
  • Disk Utility
  • gzip

Instructions

  • Note: The disk image creation instructions are for Mac OS X. A File:Blank vMac.DSK.gz is available for download to help non-OS X users get started.
  1. Create a new blank disk image that is large enough to contain all your software and that contains no partition layout information.
    Check your existing Mini vMac's disk usage for a good idea how much space you'll need.
    hdiutil create -size 40m -fs HFS -layout NONE 40MB.dmg
  2. Convert the disk image into an NDIF ("Classic" DiskCopy) read/write format.
    hdiutil convert -format RdWr -o 40MB.img 40MB.dmg
  3. Now inside Mini vMac, install whatever you like to the disk image
    I recommend System 6.0.8 or System 7.0.1; System 7.5.3 is possible but overkill.
  4. Once you're finished with Mini vMac, compress and rename the disk image
    gzip 40MB.img && mv 40MB.img vMac.DSK.gz
  5. Copy the disk image to your XO. You'll find the default disk image located at MiniVMac.activity/vMac.DSK.gz

See Also