Chapter 2. Configuring Gdl

Table of Contents
Checkable Options
min-eeprom
serial port

Before downloading a program, it is necessary to configure gdl to match the characteristics of the workstation and HC11 board. This configuration is performed through command line options or with the File->Preferences popup. Information on command-line options is available by typing

% gdl --help

at the command line.

Checkable Options

There are four checkable options available on the Preferences popup: bulk-erase, bootstrap-feedback, hardware-echo, and debug. All except debug are ``remembered'' across gdl runs.

bulk-erase

Ordinarily, gdl will erase only those memory cells in a program already residing on the HC11 that need to be changed in a new program. If a relatively small part of a program needs to be changed, this will be the fastest way to download a program.

If a large part of an existing program needs to be erased to download a new program, it will be faster to erase the existing program using a bulk erase command supported by the HC11. This option enables bulk erasing of the HC11 EEPROM.

The bulk-erase option will not affect whether a program will download successfully, but will affect download speed.

bootstrap-feedback

Some HC11 boards will echo all characters sent to the board while in the initial bootstrap download stage. This option configures gdl to expect this echo.

Gdl must be configured to match the HC11 board being used to download successfully.

NMSU Local Note: The Miniboard used at NMSU requires this option NOT be set.

hardware-echo

Some HC11 boards will echo all characters sent to the board when not in the initial bootstrap stage. This option configures gdl to expect this echo.

Gdl must be configured to match the HC11 board being used to download successfully.

NMSU Local Note: The Miniboard used at NMSU requires this option be set.

debug

This option isn't likely to be useful to most users. Invoking it causes gdl to print copious debugging output to the standard error output.

The debug option does not affect whether a program will download successfully.