EXTERNAL INTEGRATION: CALL EXTERNAL MACHINE LANGUAGE FILE

This small example explains how to invoke external machine language, loaded from a binary file and included on the system. The external machine routine will increment the given value, it 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")
	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_04.dsk extern_example_04.bas

Windows

ugbc.cpc.exe -O dsk -o extern_example_04.dsk extern_example_04.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_04.xex extern_example_04.bas

Windows

ugbc.atarixl.exe -O xex -o extern_example_04.xex extern_example_04.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_04.xex extern_example_04.bas

Windows

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

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

Coleco Vision, Dina (Chuang Zao Zhe 50), SpectraVideo SV-603 VGA

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

Linux

ugbc.coleco -O rom -o extern_example_04.rom extern_example_04.bas

Windows

ugbc.coleco.exe -O rom -o extern_example_04.rom extern_example_04.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_04.prg extern_example_04.bas

Windows

ugbc.c128.exe -O prg -o extern_example_04.prg extern_example_04.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_04.prg extern_example_04.bas

Windows

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

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

Dragon 32

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

Linux

ugbc.d32 -O bin -o extern_example_04.bin extern_example_04.bas

Windows

ugbc.d32.exe -O bin -o extern_example_04.bin extern_example_04.bas

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

Dragon 64

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

Linux

ugbc.d64 -O bin -o extern_example_04.bin extern_example_04.bas

Windows

ugbc.d64.exe -O bin -o extern_example_04.bin extern_example_04.bas

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

SEGA SC-3000

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

Linux

ugbc.sc3000 -O rom -o extern_example_04.rom extern_example_04.bas

Windows

ugbc.sc3000.exe -O rom -o extern_example_04.rom extern_example_04.bas

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

SEGA SG-1000

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

Linux

ugbc.sg1000 -O rom -o extern_example_04.rom extern_example_04.bas

Windows

ugbc.sg1000.exe -O rom -o extern_example_04.rom extern_example_04.bas

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

TRS-80 Color Computer, TRS-80 Color Computer 2

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

Linux

ugbc.coco -O bin -o extern_example_04.bin extern_example_04.bas

Windows

ugbc.coco.exe -O bin -o extern_example_04.bin extern_example_04.bas

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

TRS-80 Color Computer 3

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

Linux

ugbc.coco3 -O bin -o extern_example_04.bin extern_example_04.bas

Windows

ugbc.coco3.exe -O bin -o extern_example_04.bin extern_example_04.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