6502 relocating cross assembler version 20.53.12\nCopyright, The Boston Systems Office, Inc. 1978\n(617) 894-7800 TWX: 710-324-0760\nType \/H for help\n<\/code><\/pre>\nSeries Overview<\/h2>\n\n- Part 0:\u00a0Overview<\/a><\/li>\n
- Part 1:\u00a0MOS Cross-Assembler<\/a><\/li>\n
- Part 2:\u00a0MOS Resident Assembler<\/a><\/li>\n
- Part 3:\u00a0BSO CY6502<\/strong> \u2190 this article<\/li>\n
- Part 4:\u00a0HCD65<\/a><\/li>\n
- Part 5:\u00a06502ASM<\/a><\/li>\n<\/ul>\n
![\"\"](\"docs\/cbmasm\/cbmasm_history.png\")
<\/p>\n
History<\/h2>\n
Commodore bought the chip-maker MOS in 1976 and with it its development tools: They used the so-called MOS “Resident Assembler” (part 2<\/a> of the series) \u2013 first on the MDT650 and later on the PET \u2013 to develop for machines like the VIC-20 and the C64, and for disk drives like the 8250 and the 1541.<\/p>\nIn 1984, they switched to a cross-assembler by the company “Boston Systems Office” (BSO).<\/p>\n
Boston Systems Office<\/h2>\n
Boston Systems Office had been specializing on cross-development tools since 1975, offering dozens of cross-assemblers for Tymshare<\/a> systems that were hand-written in PDP-10 assembly for maximum speed, and that aimed at full compatibility with the CPU-makers’ own tools.<\/p>\nSince 1976, they had been offering a 6502 assembler. The 1979 version of the BSO 6502 cross-assembler, called “CA6500” (documentation<\/a>, PDP-10 binary<\/a>) was highly compatible with the original MOS assemblers, and had added a few features.<\/p>\nAccording to internal documentation<\/a>, Atari had used CA6500 on a PDP-11 for their in-house 6502 development as early as mid-1980.<\/p>\nIn early 1984, BSO released<\/a> a version for PDP-11 and VAX\/VMS named CY65XX1<\/a><\/sup>, which was then licensed by Commodore. This version had many additional features added.<\/p>\nNo binary of the assembler seems to be archived anywhere, but we do have the manual of the last version Commodore used:<\/p>\n
\n- CY6502 Version 20.53.12 Manual<\/a> (1985)<\/li>\n<\/ul>\n
Usage<\/h2>\n
When run, the BSO assembler shows the following prompt:<\/p>\n
6502 relocating cross assembler version 20.53.12\nCopyright, The Boston Systems Office, Inc. 1978\n(617) 894-7800 TWX: 710-324-0760\nType \/H for help\nC65>\n<\/code><\/pre>\nThe output file (ABS) file, the LST file and the SRC file would be specified like this:<\/p>\n
C65>PROG.ABS,PROG.LST=PROG.SRC\n<\/code><\/pre>\nThe file name extensions are optional. If they are omitted, the defaults are used.<\/p>\n
The output file is in BSOs’ own “ABS” format, and needs another conversion step using the tool OBJCNV:<\/p>\n
Object file converter Version 3.25\nCopyright, The Boston Systems Office, Inc. 1978\nTEL: (617) 894-7800 TWX: 710-324-0760\nType \/H for help\n>\n<\/code><\/pre>\nTo convert the resulting ABS file into the MOS “OBJ” format, you would type this at the prompt:<\/p>\n
>PROG.OBJ\/F:MTK=PROG.ABS\/F:BSO\n<\/code><\/pre>\nMTK<\/code> stands for MOSTEK, a chipmaker unrelated to MOS Technology, Inc. BSO seems to have had confused the two companies: ABS files also contain the string 6502,MOSTEK<\/code>.<\/p>\nIn practice, one would use a DCL script to invoke both tools with the right arguments.<\/p>\n
Differences to Original MOS Spec<\/h2>\n
The BSO assembler diverged in two aspects from the original MOS syntax:<\/p>\n
\n- Labels have to start at column 1, so lines with labels cannot have any leading whitespace. But it is still legal for statements to also start on column 1: The assembler can tell them apart, since all mnemos are reserved keywords, which can’t be used as labels.<\/li>\n
- The
.OPT<\/code> directive is not supported. Several of the options are supported through dedicated directives though. See below.<\/li>\n<\/ul>\nDifferences to Updated Resident Assembler<\/h2>\n
The syntax of both the Resident Assembler and the BSO cross-assembler are based on the original MOS syntax, but some features that are supported by later versions of both have diverged.<\/p>\n
Include Syntax<\/h3>\n
The Resident Assembler uses the .LIB<\/code> directive to include source files. The BSO assembler uses the .INCLUDE<\/code> directive:<\/p>\n.include disclaimer\n<\/code><\/pre>\nMacro Syntax<\/h3>\n
Macros for the BSO assembler look like this:<\/p>\n
dpinc .macro arg ;double precision increment\n inc arg\n bne 1$\n inc arg+1\n1$ .endm\n<\/code><\/pre>\nThe name of the macro is defined as a label. Arguments can be any string of characters after the .MACRO<\/code> directive, and are blindly searched and replaced in the macro’s body. .ENDM<\/code> marks the end of the body.<\/p>\nConditional Assembly Syntax<\/h3>\n
Conditional assembly on the BSO assembler uses an .IF<\/code>\/.ELSE<\/code>\/.ENDIF<\/code> construct, like this:<\/p>\n.ifn gdebug\n jsr grbpri ;garbage debug\n.endif\n<\/code><\/pre>\nNew Features<\/h2>\n
There are a number of additional features supported by the BSO assembler compared to the original MOS assemblers.<\/p>\n
Text Format<\/h3>\n
Source files can now use the complete ASCII character set, as opposed to just uppercase. This means that comments can use mixed case and that TABs can be used for indenting.<\/p>\n
In addition, labels, statements and operands are now case insensitive. In practice, all Commodore BSO source code uses lower case for those.<\/p>\n
Local Labels<\/h3>\n
Local labels are in the form of a number from 1 to 255 followed by a $<\/code> sign, e.g.:<\/p>\n100$ ; this is legal\n001$ ; this is the same as the next\n1$ ; this is the same as the previous\n999$ ; this is illegal (1-255).\n<\/code><\/pre>\nThe range of local labels is delimited by global labels as well as the .LOCAL<\/code> directive.<\/p>\nAdditional Directives<\/h3>\n
The BSO assembler supports a number of additional directives:<\/p>\n
\n.NAME<\/code>\/.TITLE<\/code>: set name of project<\/li>\n.SUBTTL<\/code>: set name of section (like .PAGE<\/code> on MOS)<\/li>\n.SKIP<\/code>\/.SPACE<\/code>: skip lines in LST<\/li>\n.FORMLN<\/code>: set number of lines per page<\/li>\n.LIST<\/code>\/.NLIST<\/code>: enable\/disable LST (like .OPT LIST<\/code>)<\/li>\n.CLIST<\/code>\/.NCLIST<\/code>: show\/hide disabled conditional assembly in LST<\/li>\n.MLIST<\/code>\/.NMLIST<\/code>\/.BLIST<\/code>: control macro expansions in LST<\/li>\n.GEN<\/code>\/.NOGEN<\/code>: enable\/disable extra lines in LST (like .OPT GENERATE<\/code>)<\/li>\n.INCLUDE<\/code>: include file<\/li>\n.MACRO<\/code>\/.ENDM<\/code>: macro definition (existed on MOS, but different syntax)<\/li>\n.REPT<\/code>\/.ENDR<\/code>: repeat<\/li>\n.IRP<\/code>\/.IRPC<\/code>: extended repeat<\/li>\n.IFE<\/code> conditional assembly if == 0 (existed on MOS, but different syntax)<\/li>\n.IFN<\/code>\/.IF<\/code> conditional assembly if != 0 (existed on MOS, but different syntax)<\/li>\n.IFGE<\/code> conditional assembly if is >= 0<\/li>\n.IFGT<\/code> conditional assembly if is > 0<\/li>\n.IFLT<\/code> conditional assembly if is < 0<\/li>\n.IFLE<\/code> conditional assembly if is =< 0<\/li>\n.IFB<\/code>\/.IFNB<\/code> conditional assembly if (not) blank<\/li>\n.IFIDN<\/code>\/.IFNIDN<\/code> conditional assembly if strings are (not) identical<\/li>\n.IFDEF<\/code>\/.IFNDEF<\/code> conditional assembly if symbol is (not) defined<\/li>\n.LOCAL<\/code>: delimit the range of local labels<\/li>\n.MESSG<\/code>: print message during pass 2<\/li>\n.RMB<\/code>: reserve memory byte<\/li>\n.RADIX<\/code>: change default radix for literals without a prefix<\/li>\n<\/ul>\nAll these features are also documented<\/a> in the “Commodore 128 Developer’s Package”, which cloned the BSO assembler for the C128. (More details in part 4 of the series.)<\/p>\nRelocating<\/h3>\n
It was possible to create relocatable object files with the BSO assembler. Commodore never made use of this feature. The following directives control this:<\/p>\n
\n.AORG<\/code>\/.RORG<\/code>\/.ZORG<\/code><\/li>\n.SECT<\/code>\/.ASECT<\/code>\/.RSECT<\/code>\/.ZSECT<\/code><\/li>\n.EXTERN<\/code>\/.INTERN<\/code><\/li>\n.LINK<\/code><\/li>\n<\/ul>\nLST Files<\/h3>\n
Listing files had an updated format. Here is an example:<\/p>\n
1581 DOS v10 318045-01 (c)1987 CBM CR6502\/11 version 20.53.12 19-Mar-87 20:17:11 Page 26\n\"copy\" COPY.SRC\n\nError Addr Code Seq Source statement\n\n 1755 ; copy file(s) to one file\n 1756\n 87A2 20 82B9 1757 copy jsr lookup ; look ip all files\n 87A5 AD 022F 1758 lda f2cnt\n<\/code><\/pre>\nThe header distinguishes between the project name (.NAME<\/code>, first field of first line), the section name (.SUBTTL<\/code>, first field of second line) and the filename (second field of second line), and contains the assembler’s name and the current date.<\/p>\nThe body lines have a new first column that can contain one or more characters that indicate errors in the line, e.g. U<\/code> for undefined symbol. This is instead of added lines with error messages.<\/p>\nUse at Commodore<\/h2>\n
From the headers of the Commodore LST that have been preserved, we can see that Commodore was using at least the following versions:<\/p>\n
\n- version 10.36.6 since at least July 1984 (TED KERNAL and Char ROM)<\/li>\n
- version 20.51.10 since at least August 1984 (TED BASIC, 1570, original C128 ROM)<\/li>\n
- version 20.53.12 since at least December 1985 until July 1990 (later C128 ROM, 1551, later 1541\/1541C\/1541-II, 1571, 1571CR, 1581, C64GS)<\/li>\n<\/ul>\n
CY6502 was available for VAX\/VMS and PDP-11 systems. Everything points towards Commodore using VAX hardware. The original C128 source archive<\/a> contains a VAX reference dated October 1984 (file monitor.sum<\/code>). A different file (c65.doc<\/code>) in the C128 source archive mentions that the C128 ROM was developed on a VAX-8600 (12.5 MHz, 4+ MB RAM; released in October 1984).<\/p>\nAccording to a usenet post to net.micro.cbm<\/a> from December 1985, Commodore had multiple VAX systems at least as early as December 1985:<\/p>\n\n[…] which consists of the cbmvax 11\/750 and a host of VMS Vaxen, Sun’s and developmental systems at both Commodore and Commodore [Amiga].<\/p>\n<\/blockquote>\n
(cbmvax<\/code> was the UUCP-connected machine at Commodore. Usenet identifiers and (later) email addresses of Commodore employees contained this machine name.)<\/p>\nAnother document (howto.doc<\/code>) in the source archive describes how the result was transferred from the VAX to the Commodore computer: VAX computers were multi-user, and each developer had their own VT100-like terminal connected through RS-232. Each terminal had a second AUX\/printer RS-232 connection that was connected to the Commodore computer (at 9600 baud if it had an ACIA chip). The tool “DOWNLOAD” on the VAX then sent the contents of the OBJ file through the terminal to the Commodore computer, which used a tool named “RSX” to receive the data.<\/p>\nThe next article<\/a> will discuss the HDC65 assembler on C128 that Commodore built in 1986 as a clone of the BSO assembler.<\/p>\n<\/p>\n
\n\n- \n
The BSO 6502 cross-assembler seems to have many names. The 1976 documentation called it CA6500: Back then, the 6502 was part of the 6500-series that consisted of the 6501 and the 6502. The version Commodore used 8 years later was called CY6502 in the documentation, but in LST files, it called itself CR6502\/11: The “11” must have stood for either PDP-11 or VAX-11, or both. The “R” could stand for “relocatable”, which seemed to have been a recent feature.↩<\/a><\/p>\n<\/li>\n<\/ol>\n<\/div>\n","protected":false},"excerpt":{"rendered":"In the series about the assemblers Commodore used for developing the ROMs of their 8-bit computers, this article covers the 1984 “Boston Systems Office” (BSO) cross-assembler running on VAX\/VMS. 6502 relocating cross assembler version 20.53.12 Copyright, The Boston Systems Office, Inc. 1978 (617) 894-7800 TWX: 710-324-0760 Type \/H for help Series Overview Part 0:\u00a0Overview Part … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,8],"tags":[],"class_list":["post-1538","post","type-post","status-publish","format-standard","hentry","category-2","category-commodore"],"_links":{"self":[{"href":"https:\/\/www.pagetable.com\/index.php?rest_route=\/wp\/v2\/posts\/1538","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.pagetable.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.pagetable.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.pagetable.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.pagetable.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1538"}],"version-history":[{"count":0,"href":"https:\/\/www.pagetable.com\/index.php?rest_route=\/wp\/v2\/posts\/1538\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.pagetable.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1538"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.pagetable.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1538"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.pagetable.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1538"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}