Xilinx UG129 manual Assembly Errors, Input and Output Files, PicoBlaze Development Tools

R

Chapter 9: PicoBlaze Development Tools

Open a DOS box and navigate to the working directory. To assemble the PicoBlaze program, type:

kcpsm3 <filename>[.psm]

Assembly Errors

The assembler halts as soon as an error is detected. A short message indicates the reason for any error. The assembler also displays the line that it was analyzing when it detected the problem. Fix each reported problem in turn and re-execute the assembler.

Since the execution of the assembler is very fast, it is unlikely that you will be able to ‘see’ it making progress, and the display will appear to be immediate. To review everything that the assembler has written to the screen, the DOS output can be redirected to a text file using:

kcpsm3 <filename>[.psm] > screen_dump.txt

Input and Output Files

The KCPSM3 assembler reads four input files and creates 15 output files as shown in Figure 9-1. The KCPSM3 assembler reads the PicoBlaze source program, <filename>.psm, and three template files that instantiate and initialize a block RAM in various design flows, ROM_form.*.

Block RAM	ROM_form.vhd
initialization
templates for a	ROM_form.v

variety of design

<filename>.psm

KCPSM3.EXE

PicoBlaze source program

pass1.dat	Assembler intermediate
pass2.dat
	processing files (possibly
pass3.dat
	useful for debugging
pass4.dat

flows

ROM_form.coe

assembly errors)

pass5.dat

Assembled PicoBlaze code, formatted to initialize a block RAM for a variety of design flows

Assembled PicoBlaze code, formatted for other utilities

<filename>.vhd

<filename>.v

<filename>.coe <filename>.m

<filename>.hex

<filename>.dec

<filename>.log constants.txt Assembler report files

labels.txt

Formatted version of input

<filename>.fmt source program

UG129_c10_01_052004

Figure 9-1:KCPSM3 Assembler Files

All five assembler passes are recorded in the pass*.dat output files. Should an error occur during assembly, these files may contain additional details on the error.

If the source program is free of errors, the KCPSM3 assembler generates an object code output, formatted for a variety of design flows, based on the initial template files. These output files generate the code ROM, instantiated as a block RAM, and properly initialized with the PicoBlaze object code. The assembler also generates equivalent raw decimal and hexadecimal output files for other utilities.

66	www.xilinx.com	PicoBlaze 8-bit Embedded Microcontroller
		UG129 (v1.1.2) June 24, 2008