GCBASIC documentation
Compiler Directives

Syntax:

    #asmraw [label]
    #asmraw [Mnemonics | Directives | Macros] [Operands] ['comments]

for ASM blocks use

    #asmraw[
        [label]
        [Mnemonics | Directives | Macros] [Operands] ['comments]
    #asmraw]

Explanation:

The #asmraw directive is used to specify the assembly that GCBASIC will use.

Anything following this directive will be inserted into the ASM source file with no changes other than trimming spaces - no replacement of constants.

Assembly is a programming language you may use to develop the source code for your application. The directive must conform to the following basic guidelines. Each line of the source file may contain up to four types of information:

The order and position of these are important. For ease of debugging, it is recommended that labels start in column one, and mnemonics start in column two or beyond. Operands follow the mnemonic.

Comments may follow the operands, mnemonics, or labels, and can start in any column. The maximum column width is 255 characters.

White space or a colon must separate the label and the mnemonic, and white space must separate the mnemonic and the operand(s). Multiple operands must be separated by commas.

White space is one or more spaces or tabs. White space is used to separate pieces of a source line. White space should be used to make your code easier for people to read.

Example 1

        #asmraw lds SysValueCopy,TCCR0B
        #asmraw andi SysValueCopy, 0xf8
        #asmraw inc SysValueCopy
        #asmraw sts TCCR0B, SysValueCopy          ' <<< a raw assembly instruction inserted unchanged into the ASM output

Key line: #asmraw sts TCCR0B, SysValueCopy — this exact text, with only leading/trailing whitespace trimmed, is written into the generated ASM file; GCBASIC performs no constant substitution or syntax checking on it.

Example 2

        #asmraw[
            lds SysValueCopy,TCCR0B
            andi SysValueCopy, 0xf8
            inc SysValueCopy
            sts TCCR0B, SysValueCopy
        #asmraw]

This example will generate the following in the ASM source file.

        lds SysValueCopy,TCCR0B
        andi  SysValueCopy, 0xf8
        inc SysValueCopy
        sts TCCR0B, SysValueCopy

See Also: