Specifications

AMD Geode™ GeodeROM Functional Specification 243

Configuring/Customizing 32087C

18.0Configuring/Customizing

18.1 Quick Start

1) Make sure you have ml.exe (masm), link.exe, and nmake in your path.

2) Change directory (cd) to examples\newproj (this is a user dir).

3) Type “nmake all”.

4) Answer the questions.

18.2 Build Process

The build process starts in the user directory by running nmake. The first time nmake runs, the configurator asks a series of

questions about the platform. nmake, then attempts to complete the build according to the answers. When the build suc-

cessfully completes, the following is displayed:

###############################################################################

#__________________________GeodeROM build complete___________________________#

###############################################################################

18.3 Environment Variable(s)

• Path - Should include the bin and binr directories from masm 6.11 and msvc 1.52, as well as the normal files for DOS /

Windows

• Include - Should include the directories for masm 6.11 and msvc.

• Lib - Should include the lib directories from masm6.11 and msvc.

18.4 The Configurator

The configurator is a perl script used to configure the GeodeROM build. The build process includes a series of questions to

which the system designer provides information about board wiring, installation options, and general configuration for

GeodeROM. The configurator utility runs automatically the first time the build process takes place, and on subsequent

builds, uses information from a saved option file:

• Debug/Test - Debug questions are accessed by running nmake debug (otherwise, they are not asked). These include

cache defaulting to OFF instead of ON, halting on unknown interrupts, conservative memory timings, etc.

• VSA2 - XpressAUDIO™ and XpressGRAPHICS™ subsystems.

• Hardware - Chipset, SIO, and LCD.

• Boot screen - Splash screen support and summary screen support.

• General configuration - Hard drive support, floppy support, video memory used, user option ROMs, etc.

The configurator outputs the file’s xromcfg.opt, rules.mak, and options.inc into the user directory. It also decodes and recre-

ates an xromcfg.opt file from an xpress.rom file. This is useful both for recreating old ROM files and for debugging problems

with the ROMs.