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

From OLPC
Jump to navigation Jump to search
(Forked off from user page; addressed ROM copyright)
 
(Snippet transclusion.)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
<div style="float: right;">__TOC__</div>
= Warning =
* <span style="color: red;"><b>I will not provide Mac Plus ROM images.</b><br />If you do not know why this is an issue, then don't run Mini vMac.</span>

= Note =
= Note =
* The [[Mini vMac]] activity has been crippled (relative to the "standard" version):
* You must provide [http://minivmac.sourceforge.net/ 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.
** It can access only one disk image.
** Its use of a compressed disk image slows down performance significantly.
* Mini vMac has no "breakout" support - any file created under emulation will be inaccessible from the XO (and vice-versa).
* 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 =
= Requirements =
{{User:NeoAmsterdam/Snippets/ROMs}}
* A Mac Plus ROM image
* A Mac Plus ROM image
* Mini vMac
* Mini vMac
* Disk Utility
* Disk Utility
* gzip
* gzip

= Instructions =
= Instructions =
* '''Note:''' The disk image creation instructions are for Mac OS X. [[File:Blank_vMac.DSK.gz]] is available for download to help non-OS X users get started.
# 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.
# 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/doc/download.html Mini vMac Downloads Page]
* [http://minivmac.sourceforge.net/doc/build.html Build Instructions for Mini vMac]
* [http://www.info.apple.com/support/oldersoftwarelist.html#system Apple System Software Page]
* [http://www.info.apple.com/support/oldersoftwarelist.html#system Apple System Software Page]

Latest revision as of 20:37, 15 February 2011

Note

  • The Mini vMac activity has been crippled (relative to the "standard" version):
    • It can access only one disk image.
    • Its use of a compressed disk image slows down performance significantly.
  • Mini vMac has no "breakout" support - any file created under emulation will be inaccessible from the XO (and vice-versa).

Requirements

This process, application, or procedure involves a ROM image.
ROMs are subject to copyright. If you do not own the ROM, then you are not entitled to the ROM image. Do not contact me about ROMs.
  • A Mac Plus ROM image
  • Mini vMac
  • Disk Utility
  • gzip

Instructions

  • Note: The disk image creation instructions are for Mac OS X. 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