Atari Assembler Editor ; Copyright (C) 1980 Atari, Inc. & Kathleen Ann O'Brien#
Atari Assembler Editor Box Cover
The Atari Assembler Editor cartridge was a program used to edit, compile and debug assembly language programs for the Atari 8-bit computers. It was programmed by Kathleen Ann O'Brien of Shepardson Microsystems, Inc., later founding member of OSS, Inc.. It was the first commercially available assembler for the Atari 8-bit computers ever. And yes, it was programmed by a woman. Showing once more, how far ahead of time SMI and OSS were. The program was a two-pass 6502 assembler, in an 8 KB cartridge. With the command
SIZE, the user gets the info, how much space is free and the command
DOS, exits the cartridge and jumps into the Disk Operationg System (DOS). There are rumors of a
LOMEM command, but AtariWiki couldn't verify this.
Assembler Editor - revision A & B cartridges, outlook for revision C and maybe D#
There are two different versions of the cartridge which could be verified very easy, please see the md5 checksums below. AtariWiki dares to define them as revision A and B in analogy to the Atari Basic cartridge, which was delivered in three different versions. It is easy to find out, which version one has, just type in ASM and hit RETURN. If you have a revision A cartridge, no error message is shown, in case you have a revision B cartridge, the amount of errors are shown. Please see the two pictures below for an example:
Assembler Editor - revision A cartridge test result
Assembler Editor - revision B cartridge test result
A binary compare of both cartridges did show, that there is much more different than that! Future investigations have to show, what else is different and how the user can profit of it.
Revision C:
In the future all bugs shoud be collected and if they can be fixed, a revision C is thinkable. Of course, this requires the source code of the program, which we sadly do not have, nor a license for. Maybe there will be a good soul out there, who will give it to us in the future? At least, the
source code chapter
has shown, that there is always hope, unless we never give up. :-)
Revision D:
If we go far ahead of this, then even an interbreed with the
TURBO-BASIC XL source code is thinkable. In 1985 this was done for the Atari Basic cartridge by Frank Ostrowski and because many code routines are similar, there is a great chance to achieve this. Of course, even a renaming of the cartrige is possible, AtariWiki suggest to call it: 'Atari Turbo-Assembler Editor'. ;-)
CAR images#
ROM images#
BIN images#
ATR images#
XEX files#
Manuals#
Pictures#
Atari Assembler Editor Box Cover - front
Atari Assembler Editor Box Cover - back
Assembler Editor Cartridge - Revision A?
Assembler Editor Cartridge - Revision B?
Atari Assembler Editor Box Cover - front German version
Atari Assembler Editor Box Cover - back German version
References#
Changing the editors color and background#
Assembler Editor Cartridge - changing the editor's color and background to user desired colors for better editing
Hello World! Source Code for the Atari Assembler Editor#
This is the Hello World! source code:
10 ; HELLO.ASM
20 ; ---------
30 ;
40 ; THIS ATARI ASSEMBLY PROGRAM
50 ; WILL PRINT THE "HELLO WORLD"
60 ; MESSAGE TO THE SCREEN
70 ;
0100 ; CIO EQUATES
0110 ; ===========
0120 *= $0340 ;START OF IOCB
0130 IOCB
0140 ;
0150 ICHID *= *+1 ;DEVICE HANDLER
0160 ICDNO *= *+1 ;DEVICE NUMBER
0170 ICCOM *= *+1 ;I/O COMMAND
0180 ICSTA *= *+1 ;I/O STATUS
0190 ICBAL *= *+1 ;LSB BUFFER ADDR
0200 ICBAH *= *+1 ;MSB BUFFER ADDR
0210 ICPTL *= *+1 ;LSB PUT ROUTINE
0220 ICPTH *= *+1 ;MSB PUT ROUTINE
0230 ICBLL *= *+1 ;LSB BUFFER LEN
0240 ICBLH *= *+1 ;MSB BUFFER LEN
0250 ICAX1 *= *+1 ;AUX BYTE 1
0260 ICAX2 *= *+1 ;AUX BYTE 1
0270 ;
0280 GETREC = 5 ;GET TEXT RECORD
0290 PUTREC = 9 ;PUT TEXT RECORD
0300 ;
0310 CIOV = $E456 ;CIO ENTRY VECTOR
0320 RUNAD = $02E0 ;RUN ADDRESS
0330 EOL = $9B ;END OF LINE
0340 ;
0350 ; SETUP FOR CIO
0360 ; -------------
0370 *= $0600
0380 START LDX #0 ;IOCB 0
0390 LDA #PUTREC ;WANT OUTPUT
0400 STA ICCOM,X ;ISSUE CMD
0410 LDA #MSG&255 ;LOW BYTE OF MSG
0420 STA ICBAL,X ; INTO ICBAL
0430 LDA #MSG/256 ;HIGH BYTE
0440 STA ICBAH,X ; INTO ICBAH
0450 LDA #0 ;LENGTH OF MSG
0460 STA ICBLH,X ; HIGH BYTE
0470 LDA #$FF ;255 CHAR LENGTH
0480 STA ICBLL,X ; LOW BYTE
0490 ;
0500 ; CALL CIO TO PRINT
0510 ; -----------------
0520 JSR CIOV ;CALL CIO
0530 RTS ;EXIT TO DOS
0540 ;
0550 ; OUR MESSAGE
0560 ; -----------
0570 MSG .BYTE "HELLO WORLD!",EOL
0580 ;
0590 ; INIT RUN ADDRESS
0600 ; ----------------
0610 *= RUNAD
0620 .WORD START
0630 .END
This is the Hello World! source code in assembled form:
10 ; HELLO.ASM
20 ; ---------
30 ;
40 ; THIS ATARI ASSEMBLY PROGRAM
50 ; WILL PRINT THE "HELLO WORLD"
60 ; MESSAGE TO THE SCREEN
70 ;
0100 ; CIO EQUATES
0110 ; ===========
0000 0120 *= $0340 ;START OF IOCB
0130 IOCB
0140 ;
0340 0150 ICHID *= *+1 ;DEVICE HANDLER
0341 0160 ICDNO *= *+1 ;DEVICE NUMBER
0342 0170 ICCOM *= *+1 ;I/O COMMAND
0343 0180 ICSTA *= *+1 ;I/O STATUS
0344 0190 ICBAL *= *+1 ;LSB BUFFER ADDR
0345 0200 ICBAH *= *+1 ;MSB BUFFER ADDR
0346 0210 ICPTL *= *+1 ;LSB PUT ROUTINE
0347 0220 ICPTH *= *+1 ;MSB PUT ROUTINE
0348 0230 ICBLL *= *+1 ;LSB BUFFER LEN
0349 0240 ICBLH *= *+1 ;MSB BUFFER LEN
034A 0250 ICAX1 *= *+1 ;AUX BYTE 1
034B 0260 ICAX2 *= *+1 ;AUX BYTE 1
0270 ;
0005 0280 GETREC = 5 ;GET TEXT RECORD
0009 0290 PUTREC = 9 ;PUT TEXT RECORD
0300 ;
E456 0310 CIOV = $E456 ;CIO ENTRY VECTOR
02E0 0320 RUNAD = $02E0 ;RUN ADDRESS
009B 0330 EOL = $9B ;END OF LINE
0340 ;
0350 ; SETUP FOR CIO
0360 ; -------------
034C 0370 *= $0600
0600 A200 0380 START LDX #0 ;IOCB 0
0602 A909 0390 LDA #PUTREC ;WANT OUTPUT
0604 9D4203 0400 STA ICCOM,X ;ISSUE CMD
0607 A91F 0410 LDA #MSG&255 ;LOW BYTE OF MSG
0609 9D4403 0420 STA ICBAL,X ; INTO ICBAL
060C A906 0430 LDA #MSG/256 ;HIGH BYTE
060E 9D4503 0440 STA ICBAH,X ; INTO ICBAH
0611 A900 0450 LDA #0 ;LENGTH OF MSG
0613 9D4903 0460 STA ICBLH,X ; HIGH BYTE
0616 A9FF 0470 LDA #$FF ;255 CHAR LENGTH
0618 9D4803 0480 STA ICBLL,X ; LOW BYTE
0490 ;
0500 ; CALL CIO TO PRINT
0510 ; -----------------
061B 2056E4 0520 JSR CIOV ;CALL CIO
061E 60 0530 RTS ;EXIT TO DOS
0540 ;
0550 ; OUR MESSAGE
0560 ; -----------
061F 48 0570 MSG .BYTE "HELLO WORLD!",EOL
0620 45
0621 4C
0622 4C
0623 4F
0624 20
0625 57
0626 4F
0627 52
0628 4C
0629 44
062A 21
062B 9B
0580 ;
0590 ; INIT RUN ADDRESS
0600 ; ----------------
062C 0610 *= RUNAD
02E0 0006 0620 .WORD START
02E2 0630 .END
0 ERRORS
; md5 checksum: 13b6dfbcad3ee35f511209b790e04675
