Perihelion tutorial 1 - Revision history

>Zchris: Changed some characters that displayed oddly

2012-10-08T10:42:37Z

Changed some characters that displayed oddly

>Wongck at 03:29, 19 February 2012

2012-02-19T03:29:46Z

← Older revision		Revision as of 23:29, 18 February 2012
Line 131:		Line 131:

	Last edited 2002-04-07		Last edited 2002-04-07
			<br/><br/>
			proceed to [[Perihelion tutorial 2]]
	[[Category: Perihelions Atari ST M68000 tutorial]]		[[Category: Perihelions Atari ST M68000 tutorial]]

>Wongck at 14:32, 12 October 2011

2011-10-12T14:32:39Z

← Older revision		Revision as of 10:32, 12 October 2011
Line 131:		Line 131:

	Last edited 2002-04-07		Last edited 2002-04-07
	[[Category:~~Category~~ Perihelions Atari ST M68000 tutorial]]		[[Category: Perihelions Atari ST M68000 tutorial]]
	~~[[Category:Programming]]~~
	~~[[Category:Assembly Language~~]]

>Silver Surfer: clean up

2009-05-03T15:35:59Z

clean up

← Older revision		Revision as of 11:35, 3 May 2009
Line 133:		Line 133:
	[[Category:Category Perihelions Atari ST M68000 tutorial]]		[[Category:Category Perihelions Atari ST M68000 tutorial]]
	[[Category:Programming]]		[[Category:Programming]]
			[[Category:Assembly Language]]

>Silver Surfer: clean up

2009-05-03T15:28:12Z

clean up

← Older revision		Revision as of 11:28, 3 May 2009
Line 1:		Line 1:
	~~[[Category:Category Perihelions Atari ST M68000 tutorial]]~~
	'''The Atari ST M68000 tutorial part 1 â€“ on the theory behind programming'''		'''The Atari ST M68000 tutorial part 1 â€“ on the theory behind programming'''

Line 33:		Line 32:
	*â€¦		*â€¦

	In this example, the â€œuser memoryâ€ begins after position $100. All address positions $0 - $100 does something with the hardware in some way, but after that, itâ€™s just storage space. With the above values, and given our premise, the text â€œHello World!â€, will be displayed in white text on black background. Letâ€™s say we were to change the values to this instead.		In this example, the â€œuser memoryâ€ begins after position $100. All address positions $0 â€“ $100 does something with the hardware in some way, but after that, itâ€™s just storage space. With the above values, and given our premise, the text â€œHello World!â€, will be displayed in white text on black background. Letâ€™s say we were to change the values to this instead.

	*Memory Value		*Memory Value
Line 51:		Line 50:
	255. Are you beginning to grasp how computers work?		255. Are you beginning to grasp how computers work?

	If you have an enquiring mind, and I hope you do, youâ€™ll probably wonder why the addresses $0 - $100 only hold numbers, while it seems that addresses $101 - â€¦ can hold letters. The answer is, they actually canâ€™t hold any letters. In addition, it doesnâ€™t quite look like Iâ€™ve shown you either. This might get somewhat complicated, hold your hat and donâ€™t cry if you donâ€™t get it. Just read it, let it go, meditate a bit and youâ€™ll reach enlightenment.		If you have an enquiring mind, and I hope you do, youâ€™ll probably wonder why the addresses $0 â€“ $100 only hold numbers, while it seems that addresses $101 - â€¦ can hold letters. The answer is, they actually canâ€™t hold any letters. In addition, it doesnâ€™t quite look like Iâ€™ve shown you either. This might get somewhat complicated, hold your hat and donâ€™t cry if you donâ€™t get it. Just read it, let it go, meditate a bit and youâ€™ll reach enlightenment.

	The addresses $101 and $200 actually only hold numbers, but the computer have a decode key so that each number can be decoded to a letter. Letâ€™s say that		The addresses $101 and $200 actually only hold numbers, but the computer have a decode key so that each number can be decoded to a letter. Letâ€™s say that
Line 132:		Line 131:

	Last edited 2002-04-07		Last edited 2002-04-07
			[[Category:Category Perihelions Atari ST M68000 tutorial]]
			[[Category:Programming]]

>Muguk at 13:34, 31 January 2006

2006-01-31T13:34:33Z

Show changes

>Muguk at 13:32, 31 January 2006

2006-01-31T13:32:47Z

← Older revision		Revision as of 09:32, 31 January 2006
Line 1:		Line 1:
	[[Category:Category Perihelions Atari ST M68000 tutorial]]		[[Category:Category Perihelions Atari ST M68000 tutorial]]
	The Atari ST M68000 tutorial part 1 â€“ on the theory behind programming		'''The Atari ST M68000 tutorial part 1 â€“ on the theory behind programming'''

	Hi everybody! This is Warrior Munk of poSTmortem (aka Andreas Wahlin) writing. Me and Aldebaran (aka Lars Lindblad) have just started this little project of ours; the demo group poSTmortem. As a first step towards actually doing something with the ST, we thought that writing a tutorial might be good. In this way, we can teach ourselves and you (whoever is listening).		Hi everybody! This is Warrior Munk of poSTmortem (aka Andreas Wahlin) writing. Me and Aldebaran (aka Lars Lindblad) have just started this little project of ours; the demo group poSTmortem. As a first step towards actually doing something with the ST, we thought that writing a tutorial might be good. In this way, we can teach ourselves and you (whoever is listening).

	This tutorial is aimed at people who, like ourselves, want to learn to code assembler for the Atari ST. What? You say, this is the year 2002, why on earth would you want to learn how to code, for one thing, assembler, and assembler for the Atari? You must be crazy. Well, you might think the Atari is dead, but we say it survived itself, it has risen again, it is; poSTmortem (totally lame, right?). You donâ€™t need any programming skills, although it might help since learning to code from assembly language is probably quite suicidal in a pedagogical view. Iâ€™ll try to cover the basics of general programming and setting you up in this tutorial, and in part two we will do some rather simple program to get things started. I will however, assume that you have some basic skills in Atari management, like file copying and so on. Also, I will assume you have a real Atari, emulating might work fine, but nothing beats the real thing.		This tutorial is aimed at people who, like ourselves, want to learn to code assembler for the Atari ST. What? You say, this is the year 2002, why on earth would you want to learn how to code, for one thing, assembler, and assembler for the Atari? You must be crazy. Well, you might think the Atari is dead, but we say it survived itself, it has risen again, it is; poSTmortem (totally lame, right?). You donâ€™t need any programming skills, although it might help since learning to code from assembly language is probably quite suicidal in a pedagogical view. Iâ€™ll try to cover the basics of general programming and setting you up in this tutorial, and in part two we will do some rather simple program to get things started. I will however, assume that you have some basic skills in Atari management, like file copying and so on. Also, I will assume you have a real Atari, emulating might work fine, but nothing beats the real thing.

	What is programming? Programming is the art and science of making the computer do what you want it to do. BTW, programming is also known as coding, I will use these two terms somewhat mixed probably. So, how do we do that? By telling the computer what to do, and then do it. Since you donâ€™t have shit for brains, you will know that when you double click on a .prg file (known as .exe files on a PC), the computer will do stuff, like running a game. So, what if we could create our own .prg filesâ€¦ Yes, we can do that, this is where youâ€™ll learn how!		What is programming? Programming is the art and science of making the computer do what you want it to do. BTW, programming is also known as coding, I will use these two terms somewhat mixed probably. So, how do we do that? By telling the computer what to do, and then do it. Since you donâ€™t have shit for brains, you will know that when you double click on a .prg file (known as .exe files on a PC), the computer will do stuff, like running a game. So, what if we could create our own .prg filesâ€¦ Yes, we can do that, this is where youâ€™ll learn how!

	Every computer has a memory, this is where the number on your Atari is derived from, 520 have half a Meg (short for Mega Byte) of ram, and 1040â€™s have one Meg. Your usual PC these days have about 256 megs of ram, Bill Gates once said â€œnobody needs more than 640 K ram (about the memory amount of an Atari 520). If these numbers confuse you, do not worry, they arenâ€™t important right now. The memory is very temporary; it gets wiped out every time you turn off your Atari, unlike diskettes (thank God). When you run a program, the computer loads the program into memory, and then executes (follows the instructions given by the program).		Every computer has a memory, this is where the number on your Atari is derived from, 520 have half a Meg (short for Mega Byte) of ram, and 1040â€™s have one Meg. Your usual PC these days have about 256 megs of ram, Bill Gates once said â€œnobody needs more than 640 K ram (about the memory amount of an Atari 520). If these numbers confuse you, do not worry, they arenâ€™t important right now. The memory is very temporary; it gets wiped out every time you turn off your Atari, unlike diskettes (thank God). When you run a program, the computer loads the program into memory, and then executes (follows the instructions given by the program).
	~~Â¬Every~~ area of the memory has an address, so you know where you are. You can think of these addresses as normal street addresses, but perhaps it would be better if you thought of them more as page indexes in a book. Every page is filled with information on how to act. So, letâ€™s assume that we have a monitor capable of displaying one of two colours, either black or white. The memory address $20 holds this colour. 1 means black, 0 white. If memory looks like this, we get a black screen.
			Every area of the memory has an address, so you know where you are. You can think of these addresses as normal street addresses, but perhaps it would be better if you thought of them more as page indexes in a book. Every page is filled with information on how to act. So, letâ€™s assume that we have a monitor capable of displaying one of two colours, either black or white. The memory address $20 holds this colour. 1 means black, 0 white. If memory looks like this, we get a black screen.

	Address Value		Address Value
	â€¦		â€¦
Line 43:		Line 48:
	(changed values at $21 and $22)		(changed values at $21 and $22)

	We would get the text â€œDOH!â€ written in black text on black background, not to clever. Therefore, a pointer is a reference to another place. Because $22 only can hold a number of 0 - 255, the text â€œHello World!â€ would never fit, so instead we point to an area in the user memory, which can hold much more than just a number between 0 - 255. Are you beginning to grasp how computers work?		We would get the text â€œDOH!â€ written in black text on black background, not to clever. Therefore, a pointer is a reference to another place. Because $22 only can hold a number of 0 - 255, the text â€œHello World!â€ would never fit, so instead we point to an area in the user memory, which can hold much more than just a number between 0 -
			255. Are you beginning to grasp how computers work?

	If you have an enquiring mind, and I hope you do, youâ€™ll probably wonder why the addresses $0 - $100 only hold numbers, while it seems that addresses $101 - â€¦ can hold letters. The answer is, they actually canâ€™t hold any letters. In addition, it doesnâ€™t quite look like Iâ€™ve shown you either. This might get somewhat complicated, hold your hat and donâ€™t cry if you donâ€™t get it. Just read it, let it go, meditate a bit and youâ€™ll reach enlightenment.		If you have an enquiring mind, and I hope you do, youâ€™ll probably wonder why the addresses $0 - $100 only hold numbers, while it seems that addresses $101 - â€¦ can hold letters. The answer is, they actually canâ€™t hold any letters. In addition, it doesnâ€™t quite look like Iâ€™ve shown you either. This might get somewhat complicated, hold your hat and donâ€™t cry if you donâ€™t get it. Just read it, let it go, meditate a bit and youâ€™ll reach enlightenment.
	The addresses $101 and $200 actually only hold numbers, but the computer have a decode key so that each number can be decoded to a letter. Letâ€™s say that
			The addresses $101 and $200 actually only hold numbers, but the computer have a decode key so that each number can be decoded to a letter. Letâ€™s say that

	! = 0		! = 0
	A = 1		A = 1
Line 61:		Line 70:
	â€¦		â€¦

	So you see, there are just numbers, also, as I said, each address can only hold a number between 0 - 255, meaning that each letter is held in one address. But but but but, why doesnâ€™t more stuff get displayed as text? Why does it stop at $203? The memory must continue after that surely. Letâ€™s look at this memory setup.		So you see, there are just numbers, also, as I said, each address can only hold a number between 0 - 255, meaning that each letter is held in one address. But but but but, why doesnâ€™t more stuff get displayed as text? Why does it stop at $203? The memory must continue after that surely. Letâ€™s look at this memory setup.

	Memory Value Meaning		Memory Value Meaning
Line 71:		Line 80:
	$205 4 D		$205 4 D
	â€¦		â€¦
	The text on the screen would display as â€œDOH!ODâ€ and probably much more (the rest of the memory in fact). Well, here we use a control number, letâ€™s say that the computer knows that when in reaches the number 255 the text ends there. If memory looks like this
			The text on the screen would display as â€œDOH!ODâ€ and probably much more (the rest of the memory in fact). Well, here we use a control number, letâ€™s say that the computer knows that when in reaches the number 255 the text ends there. If memory looks like this

	Memory Value Meaning		Memory Value Meaning
Line 87:		Line 97:
	$205 4 D		$205 4 D

	~~the~~ text â€œDOH!â€ would be displayed in white on black background. When the computer reaches $204, it sees the number 255, which means stop displaying text, so the letter (or rather, value) at $205 and following addresses will not be displayed. Like I said, this may be a bit advanced, donâ€™t panic. We will get much more concrete in tutorial 2. I just want you to have a theoretical basis so you know whatâ€™s what and so you can refer back to this. Just let this sink into your unconscious, when the time is right and you have correct understanding, it will surface and you will get it.		The text â€œDOH!â€ would be displayed in white on black background. When the computer reaches $204, it sees the number 255, which means stop displaying text, so the letter (or rather, value) at $205 and following addresses will not be displayed. Like I said, this may be a bit advanced, donâ€™t panic. We will get much more concrete in tutorial 2. I just want you to have a theoretical basis so you know whatâ€™s what and so you can refer back to this. Just let this sink into your unconscious, when the time is right and you have correct understanding, it will surface and you will get it.
	Now, for last theory lesson; how do you actually make something happen? As we know, there are .prg files that make stuff happen. With our above knowledge, we know that they affect memory. We can write down simple commands in a text file, and then have that text file translated into the .prg format, so that the computer will understand what we say. A program that can pull this off is known as a compiler, a compiler usually comes with a text editor, suited for programming needs. The text file you use to create a .prg file, is knows as the source code. Letâ€™s take another example, this time letâ€™s assume we wrote this source code.
			Now, for last theory lesson; how do you actually make something happen? As we know, there are .prg files that make stuff happen. With our above knowledge, we know that they affect memory. We can write down simple commands in a text file, and then have that text file translated into the .prg format, so that the computer will understand what we say. A program that can pull this off is known as a compiler, a compiler usually comes with a text editor, suited for programming needs. The text file you use to create a .prg file, is knows as the source code. Letâ€™s take another example, this time letâ€™s assume we wrote this source code.

	Put #1 at $20		Put #1 at $20
	Put #0 at $21		Put #0 at $21
Line 98:		Line 110:
	Put #255 at $204		Put #255 at $204
	Initialize monitor		Initialize monitor
	Now, as you can guess, # stands for value, a numerical value in our case, and $ stands for address. Now, if we compile this source code, that is, translate it to a format the computer understands, we will get a .prg file. When we double click on that file, the computer will do what it says above; the different values will be loaded into the different addresses, creating the memory profile given above. The last line â€œInitialize monitorâ€ is for engaging the monitor. When the monitor is engaged, the Atari knows that it should look at $20, $21 and $22 to gather the data needed. So instead of â€œInitialize monitorâ€, perhaps we couldâ€™ve written
			Now, as you can guess, # stands for value, a numerical value in our case, and $ stands for address. Now, if we compile this source code, that is, translate it to a format the computer understands, we will get a .prg file.

			When we double click on that file, the computer will do what it says above; the different values will be loaded into the different addresses, creating the memory profile given above. The last line â€œInitialize monitorâ€ is for engaging the monitor. When the monitor is engaged, the Atari knows that it should look at $20, $21 and $22 to gather the data needed. So instead of â€œInitialize monitorâ€, perhaps we couldâ€™ve written

	Activate $20		Activate $20
	Activate $21		Activate $21
	Activate $22		Activate $22

	Because what we really want to do is to make the information on these addresses happen; we want the computer to process the information given. This is long and clumsy however, and the line â€œInitialize monitorâ€, or whatever you might call it, is far simpler.		Because what we really want to do is to make the information on these addresses happen; we want the computer to process the information given. This is long and clumsy however, and the line â€œInitialize monitorâ€, or whatever you might call it, is far simpler.

	The computer, internally, understands nothing but 1â€™s and 0â€™s, all text and numbers I have given above is for human understanding (more on binary understanding later). Also, none of the commands or memory addresses have any significance for the Atari, they are examples only.		The computer, internally, understands nothing but 1â€™s and 0â€™s, all text and numbers I have given above is for human understanding (more on binary understanding later). Also, none of the commands or memory addresses have any significance for the Atari, they are examples only.

	OK, theory lesson over. Hope I havenâ€™t scared you away. In the next tutorial we will get into how to actually make a .prg file. It wonâ€™t do much, but at least you will get to see your code in action.		OK, theory lesson over. Hope I havenâ€™t scared you away. In the next tutorial we will get into how to actually make a .prg file. It wonâ€™t do much, but at least you will get to see your code in action.

	Warrior Munk of poSTmortem, 2002-03-31		Warrior Munk of poSTmortem, 2002-03-31
	â€œConan, what is best in life?â€		''â€œConan, what is best in life?â€
	â€œTo crush your enemies, see them driven before you, and to hear the lamentations of their women.â€		â€œTo crush your enemies, see them driven before you, and to hear the lamentations of their women.â€''
	Conan the Barbarian		Conan the Barbarian


	Last edited 2002-04-07		Last edited 2002-04-07

>Admin at 23:04, 30 January 2006

2006-01-30T23:04:17Z

Show changes

>Admin at 21:40, 30 January 2006

2006-01-30T21:40:16Z

← Older revision		Revision as of 17:40, 30 January 2006
Line 1:		Line 1:
			[[Category:Category Perihelions Atari ST M68000 tutorial]]
	<center>'''The Atari ST M68000 tutorial part 1 â€“ on the theory behind programming'''</center>		<center>'''The Atari ST M68000 tutorial part 1 â€“ on the theory behind programming'''</center>
	<div align="center">		<div align="center">

>Admin at 21:32, 30 January 2006

2006-01-30T21:32:41Z

Show changes