Voorwoord

Deze handleiding is voor (ervaren) programmeurs, die reeds ervaring hebben met Assembly achtige talen.
Komen woorden als 'stack', 'indentifiers' en 'operatoren' je niet bekend voor, dan is er altijd nog Visual Basic :)

Inhoud

• Datatypen
• Instructies
• Interrupts
• Opbouw van code
• Commentaar
• Variabelen en data
• Definiëren van data
• Defenities
• Array's
• Strings
• Procedures
• Programma structuur
• Werken met instructies
• Pointers en adressen
• Het programma 'Hello World'
• Assembleren en uitvoeren

Datatypen

Instructies

Interrupts

Opbouw van code

Commentaar

Commentaar wordt binnen de code aangegeven door een ; (puntkomma) neer te zetten.

; Dit is commentaar

Variabelen en data

Variabelen wordt binnen de code gedefinieerd door de volgende syntax: Typenaam  indentifiernaam  waarde.
Belangrijk is om te weten dat de typenaam altijd met kleine letters wordt geschreven.

int	getal	125

Tijdens de declaratie moet er een beginwaarde gedefinieerd worden! Uiteraard kunnen er meerdere datadefenities onder elkaar gezet worden.

int	getal	125
short	getal2	45
bool	groter	false

Voor de naam geldt dat deze niet mag beginnen met een cijfer. Mocht je dit wel doen zal de assembler geen foutmelding geven, maar is de variabele niet meer benaderbaar!

Definiëren van data

Het definieren kan op verschillende manieren. Er is ondersteuning voor het decimale, hexadeciale, binaire en ascii waarden.

int	getal	125		; Decimaal 125
int	getal2	0x7D		; Hexadecimaal 125
int	getal3	0b01111101	; Binair 125
int	getal4	'}'		; Asciicode 125

Defenities

Defenities worden gemaakt op de volgende manier:

define PI	3.14159265
define PHI	1.61803398

Defenities kunnen enkel als argument voor de diverse instructies gebruikt worden.

Array's

Het is ook mogelijk om array's te creëren door de array indentifiers te gebruiken: [] achter de indentifiernaam.

int	getallen[]	125, 456, 721, 100
double	metingen[]	25.88, 26.76, 24.55

De komma's geven aan dat er een nieuw getal volgt, let er wel op dat deze direct achter de waarde staan (dus niet eerst een spatie o.i.d)! Indexen van array's beginnen bij 0.

Strings

Een array van karakters kan op twee manieren gedefinieerd worden.

char	tekst[]	'W', 'e', 'l', 'k', 'o', 'm'

Maar de onderstaande manier is makkelijker.

char	tekst[]	"Welkom"

Let op: Bij dit soort strings wordt er automatisch een 0 achter de tekst geplakt. Dit maakt het makkelijker om de tekst af te drukken. De volgende opties zijn ook mogelijk.

char	manier1[]	"Welkom allemaal,",
			" Deze losse strings worden",
			" netjes aan elkaar geplakt"

char	manier2[]	"Via deze manier is het mogelijk
om direct enters binnen de string te verwerken.
Handig toch?"

Als laatste mogelijkheid kan er ook gebruik worden gemaakt van speciale karakters binnen een string, bijvoorbeeld: een tab (\t), receiptfeed (\r), newline (\n) en de 0 (\0). Deze kunnen via de specialcharacter indentifier \ gedefinieerd worden.

char	tekst[]	"Welkom,\r\nDit is een nieuwe regel."

Procedures

Het is mogelijk om verschillende procedures binnen de code te verwerken. Deze kunnen gedefinieerd worden door een indentifiernaam op te geven, direct gevolgt door een : (dubbelepunt).

int	getal1	100
int	getal2	54

procedure1:
	; Hier komt de code

Een pre is dat er altijd een main: procedure in de code aanwezig is! Dit is namelijk de startplek van je applicatie! Het is aan te raden deze altijd onderin de code te plaatsen.

int	getal1	100
int	getal2	54

procedure1:
	; Hier komt de code voor procedure 1

procedure2:
	; Hier komt de code voor procedure 2

main:
	; Hier start de applicatie!

Mocht er geen main procedure aanwezig zijn zal de assembler een foutmelding geven.

Programma structuur

Tijdens het assembleren van de code, worden zowel data als code indentifiers verzameld. Mocht er ergens in de code een referentie staan naar een stuk data of code dat er boven nog niet is gedefinieerd, zal er een foutmelding worden gegeven dat de indentifier niet is gevonden.

int	getal1	100

procedure1:
	; Hier komt de code voor procedure 1

int	getal2	54

main:
	; Hier start de applicatie!
	; Vanuit hier kunnen getal3 en procedure2 niet benaderd worden!

int	getal3	17

procedure2:
	; Hier komt de code voor procedure 2
	; Maar dat heeft hier weinig zin.

Werken met instructies

De diverse instructies kunnen verwerkt worden door volgende syntax: INSTRUCTIE paramater1, parameter2, ect.
Belangrijk is om te weten dat de instructies altijd met HOOFDLETTERS worden geschreven.

Het onderstaande voorbeeld telt drie getallen bij elkaar op en druk de uitkomst af.

int	getal1		100
int	getal2		54
int	uitkomst	0

main:
	ADD	uitkomst, getal1, getal2	; getal1 en getal2 bij elkaar optellen
	ADD	uitkomst, uitkomst, 600		; 600 bij de uitkomst optellen
	PUSH	uitkomst			; De waarde van uitkomst op de stack zetten
	INT	0x01, 0x03			; De waarde van uitkomst laten printen
	EXIT					; Programma afsluiten

Paramters kunnen zowel variabelen als directe waarden zijn.

Pointers en adressen

Het is mogelijk om verwijzingen te maken naar een stuk geheugen, om bijvoorbeeld een routine te te kunnen schrijven die een willekeurige string afdrukt. Om dit te kunnen doen moet er eerst ruimte gereserveerd worden om het geheugenadres in op te slaan. Dit kan in een pointer variabele. Dit lijkt op een normale variabele, maar de naam begint met een * en heeft geen begin waarde.

char	*tekst	; Dit is een verwijzing naar een willekeurig karakter of string
int	*getal	; Dit is een verwijzing naar een willekeurig getal

Nu kunnen deze variabelen gevult worden met een geheugenadres. Deze kunnen op de volgende manieren opgegeven worden.

char	karakter	'A'	; Deze variabele staat op adres 0x05
char	*tekst

main:
	MOV	tekst, 0x05		; Handmatige toekenning (niet erg handig)
	MOV	tekst, &karakter	; Automatische toekenning (wel erg handig)
	EXIT

Het & teken betekend feitelijk 'adres van'. Het * teken betekend feitelijk 'inhoud van'. Hieronder staat een voorbeeld waarin er karakters uit een string vervangen kunnen worden.

char	vervanger	0	; Het vervangend karakter
char	*adres			; Verwijzing naar de string
short	offset		0	; De offset binnen de string

vervang_karakter:
	ADD	adres, adres, offset	; De pointer het aantal karakters opschuiven
	MOV	*adres, vervanger	; Karakter vervangen
	RET

char	welkom[]	"Welkom"	; Zonder pointer zou deze string niet benaderbaar zijn vanuit vervang_karakter

main:
	MOV	adres, &welkom
	MOV	offset, 3	; 4e karakter ('k')
	MOV	vervanger, 'd'
	JMP	vervang_karakter
	EXIT

Het programma 'Hello World!'

Een onderdeel wat niet kan en niet mag ontbreken is natuurlijk 'Hello World!'.

define	PRINT	0x01
define	STRING	0x06

char	tekst[]	"Hello World!"

main:
	PUSH	&tekst
	INT	PRINT, STRING
	EXIT

Assembleren en uitvoeren

De broncode dient opgeslagen te worden met de extentie .asm. Zo zou de 'Hello World' applicatie bijvoorbeeld 'HelloWorld.asm' kunnen heten.

Via het volgende commando (via commandprompt) kan de code geassembleerd worden: Assembler.exe HelloWorld.asm
De assembler zal automatisch het bestand 'HelloWorld.cuba' genereren binnen de zelfde als 'HelloWorld.asm'. De .cuba extentie geeft aan dat het een CUBA applicatie is.

Om het programma uit te voeren kan het volgende commando worden gebruikt: VirtualMachine.exe HelloWorld.cuba