!!! Synapse Assembler 'SynAssembler' by Steve Hales. Copyright (C) 1982 SYNAPSE Software and Steve Hales

[{TableOfContents }]

!! Introduction
[{Image src='synapse.gif' width=244 height=98 }]\\
SYNAPSE Software\\
\\
SYNASSEMBLER is a convenient and powerful tool for software development on the Atari computer system. The assembler uses standard 6502 mnemonics and syntax, and includes many useful features for creating, editing, assembling and testing your assembly language programs. Now assembly language programming is almost as easy as programming in BASIC.

Here is a summary of the most exciting features:

* Full use of the standard Atari Screen Editor
* Tab stops for opcode, operand, and comment fields
* Fast parameterized renumber and delete command
* Uses BASIC like commands for files (eg. LOAD, SAVE, BLOAD etc.)
* Labels up to 32 characters long (lowercase letters and . accepted)
* English ERROR messages
* Ability to append source programs from tape or disk
* Display of memory usage
* Multiple source files, using .IN directive
* Store object code directly to disk file, using the .TF directive
* Listing to screen option using .LI ON and .LI OFF
* Assembles 6500 lines/minute
* Local labels
* Offending line is listed after an ERROR occurs
* Value of .EQ and address of .BS are printed on listing
* ASSEMBLER, DOS, HARDWARE, and OS locations protected during assembly
* ATASCII literals in address expressions
* Symbol table printed in alphabetical order

Synassembler requires 48K of RAM and one disk drive to operate. Very large programs can now be developed, using the "INCLUDE" and "TARGET FILE" capabilities. These allow the assembly of multiple source files, and direct storage of object code on binary files.

!! Origin
SynAssembler is a port of the S-C Assembler II Version 4.0 from the Apple II. Information from [Apple Assembly Line V2N12|http://www.txbobsc.com/aal/1982/aal8209.html#a1]

''SYNASSEMBLER: Synapse Software has just started marketing a conversion of the S-C Assembler II Version 4.0 for the Atari 800 or 400. You need 48K RAM and at least one disk drive. The conversion was done by Steve Hales, of Livermore, California. He added global replace and copy commands, so this version falls somewhere between the Apple version 4.0 and the new Macro version. It assembles at about 6500 lines per minute, which is from 50 to over 100 times faster than the Atari ASM/ED program.

Since the Atari does not have nice monitor commands built-in, like the Apple does, Steve added a complete set of monitor commands to SYNASSEMBLER. They look exactly like the Apple monitor commands, except that he added some new ones to allow reading and writing a range of disk sectors, delete the tape I/O commands, and included the old Step and Trace commands which were in Apples before the Autostart ROM.

The price is only $49.95 on disk. A ROM version is available by special order for $89.95. I will carry these, if you want to order from me.''

The original sourcecode of S-C Assembler by Bob Sander-Cederlof can be found at
[http://www.txbobsc.com/scsc/scdisassembler/index.html] 

The Apple Assembly line (also by Bob Sander-Cederlof) contains additional information for the S-C Assembler: [http://www.txbobsc.com/aal/index.html]
!! Author

Synapse Assembler has been written by Steve Hales. Steve Hales was and still is an Atari hero and living legend. Describing Steve is quite easy. If you compare Atari to the whole world, then Steve would be a global player. He has done so much for Atari and the community. Steve is already a member in the [hall of fame|https://atariwiki.org/wiki/Wiki.jsp?page=Thanks] and carrier of the sigma, the highest award possible on the AtariWiki. We owe him so much! In 2015 he has given us the source code for Fort Apocalypse, further he has given us the source code listing from Star Raiders! Without his help they would be lost. Steve, tera-thanks to you, may you live long and prosper.

* [Homepage of Steve Hales|http://www.igorlabs.com/]

!! Manual
* [Synapse Assembler Manual] ; online manual
* [Synapse Assembler Manual|Synassembler-Manual.pdf] ; size: 172 KB; pdf-file
* [Synapse Assembler Manual|Synassembler-Manual.doc] ; size: 197 KB; doc-file
* [Synapse Assembler Manual|SynAssembler-Manual-OCR-Bookmarks.pdf] ; size: 225 KB; pdf-file with OCR and bookmarks

!!CAR-Images
* [Synassembler.car] ; cartridge image for Atari 400-800 with OS B
* [Synassembler_XL.car] ; cartridge image for Atari XL-XE

!!ROM-Images
* [Synassembler.rom] ; rom image for Atari 400-800 with OS B; md5: e5dd9f57ff9b807d52a99869dfbfcc17
* [Synassembler XL.rom] ; rom image for Atari XL-XE; md5: 7375df1158ad81f52160f417a49ff78e
* [Synassembler(classic).zip] ; rom images for Atari 400-800 with OS B with different themes
* [Synassembler(XL-XE).zip] ; rom images for Atari XL-XE with different themes

!!ATR-Image
* [SynAssembler.atr] ; atr image for all Atari computers

!!XEX-File
* [SynAssembler_XL.xex] ; xex file for XL-XE Atari computers

!!SynAssembler on Atari XL/XE machines
The original SynAssembler does not work on XL/XE machines, due to the use of direct jumps into the 400/800 OS.

There is a basic program in [ANTIC VOL. 3, NO. 2 / JUNE 1984 / PAGE 38|http://www.atarimagazines.com/v3n2/explore.html] that patches the SynAssembler binary to run on XL/XE type machines.
* [SynAssembler_patch_from_classic_to_XL-XE.atr] ; patch in BASIC

!!Source Code
* [SynAssembler_Source_Code.atr] ; source code of the SynAssembler in MAC/65 format with DOS 2.5 color; Thank you so much Steve Hales, we really appreciate your help for the community. :-)))

!!Atari 8bit Equates files
* [Synapse Assembler Atari 800 OS Equates]

!!Pictures
[{Image src='disk.jpg' width=357 height=308 }]
SynAssembler diskette\\
\\
[{Image src='SynAssembler.jpg' width=573 height=160 }]
SynAssembler startscreen-original after starting with $CA in $02C5 and $C2 in $02C6\\
\\
[{Image src='BLUE.jpg' width=548 height=148 }]
SynAssembler after starting with $CA in $02C5 and $94 in $02C6\\
\\
[{Image src='DARK_BLUE.jpg' width=553 height=148 }]
SynAssembler after starting with $CA in $02C5 and $90 in $02C6\\
\\
[{Image src='BLACK.jpg' width=555 height=149 }]
SynAssembler after starting with $0F in $02C5 and $00 in $02C6\\
\\
[{Image src='WHITE.jpg' width=549 height=148 }]
SynAssembler after starting with $00 in $02C5 and $0F in $02C6\\
\\
[{Image src='RED.jpg' width=544 height=141 }]
SynAssembler after starting with $CA in $02C5 and $34 in $02C6\\
\\
[{Image src='PINK.jpg' width=545 height=145 }]
SynAssembler after starting with $CA in $02C5 and $46 in $02C6\\
\\
[{Image src='YELLOW.jpg' width=542 height=142 }]
SynAssembler after starting with $CA in $02C5 and $FF in $02C6
!! Help File
{{{
00010 *
00020 *  SYNASSEMBLER DIRECTIVES
00030 *
00040  .AS      ASCII STRING
00050     .AS "TEST"
00060  .AT      ATASCII STRING
00070     .AT "SCORE:"
00080  .BS      BLOCK STORAGE
00090     .BS 5  SKIPS 5 BYTES
00100  .DA      WORD
00110     .DA HELLO
00120  .EN     END OF SOURCE (OPTIONAL)
00130     .EN
00140  .EQ     EQUATE
00150     TEST .EQ 5
00160  .HS     HEX STRING
00170     .HS 0001AA5500339944344
00180  .IN      INCLUDE FILE WITH ASM
00190     .IN "D:FILE NAME"
00200  .LI      LIST ON OR OFF
00210     .LI OFF
00220  .OR      SET ORG
00230     .OR $6000
00240  .TA      SET TARGET FOR OBJECT
00250     .TA $9000
00260  .TF      SEND OBJECT TO DISK
00270     .TF "D:FILE NAME"
00280 *
00290 *  SYNASSEMBLER COMMAND
00300 *
00310 LOAD "D:FILE NAME"
00320 SAVE "D:FILE NAME"
00330 BLOAD "D:FILE NAME",<START>
00340 BSAVE "D:FILE NAME",<START>,<END>
00350 ENTER "D:FILE NAME"
00360 DIR       DIRECTORY DRIVE 1
00370 DIR "D4:*.*  DIRECTORY DRIVE 4
00380 DOS
00390 MEM   MEMORY STATUS
00400 LIST L1,L2
00410 NEW
00420 REN L1,L2
00430  RENUMBER L1 USING INC OF L2
00440 REN L1,L2,L3
00450  RENUMBER  L1 USING INC OF L2
00460  STARTING AT L3
00470 COPY L1,L2
00480  COPY L1 AT L2
00490 COPY L1,L2,L3
00500  COPY L1 TO L2 AT L3
00510 MOVE L1,L2
00520  MOVE L1 TO L2
00530 MOVE L1,L2,L3
00540  MOVE L1 TO L2 AT L3
00550 FIND STRING
00560 ASM
00570 DEL L1,L2
00580 HID
00590  HID CURRENT SOURCE PROGRAM
00600 MER
00610  COMBINE HIDDEN SOURCE WITH
00620  CURRENT SOURCE
00630 RUN EXPRESSION
00640 RESTORE
00650  RETURN FROM AN INCLUDE FILE
00660  OR TO UN-HIDE A HIDDEN FILE
00670 SYM
00680  PRINT SYMBOL TABLE
00690 VAL EXPRESSION
00700 REP /.BYTE/.HS/,P
00710  REPLACE WITH PROMPT
00720  PRESS 'Y' TO CHANGE
00730  PRESS 'N' FOR NO CHANGE
00740  PRESS 'X' TO CANCEL REPLACE
00750 REP /.BYTE/.HS/
00760  REPLACE ALL
00770 OUT "P:"
00780  PRINT OUTPUT TO DEVICE
00790 TYPE "P:"
00800  LIST TO DEVICE
00810 LOMEM $4000   OR   LOM $4000
00820  LOMEM OF SYMBOL TABLE
00830 HIMEM $8000   OR   HIM $8000
00840  HIMEM OF SOURCE  CAUTION
00850             DESTROYS SOURCE
00860 MON
00870  JUMP TO MONITOR
00880 Q
00890  JUMP BACK TO ASSEMBLER
00900 ************************
00910 * MONITOR INSTRUCTIONS *
00920 ************************
00930 EXAMINE MEMORY
00940 *
00950 adrs         C0F2
00960 adrs1.adrs2  1024.1048
00970 (RETURN)     DISPLAY NEXT 8 LOC
00980 .adrs        .4096
00990 *
01000 CHANGE MEMORY
01010 *
01020 adrs;data data     A256;EF 20 43
01030 ;data data data    ;F0 A2 12
01040 *
01050 MOVE MEMORY
01060 *
01070 adrs1<adrs2.adrs3M 100<B010.B410M
01080      FROM adrs2 TO adrs3 STARTING            AT adrs1
01090 *
01100 VERIFY MEMORY
01110 *
01120 adrs1<adrs2.adrs3V 100<B010.B410V
01130 *
01140 * READ SECTOR(S)
01150 *
01160 adrs<sec1.sec2r   2000<1.AFr
01170   READ SECTORS 1 TO AF
01180   AND PUT THEM INTO BUFFER
01190   AT 2000
01200 *
01210 * WRITE SECTOR(S)
01220 adrs<sec1.sec2w   2000<1.AFw
01230   WRITE SECTORS 1 TO AF
01240   AND GET THEM FROM BUFFER
01250   AT 2000
01260 *
01270 *
01280 adrsL    C080L
01290 L        NEXT 20 INSTRUCTIONS
01300 *
01310 DEBUGGING
01320 *
01330 adrsG    300G   RUN
01340 adrsT    800T   TRACE
01350 adrsS    C050S  SINGLE STEP
01360 R        DISPLAY REGISTERS
01370          TO CHANGE REGISTERS
01380          TYPE ; THEN DATA
01390          FOR EACH ONE
}}}
!!Review
Synassembler
Synapse Software
5327 Jacuzzi St., Suite 1
Richmond, CA 94804
(415) 527-7751
$49.95 Diskette 48K
$89.95 Cartridge
Reviewed by Adrian Dery

Synapse has come up with a really powerful Assembler, Editor and machine-language Monitor. All these are in a single program which is available on disk, or by special order on a ROM cartridge.

This Editor does for Assembly programs what the BASIC cartridge does for BASIC programs, and it works much the same way. Additional editing commands include: Auto-Line Numbering; Renumber (all or part of a program); Delete Eines; Move and Copy (blocks of lines from one part of a program to another); and Search/ Replace (character strings).

The Editor has a unique HIDE feature that will protect a source program in memory. Load or type in a new program, then edit and assemble it completely apart from the program you are hiding. You can then save it, or delete it, or append it to the hidden program.

The Assembler part of Synassembier is incredibly fast! I have assembled programs as large as 1500 statements and it's average speed is about 100 statements per second, with the source file in memory and the listing turned off.

An Include feature assembles multiple source files in a single pass. This is useful for picking up "canned" subroutines or thmgs like a list of Operating System equates. It also can assemble very large programs and it is quite possible, and sometimes practical, to have a main program that has only Include statements in it.

The Monitor is a full-featured : machine-language debugger. Memory can be displayed, changed or moved around. Registers can also be displayed and changed. Program execution can be traced, or you can singlestep through the instructions. There are also some special read/write commands that allow you to directly read and write any disk sectors without opening a file.

Synassembler is a professional development tool for the experienced programmer as well as the beginner. It has an excellent Editor, a very fast Assembler capable of assembling programs of virtually unlimited size, and a Monitor that should serve well in finding the trickiest of bugs. It's a step above the Atari cartridge because of its speed and ability to include multiple source files. Synassembler does require 48K and you need a disk drive to take advantage of all its features. If you have the memory and the disk, it is a good value for the money.