Skip to content
puregorill edited this page May 27, 2023 · 67 revisions

Welcome to the MACRO HLA BASIC wiki

Let's start with the usual "hello world" code. I will explain the whole process using C64Studio, because that is what I use. I will provide a step-by-step guide.

If you are an experienced user of the C64Studio in combination with the VICE emulator, then use the quick guide. Otherwise, choose the more detailed step-by-step guide.
However, even for experienced users it is worth taking a look at the detailed instructions. Some C64Studio settings may still be unfamiliar.

MACRO HLA BASIC

What is it?

MACRO HLA BASIC is a macro collection for the Commodore 64 (NMOS 6502/6510). More concretely it contains a so-called "Solution" for the C64Studio, which has an ACME Cross Assembler-like syntax. The macros can of course also be used without the C64Studio (with the Cross Assembler ACME, whose syntax the files just have).

The special feature of this macro collection is that it contains structure macros such as IF-ELSE-ENDIF or REPEAT-UNTIL.

HLA means high level assembly. You can mix the HLA BASIC macros with mnemonics.
But it is also possible - within limits - to program only with the HLA BASIC macros like in BASIC. It is a bit more inefficient, but of course much much faster than C64 BASIC.
However, this comes with the disadvantage that the code is much longer (and somewhat more cumbersome, because it is not a real high level BASIC) than C64 BASIC.

The whole project and also parts of the code are heavily influenced and inspired by the following project:
http://wilsonminesco.com/StructureMacros/

For more information please read the github wiki:

https://github.com/puregorill/MACRO-HLA-BASIC/wiki

Important Links:

C64Studio:
https://github.com/GeorgRottensteiner/C64Studio (german speaking author, actual software is in english)
https://www.georg-rottensteiner.de/de/c64.html (german site)

ACME:
https://sourceforge.net/projects/acme-crossass/
https://www.c64-wiki.de/wiki/ACME (german site but the english translation with google is good enough)