Menu
Home
People
Places
Arts
History
Plants & Animals
Science
Life & Culture
Technology
Reference.org
Atari Assembler Editor
open-in-new
<h2 id="development-environment">Development environment</h2> <p>The Assembler Editor is a <a href="/facts/Two-pass_assembler/7XuV0cla">two-pass</a> <a href="/facts/MOS_Technology_6502/q9YLwkzm">6502</a> assembler in an 8<a href="/facts/Kilobyte/jIe6t4yv">KB</a> cartridge. Both source and object code can be in memory simultaneously, allowing repeated editing, assembly, and running of the resulting code without accessing a disk or tape drive.<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a> </p> <h3>Edit</h3> <p>The cartridge starts in EDIT mode. The programmer enters lines of assembly <a href="/facts/Source_code/o9J6Jv23">source</a> into the <a href="/facts/Atari_BASIC/aSleVCgU">Atari BASIC</a>-like <a href="/facts/Source_code_editor/D0hecHMt">editor</a>. Source text must be prefixed with a line number or it is interpreted as a command. Like Atari BASIC, Assembler Editor includes an ENTER command that can be used to combine files together into a single larger program listing. Unlike Atari BASIC, Assembler Editor includes commands for automatically creating spaced-out line numbers, as well as renumbering lines and deleting them <i>en masse</i>. A FIND command is useful when working with labels.<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a> </p><p>Instructions are listed in the order they will be placed in memory. The starting point for instructions is specified with the *= directive, so, for instance, code intended to be placed in the special "page six" would be prefixed with the line *= $0600.<a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a> Variable names can be assigned to specific addresses, and this was often combined with an increment *= *+1 to directly encode offsets into tables.<a class="footnote-ref" id="fnref:9" href="#fn:9"><sup>9</sup></a> </p><p>Values following instructions are normally interpreted as "the value at this memory address", but an actual numeric value can be provided as an "immediate operand" by appending it with a hash, like LDA #12, which loads the accumulator with the decimal value 12. Hexadecimal is indicated with a dollar sign, LDA #$12 loads the accumulator with 12 hex, or 18 decimal. Indirect addressing is supported using parentheses; LDA ($600) uses the values in location $600,$601 to produce a 16-bit address, and then loads the accumulator with the value found at that location.<a class="footnote-ref" id="fnref:10" href="#fn:10"><sup>10</sup></a> </p><p>Errors are reported with numeric codes that can be looked up in the manual. There are 19 assembler-specific codes and 16 additional codes for operating system <a href="/facts/Input%2foutput/WQTE8Jas">input/output</a> errors.<a class="footnote-ref" id="fnref:11" href="#fn:11"><sup>11</sup></a> </p> <h3>Assemble</h3> <p>Code is assembled by typing the ASM command into the editor.<a class="footnote-ref" id="fnref:12" href="#fn:12"><sup>12</sup></a> </p><p>Assembler Editor was widely derided as the slowest assembler on the platform. Much of this is from sharing code with Atari BASIC, also written by Shepardson Microsystems. Atari BASIC uses slow routines used to convert numeric constants in code to an internal <a href="/facts/Binary-coded_decimal/dWTaE7ES">binary-coded decimal</a> representation via <a href="/facts/Operating_system/8XTuvMh2">operating system</a> routines. All numbers, even line numbers, have to be converted to binary-coded decimal. It also means that 1E2 is a legal line number.<a class="footnote-ref" id="fnref:13" href="#fn:13"><sup>13</sup></a> </p> <h3>Debug</h3> <p>The <a href="/facts/Debugging/QtdpPJT0">debugger</a>, really a <a href="/facts/Machine_code_monitor/fv05amgv">monitor</a>, is entered with the BUG command.<a class="footnote-ref" id="fnref:14" href="#fn:14"><sup>14</sup></a> The X command returns to EDIT mode.<a class="footnote-ref" id="fnref:15" href="#fn:15"><sup>15</sup></a> The debugger allows the viewing and changing of <a href="/facts/Processor_register/32RvbUdz">registers</a> and memory locations, code tracing, single-step and <a href="/facts/Disassembly/4PR39BbK">disassembly</a>.<a class="footnote-ref" id="fnref:16" href="#fn:16"><sup>16</sup></a> </p> <h2 id="history">History</h2> <p>Assembler Editor was written by Kathleen O'Brien of <a href="/facts/Shepardson_Microsystems/J2kRfFN3">Shepardson Microsystems</a>. The company had been hired by Atari to help fit <a href="/facts/Microsoft_BASIC/SuctFIyc">Microsoft 6502 BASIC</a> onto an 8KB <a href="/facts/Read_only_memory/P9QMuDLH">ROM</a>, something programmers at Atari were struggling with. Instead, Bill Wilkinson suggested designing an entirely new version of BASIC, which became <a href="/facts/Atari_BASIC/aSleVCgU">Atari BASIC</a>.<a class="footnote-ref" id="fnref:17" href="#fn:17"><sup>17</sup></a> </p><p>While Atari BASIC was being written, primarily by Paul Laughton, O'Brien's husband, O'Brien worked on the Assembler Editor.<a class="footnote-ref" id="fnref:18" href="#fn:18"><sup>18</sup></a> It was written by punching codes into a <a href="/facts/Punch_tape/8HI7dThI">punch tape</a> machine, running the tape through an <a href="/facts/EPROM/kXcEca36">EPROM</a> burner, and then testing the resulting ROM in an Atari 800. The cartridge was completed before Atari BASIC, and O'Brien spent some time working on portions of that project as well.<a class="footnote-ref" id="fnref:19" href="#fn:19"><sup>19</sup></a> </p><p>As part of Shepardson's work, a number of common routines were incorporated into the Atari computer's <a href="/facts/Operating_system/8XTuvMh2">operating system</a>, including the <a href="/facts/Floating_point/eIckahxe">floating point</a> math functions. These were written by O'Brien, the first floating point math code she worked on.<a class="footnote-ref" id="fnref:20" href="#fn:20"><sup>20</sup></a> The low performance of key functions affected both Atari BASIC and the Assembler Editor and was a topic that Wilkinson often wrote about.<a class="footnote-ref" id="fnref:21" href="#fn:21"><sup>21</sup></a> </p> <h2 id="example-code">Example code</h2> <p>The following is 6502 code for <a href="/facts/Hello_world_program/vLn0jLlL">Hello World!</a> written for the Assembler Editor: </p> 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 <p>These commands can be interactively entered to assemble the code, enter the debugger, run the program, then exit the debugger when it is finished: </p> ASM BUG G600 X <h2 id="legacy">Legacy</h2> <p>Shortly after Shepardson delivered Assembler Editor and Atari BASIC to Atari, Bob Shepardson, the owner, decided to return to being a one-person company.<a class="footnote-ref" id="fnref:22" href="#fn:22"><sup>22</sup></a> O'Brien, Laughton, and Wilkinson formed their own company, <a href="/facts/Optimized_Systems_Software/FnxzJslo">Optimized Systems Software</a> (OSS), to continue development of the Atari products. They licensed the original <a href="/facts/Source_code/o9J6Jv23">source code</a> for BASIC, Assembler Editor, and <a href="/facts/Atari_DOS/WCbXpP5N">Atari DOS</a>, which they had collectively written.<a class="footnote-ref" id="fnref:23" href="#fn:23"><sup>23</sup></a> </p><p>In 1981, OSS released an improved version of Assembler Editor, <a href="/facts/Optimized_Systems_Software/FnxzJslo">EASMD</a> on <a href="/facts/Floppy_disk/rShxfuxa">floppy disk</a>. EASMD was replaced by <a href="/facts/MAC%2f65/B2NL0HSK">MAC/65</a> in 1982. MAC/65 was one of the fastest assemblers on the platform.<a class="footnote-ref" id="fnref:24" href="#fn:24"><sup>24</sup></a> Much of the improved performance of MAC/65 is the result of tokenizing lines of code as they're entered—as is the case with Atari BASIC—to reduce the amount of work needed at assembly time.<a class="footnote-ref" id="fnref:25" href="#fn:25"><sup>25</sup></a> </p><p>Assembler Editor continued to be available from Atari, and increased in popularity as the price dropped to <a href="/facts/United_States_dollar/naEEDUhC">US$</a>10 or 5 in the latter half of the 1980s.<a class="footnote-ref" id="fnref:26" href="#fn:26"><sup>26</sup></a> </p> <h3>Citations</h3> <h3>Bibliography</h3> <ul><li><a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf"><i>Atari Assembler Editor User Manual</i></a> (PDF). Atari. 1981.</li> <li>Hague, James (2 August 2009). <a href="http://prog21.dadgum.com/45.html">"A Personal History of Compilation Speed, Part 1"</a>. <i>Programming in the 21st Century</i>.</li> <li>Kathleen O'Brien, Kevin Savetz (13 March 2015). <a href="http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss"><i>Kathleen O'Brien, OSS</i></a> (Podcast).</li> <li><a href="/facts/Russ_Wetmore/BgqSxJXw">Wetmore, Russ</a> (November 1983). <a href="http://www.atarimagazines.com/hi-res/v1n1/advanceduser.php">"Atari 8-bit assemblers reviewed"</a>. <i>Hi-Res</i>. Vol. 1, no. 1.</li> <li>Wilkinson, Bill (1982). <a href="http://www.atariarchives.org/iad/introduction.php"><i>Inside Atari DOS</i></a>. Optimized Systems Software, Inc. <a href="/facts/ISBN_(identifier)/15AdSPa9">ISBN</a> 0-942386-02-7. Retrieved 2009-04-04.</li></ul> <h2 id="external-links">External links</h2> <ul><li><a href="http://www.atarimania.com/utility-atari-400-800-xl-xe-assembler-editor_19777.html">Assembler Editor</a> at Atari Mania, including manual</li> <li><a href="http://www.mixinc.net/atari/amac.htm">Atari Macro Assembler</a> information</li></ul> <h2 id="references">References</h2> <ol> <li id="fn:1"><p>Manual 1981, p. 63. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li> <li id="fn:2"><p>Crawford, Chris (1982). Source Code for Eastern Front (1941). The ATARI Program Exchange. <a href="http://www.erasmatazz.com/library/source-code/index.html" target="_blank">http://www.erasmatazz.com/library/source-code/index.html</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li> <li id="fn:3"><p>The Creative Atari: Dog Daze and Caverns of Mars. 1983. <a href="https://www.atariarchives.org/creativeatari/Dog_Daze_and_Caverns_of_Mars.php" target="_blank">https://www.atariarchives.org/creativeatari/Dog_Daze_and_Caverns_of_Mars.php</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li> <li id="fn:4"><p>Crockford, Douglas (1982). Galahad and the Holy Grail Manual (PDF). The ATARI Program Exchange. <a href="http://www.atarimania.com/8bit/files/APX_Galahad_and_the_Holy_Grail.pdf" target="_blank">http://www.atarimania.com/8bit/files/APX_Galahad_and_the_Holy_Grail.pdf</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li> <li id="fn:5"><p>Ellison, Peter (April 1984). "Interview: Arti Haroutunian". ROM (5): 8. <a href="https://www.atarimagazines.com/rom/issue5/interview.php" target="_blank">https://www.atarimagazines.com/rom/issue5/interview.php</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li> <li id="fn:6"><p>Hague 2009. - Hague, James (2 August 2009). "A Personal History of Compilation Speed, Part 1". Programming in the 21st Century. <a href="http://prog21.dadgum.com/45.html" target="_blank">http://prog21.dadgum.com/45.html</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li> <li id="fn:7"><p>Manual 1981, p. 15. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li> <li id="fn:8"><p>Manual 1981, p. 7,31. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li> <li id="fn:9"><p>Manual 1981, p. 31. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></p></li> <li id="fn:10"><p>Manual 1981, pp. 10–12. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:10" class="footnote-back-ref">↩</a></p></li> <li id="fn:11"><p>Manual 1981, pp. 43–44. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:11" class="footnote-back-ref">↩</a></p></li> <li id="fn:12"><p>Manual 1981, p. 25. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:12" class="footnote-back-ref">↩</a></p></li> <li id="fn:13"><p>Wetmore 1983, p. 29. - Wetmore, Russ (November 1983). "Atari 8-bit assemblers reviewed". Hi-Res. Vol. 1, no. 1. <a href="http://www.atarimagazines.com/hi-res/v1n1/advanceduser.php" target="_blank">http://www.atarimagazines.com/hi-res/v1n1/advanceduser.php</a> <a href="#fnref:13" class="footnote-back-ref">↩</a></p></li> <li id="fn:14"><p>Manual 1981, p. 35. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:14" class="footnote-back-ref">↩</a></p></li> <li id="fn:15"><p>Manual 1981, p. 41. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:15" class="footnote-back-ref">↩</a></p></li> <li id="fn:16"><p>Manual 1981, pp. 35–41. - Atari Assembler Editor User Manual (PDF). Atari. 1981. <a href="https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf" target="_blank">https://www.strotmann.de/~cas/Infothek/AtAssemblerEditor/ATARIAssemblerEditorUserManual.pdf</a> <a href="#fnref:16" class="footnote-back-ref">↩</a></p></li> <li id="fn:17"><p>Interview 2015. - Kathleen O'Brien, Kevin Savetz (13 March 2015). Kathleen O'Brien, OSS (Podcast). <a href="http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss" target="_blank">http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss</a> <a href="#fnref:17" class="footnote-back-ref">↩</a></p></li> <li id="fn:18"><p>Interview 2015. - Kathleen O'Brien, Kevin Savetz (13 March 2015). Kathleen O'Brien, OSS (Podcast). <a href="http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss" target="_blank">http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss</a> <a href="#fnref:18" class="footnote-back-ref">↩</a></p></li> <li id="fn:19"><p>Interview 2015. - Kathleen O'Brien, Kevin Savetz (13 March 2015). Kathleen O'Brien, OSS (Podcast). <a href="http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss" target="_blank">http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss</a> <a href="#fnref:19" class="footnote-back-ref">↩</a></p></li> <li id="fn:20"><p>Interview 2015. - Kathleen O'Brien, Kevin Savetz (13 March 2015). Kathleen O'Brien, OSS (Podcast). <a href="http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss" target="_blank">http://ataripodcast.libsyn.com/antic-interview-21-the-atari-8-bit-podcast-kathleen-obrien-oss</a> <a href="#fnref:20" class="footnote-back-ref">↩</a></p></li> <li id="fn:21"><p>Wilkinson, Bill (February 1985). "INSIGHT: Atari". Compute!. p. 139. <a href="#fnref:21" class="footnote-back-ref">↩</a></p></li> <li id="fn:22"><p>Wilkinson 1982, p. vi. - Wilkinson, Bill (1982). Inside Atari DOS. Optimized Systems Software, Inc. ISBN 0-942386-02-7. Retrieved 2009-04-04. <a href="http://www.atariarchives.org/iad/introduction.php" target="_blank">http://www.atariarchives.org/iad/introduction.php</a> <a href="#fnref:22" class="footnote-back-ref">↩</a></p></li> <li id="fn:23"><p>Wilkinson 1982, pp. vi–vii. - Wilkinson, Bill (1982). Inside Atari DOS. Optimized Systems Software, Inc. ISBN 0-942386-02-7. Retrieved 2009-04-04. <a href="http://www.atariarchives.org/iad/introduction.php" target="_blank">http://www.atariarchives.org/iad/introduction.php</a> <a href="#fnref:23" class="footnote-back-ref">↩</a></p></li> <li id="fn:24"><p>Wetmore 1983, p. 29. - Wetmore, Russ (November 1983). "Atari 8-bit assemblers reviewed". Hi-Res. Vol. 1, no. 1. <a href="http://www.atarimagazines.com/hi-res/v1n1/advanceduser.php" target="_blank">http://www.atarimagazines.com/hi-res/v1n1/advanceduser.php</a> <a href="#fnref:24" class="footnote-back-ref">↩</a></p></li> <li id="fn:25"><p>Hague 2009. - Hague, James (2 August 2009). "A Personal History of Compilation Speed, Part 1". Programming in the 21st Century. <a href="http://prog21.dadgum.com/45.html" target="_blank">http://prog21.dadgum.com/45.html</a> <a href="#fnref:25" class="footnote-back-ref">↩</a></p></li> <li id="fn:26"><p>Ratcliff, Matthew (20 November 1989). "Atari Assembler Editor Reference". <a href="http://www.atariarchives.org/cfn/12/02/0090.php" target="_blank">http://www.atariarchives.org/cfn/12/02/0090.php</a> <a href="#fnref:26" class="footnote-back-ref">↩</a></p></li> </ol>