II.3 The DEMO Program

For getting started with a new assembler, it is always helpful to have a program that can be assembled with it. For this purpose, the 8051 assembler program DEMO.A51 is provided, which can be used for a first test of the ASEM-51 installation. For this, you should either have installed ASEM-51 as described above, or keep all files of the ASEM-51 package directly in your working directory!

Under MS-DOS or in a Windows DOS-Box simply type 

ASEM DEMO
HEXBIN DEMO
at the DOS prompt. ASEM and HEXBIN should finish without errors and you should have the following new files on your disk: 
DEMO.HEX          Intel-HEX file
DEMO.LST          assembler list file of DEMO.A51
DEMO.BIN          binary image file of DEMO.HEX

Under Linux type 

asem demo.a51
hexbin demo.hex
Again asem and hexbin should finish without errors and you should have the following new files on your disk: 
demo.hex          Intel-HEX file
demo.lst          assembler list file of demo.a51
demo.bin          binary image file of demo.hex

If something goes wrong, either ASEM-51 is not properly installed, there may be files missing in your distribution, or the assembler simply cannot find the include file 8052.mcu!
demo.a51 may also serve as a sample assembler program that includes examples for (nearly) all machine instructions, pseudo instructions, assembler controls, and meta instructions that have been implemented in ASEM-51. Whenever in doubt how to use a particular command, demo.a51 may be a valuable help.
Unlike other assemblers, the ASEM-51 list file is no alibi feature! It is really instructive to compare the original source to the generated code in the listing.