CUSTOMIZ(1)

NAME
customiz - customize BOOT-51 for an 8051 target system

SYNOPSIS
customiz baud [timer [prec [clock [start [user]]]]]

DESCRIPTION
customiz is a customization utility for the 8051 bootstrap program BOOT-51. Its source is distributed in file boot51.a51, which must be customized for the target board, before it is ready for assembly. This is performed with an include file boot51.inc, containing the required configuration data. boot51.inc can be generated with the utility program customiz.

OPTIONS
There are two major groups of configuration parameters:

- baudrate generation
- memory addresses

The parameters baud, timer, prec, and clock specify everything that is required for baudrate generation, while start, and user define important memory addresses.

baud is the desired nominal baudrate (in Baud), BOOT-51 should use for communication with the host system.

timer is the on-chip timer or baudrate generator that is used for baudrate generation. Legal values are:

    T1 = timer 1 (default)
    available on nearly all 8051 derivatives

    T2 = timer 2
    available on 8052/32 and all true compatibles

    BG = internal baudrate generator
    available on 80C515/35 and 80C517/37

    BA = internal baudrate generator
    available on 80C515A and 80C517A

    D1 = timer 1
    with clock/12 or clock/4 prescaler on 80C320

prec is the required relative precision of the baudrate in percent. The default precision is 1.0 %.

clock is the system clock frequency in MHz.
(11.0592 MHz default)

start is the start address of BOOT-51 on the target system in hex representation. (default is 0000H)

user is the usual hex start address of the application programs in the external memory. (default is 8000H)

FILES
When customiz is terminating successfully, it creates an include file boot51.inc in the working directory. This file is included by boot51.a51!

EXIT STATUS
When terminating, customiz returns an exit code to the calling process:

    0 no errors
    1 parameter or baudrate errors
    2 fatal runtime error

USAGE
For detailed information on BOOT-51 customization see the BOOT-51 User's Manual in ASCII file boot51.doc, or start reading with HTML file docs.htm!

AUTHOR
W.W. Heinz

SEE ALSO
asem(1), hexbin(1), reset51(1), boot(1)