makemaster

Description

The makemaster tool creates Revolution master data (rvm) for the RVT-R Reader from a disc layout file (dlf).

System Requirements

To run makemaster, you need to install version 2006/08/21 or later of the NDEV software. You also must install the Cygwin OpenSSL package.

Note: OpenSSL 0.9.8b-1, which is the version of OpenSSL for which operation has been confirmed, is not currently distributed as a Cygwin package. Download OpenSSL 0.9.8b-1 from WarioWorld, the Nintendo support site.

Preparation

Before creating master data with makemaster, you must confirm the program operating environment and the .ddf file description.

After doing this, execute the ndrun NDEV software. Doing so creates .dlf, .dsf, and .rcf files that reflect the above information.

Note: In order to create master data, you need the .dlf, .dsf, and .rcf files and the data used by the application (stored in the DvdRoot directory). Inconsistencies in these files could arise if you create the master data on some computer other than the one that was used for development.

Using the Library

There are four versions of the makemaster command: makemaster,makemasterX,makemasterNF, and makemasterNFX. They all take the same arguments.

Creating a Master Image

% makemaster[NF][X] dlf rvm [-p password]

When makemaster executes, it calls ndstop internally. Note that this ends any programs that are running. Use makemasterX when creating master data in an environment in which the NDEV is not connected. This version is functionally the same as makemaster, but has been revised so that it does not call ndstop.

If you have specified password, a password-protected .rvm file will be created. Writing to a password-protected rvm file requires entry of the password specified in makemaster.

When makemaster[X] is used to create an .rvm file from a .dlf file that was generated with SDK version 3.1 or later, all firmware that has been officially released up to that point will be added to the .rvm file for use as update data. The firmware will be installed automatically when this .rvm file is run on the development hardware.

Note: Use makemasterNF[X] if you do not want to include the update firmware. The existence or absence of update firmware will not affect the operation of your application.

Deleting Temporary Files

% makemaster[NF][X] dlf clean

Temporary files will remain behind if makemaster[NF][X] is aborted in mid-operation, but these files can be deleted by using the clean option.

Caution

Note: The firmware includes encryption features. Master data that has firmware embedded as update data is therefore a service that falls under row 8 (i) (ii) of the appended table of the Foreign Exchange Order. However, because the conditions in the Ministerial Ordinance on Invisible Transactions, Article 9, paragraph 1, item 10(b) are satisfied, an Application for Permission for Service Transactions is not necessary. Import, export, and use in countries outside of Japan must comply with the laws and regulations of those countries. If there are any problems, use master data created without firmware, using makemasterNF[X].

Location

$REVOLUTION_SDK_ROOT/X86/bin/makemaster
$REVOLUTION_SDK_ROOT/X86/bin/makemasterNF
$REVOLUTION_SDK_ROOT/X86/bin/makemasterX
$REVOLUTION_SDK_ROOT/X86/bin/makemasterNFX

Revision History

2008/06/11 Integrated into Revolution SDK.
2007/09/07 Fixed a bug with makemasterX that prevented update data from being included on the disc.
2007/09/03 Updated the document structure.
2007/08/07 Added an explanation in Cautions about the firmware encryption features.
2007/07/20 Changed makemaster so that firmware used by an application is now included in the disc as update data. Added makemasterNF and makemasterNFX.
2007/06/25 Changed the specifications for makedevpart. The dev.dlf file is now output to the current directory. Deleted makeRVTR. Added support for dual-layer discs.
2007/06/15 Added makedevpart.
2007/01/15 makemaster now checks the simulated memory size of MEM2. Added support for password-protected master data. Added makemasterX.
2006/10/30 Added support for Revolution SDK version 2.3 and later versions.
2006/09/21 Added support for Revolution SDK version 2.2 patch.
2006/09/08 Added support for Revolution SDK version 2.2. Not backward-compatible. Corrected the value of FSTUserEnd that should be be specified by the ddf file. (The program will not run if this value is wrong.))
2006/08/30 Added support for Revolution SDK version 2.1 patch.
2006/08/17 Added support for Revolution SDK version 2.1.
2006/08/14 Released.


CONFIDENTIAL