EXTERNAL INTEGRATION: CALL EXTERNAL MACHINE LANGUAGE FILE (ABSOLUTE POSITION)

This small example explains how to invoke external machine language, loaded from a binary file and included on the system into a specific location. The external machine routine will receive parameters from a specific register and store the result on the same register.

source compile sandbox issues? back to examples

SOURCE CODE ()

	CLS

	executable = LOAD("executable_increment.bin", 49152)
	address = VARPTR(executable)
	PRINT "External LM routine at $"; HEX(address)
	x = 0
	DO
		PRINT "x = "; x
		WAIT KEY
		SYS address WITH REG(B)=x RETURN x=REG(B) ON CPUZ80
		SYS address WITH REG(A)=x RETURN x=REG(A) ON CPU6809
		SYS address WITH REG(X)=x RETURN x=REG(X) ON CPU6502
		PRINT " *increment*"
	LOOP

How to compile and run the example

The instructions here refer to compiling the example from the command line. For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile each single example with just one click.



Are instructions for your specific home computer / console missing? First of all, check if your computer is supported by clicking here. If so, since ugBASIC is a language which does not provide abstractions, it is possible that this example will not work on your target. If you think this is an issue, please click here.

Amstrad CPC 464, Amstrad CPC 6128, Amstrad CPC 664

In order to compile the example, type this command on the command line:

Linux

ugbc.cpc -O dsk -o extern_example_07.dsk extern_example_07.bas

Windows

ugbc.cpc.exe -O dsk -o extern_example_07.dsk extern_example_07.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Atari 1200XL, Atari 130XE, Atari 600XL, Atari 65XE, Atari 800XE, Atari 800XL, Atari XEGS

In order to compile the example, type this command on the command line:

Linux

ugbc.atarixl -O xex -o extern_example_07.xex extern_example_07.bas

Windows

ugbc.atarixl.exe -O xex -o extern_example_07.xex extern_example_07.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Atari 400, Atari 800

In order to compile the example, type this command on the command line:

Linux

ugbc.atari -O xex -o extern_example_07.xex extern_example_07.bas

Windows

ugbc.atari.exe -O xex -o extern_example_07.xex extern_example_07.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Commodore 128 (CPU 8502)

In order to compile the example, type this command on the command line:

Linux

ugbc.c128 -O prg -o extern_example_07.prg extern_example_07.bas

Windows

ugbc.c128.exe -O prg -o extern_example_07.prg extern_example_07.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Commodore 64, Commodore Executive 64

In order to compile the example, type this command on the command line:

Linux

ugbc.c64 -O prg -o extern_example_07.prg extern_example_07.bas

Windows

ugbc.c64.exe -O prg -o extern_example_07.prg extern_example_07.bas

For Microsoft Windows users we suggest using UGBASIC-IDE, which allows you to download and compile this example with just one click.

Any problem?

If you have found a problem trying to run this example, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO EXAMPLES