diff --git a/atari.pal b/atari.pal deleted file mode 100644 index c22f5bc..0000000 Binary files a/atari.pal and /dev/null differ diff --git a/changes.txt b/changes.txt deleted file mode 100644 index df4cb2d..0000000 --- a/changes.txt +++ /dev/null @@ -1,34 +0,0 @@ -Version 2.1 -=========== -- ICL-in-last-line bug fixed -- now 1 rather than -1 is true -- line repeating -- op-code extracting -- Unix and Atari eols support - -Version 2.0 -=========== -- truncating name of object bug fixed -- EQU & DTA forward reference bugs fixed -- hex number recognizing bug fixed -- now .OBX is default extension for Atari executables -- assembling options (switches and OPT directive) -- listing generation -- label table generation -- conditional assembling -- user errors -- warnings -- improved headers generation -- improved expressions - 19 operators and brackets, 32-bit arithmetic -- improved signed numbers -- 6 new pseudo commands (memory-to-memory move) -- 8 pseudo addressing modes -- indirect conditional jumps -- Atari floating-point numbers generation -- improved INS: inserting specified part of file - -Version 1.2 -=========== -- first release - -=== \ No newline at end of file diff --git a/dlist.txt b/dlist.txt deleted file mode 100644 index de958ad..0000000 --- a/dlist.txt +++ /dev/null @@ -1,61 +0,0 @@ -Display List op-codes -===================== - -Blank lines ------------ -$00 - 1 blank line -$10 - 2 blank lines -$20 - 3 blank lines -$30 - 4 blank lines -$40 - 5 blank lines -$50 - 6 blank lines -$60 - 7 blank lines -$70 - 8 blank lines - -Jumps ------ -$01 $ll $hh - JMP $hhll - Jump & generate 1 blank line -$41 $ll $hh - JVB $hhll - Jump after vertical blank - -Modes ------ -Most popular combinations of ANTIC modes with GTIA modes: - -ANTIC mode | GTIA mode | OS mode | screen | font | bytes/line ----------------------------------------------------------------------- - $2 | %00 | $0 | 40* 30* 2 | 128*8*8* 2 | 40 - $2 | %01 | - | 40* 30*16 | 128*2*8*16 | 40 - $2 | %10 | - | 40* 30* 9 | 128*2*8* 9 | 40 - $2 | %11 | - | 40* 30*16 | 128*2*8*16 | 40 - $3 | %00 | - | 40* 24* 2 | 128*8*8* 2 | 40 - $4 | %00 | $c | 40* 30* 5 | 128*4*8* 4 | 40 - $5 | %00 | $d | 40* 15* 5 | 128*4*8* 4 | 40 - $6 | %00 | $1 | 20* 30* 5 | 64*8*8* 2 | 20 - $7 | %00 | $3 | 20* 15* 5 | 64*8*8* 2 | 20 - $8 | %00 | $3 | 40* 30* 4 | - | 10 - $9 | %00 | $4 | 80* 60* 2 | - | 10 - $a | %00 | $5 | 80* 60* 4 | - | 20 - $b | %00 | $6 | 160*120* 2 | - | 20 - $c | %00 | $e | 160*240* 2 | - | 20 - $d | %00 | $7 | 160*120* 4 | - | 40 - $e | %00 | $f | 160*240* 4 | - | 40 - $f | %00 | $8 | 320*240* 2 | - | 40 - $f | %01 | $9 | 80*240*16 | - | 40 - $f | %10 | $a | 80*240* 9 | - | 40 - $f | %11 | $b | 80*240*16 | - | 40 - -screen: columns*rows*colors - font: chars*sizex*sizey*colors - -+$10 - Horizontal Scroll -+$20 - Vertical Scroll -+$40 $ll $hh - Load Screen Pointer $hhll - -For all op-codes ----------------- -+$80 - Display List Interrupt after getting all data for this line - -When placing Display List in memory, remember it cannot cross 1 kB boundary. -Similarly, screen memory cannot cross 4 kB boundary. - -=== \ No newline at end of file diff --git a/doc/6502proc.gif b/doc/6502proc.gif new file mode 100644 index 0000000..bfa3cc0 Binary files /dev/null and b/doc/6502proc.gif differ diff --git a/cpubugs.asx b/doc/cpubugs.asx similarity index 83% rename from cpubugs.asx rename to doc/cpubugs.asx index 0509487..d78fe8d 100644 --- a/cpubugs.asx +++ b/doc/cpubugs.asx @@ -1,4 +1,4 @@ -* This program examines 6502 bugs! +* This program detects 6502 bugs. * Please read text after program first. icmd equ $342 @@ -21,7 +21,7 @@ start lda #11 Clear screen lda #$99 BCD 99+01=00 add #1 cld - beq *+4 Z flag set: no bug + seq Z flag set: no bug lda #$ff ldx 0: X=*|$ff Program should fit on one page + ert *>start|$ff Program should fit on one page org *|$ff jmpptr dta a(jmp1) @@ -86,7 +85,7 @@ jmp1 lda #0 JMP bug not detected run start end -The program above checks 3 bugs: +The program above detects 3 bugs: - 'ADC bug' Flags N,V,Z are not properly set after ADC or SBC in decimal mode. You can't rely on these flags after BCD operation. @@ -95,8 +94,6 @@ If an interrupt occurs on a BRK, it is executed with BRK-like values on stack. This means a BRK is simply passed-by if a NMI occurs. Beware of using BRK with other interrupts. - 'JMP bug' - JMP ($xxff) fetches address from $xxff and $xx00. -X-Asm 2.0 warns you of using such a jump. +X-Asm warns you of using such a jump. All these bugs are supposedly fixed in CMOS chips. - -=== diff --git a/doc/gr0.htm b/doc/gr0.htm new file mode 100644 index 0000000..f732074 --- /dev/null +++ b/doc/gr0.htm @@ -0,0 +1,51 @@ + + +GR0 1.1 Manual + + +
+

GR0 version 1.1

+by Fox/Taquart

+

+
+ +

INTRODUCTION

+GR0 is a simple tool that can change colors and font of DOS screen. +It can setup it to look similar to Atari text mode. +

CHANGES

+

Version 1.1

+ + +
+

USAGE

+You can run GR0 without any parameters to see available options. They are: +
+
/a +
Set Atari scheme. It is equivalent to options /b:1 /c:7 /n /l /x

+

/b:nn +
Set background color nn, where nn is decimal number of range 0-15

+

/c:nn +
Set foreground (letters) color nn, where nn is decimal number of range 0-15

+

/d +
Set default PC font. Resets all characters.

+

/f:fname +
Set external Atari font. Reads characters 0-127 from standard Atari font file +(8*8*128). In 25 lines mode, font is resized. Default extension .FNT will be added +to filename, if none given.

+

/i +
Set characters 128-255 to inverse of 0-127. +/i can only be used with /a, /f or /x.

+

/l +
Select 50 lines font. Without this option, 25 lines font is selected.

+

/n +
Initialize text mode. Clears screen and restores default font and colors.

+

/x +
Set Atari built-in font. Sets characters 0-127 to standard Atari font. +It looks better with /l option.

+

+In Windows, font changes only in full-screen mode. Colors and number of lines change +also in a window. + + \ No newline at end of file diff --git a/doc/gtia.htm b/doc/gtia.htm new file mode 100644 index 0000000..aa6d80f --- /dev/null +++ b/doc/gtia.htm @@ -0,0 +1,221 @@ + + +GTIA Documentation + + +
+

GTIA Documentation

+by Fox/Taquart

+

+

+

Registers

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
 Address  Read register  Write register  Address  Read register  Write register 
^00KOLM0PFHPOSP0^10TRIG0GRAFP3
^01KOLM1PFHPOSP1^11TRIG1GRAFPM
^02KOLM2PFHPOSP2^12unusedCOLPM0
^03KOLM3PFHPOSP3^13TRIG3COLPM1
^04KOLP0PFHPOSM0^14PALCOLPM2
^05KOLP1PFHPOSM1^15unusedCOLPM3
^06KOLP2PFHPOSM2^16unusedCOLPF0
^07KOLP3PFHPOSM3^17unusedCOLPF1
^08KOLM0PSIZEP0^18unusedCOLPF2
^09KOLM1PSIZEP1^19unusedCOLPF3
^0AKOLM2PSIZEP2^1AunusedCOLBAK
^0BKOLM3PSIZEP3^1BunusedGTIACTL
^0CKOLP0PSIZEM^1CunusedVDELAY
^0DKOLP1PGRAFP0^1DunusedPMCNTL
^0EKOLP2PGRAFP1^1EunusedHITCLR
^0FKOLP3PGRAFP2^1FCONSOLCONSOL
+

+

+

+

Description

+
+ +COLBAK +- Color of background
+bit 0 - unused
+bits 3-1 - luminace
+bits 7-4 - hue

+ +COLPF0 COLPF1 COLPF2 COLPF3 +- Colors of player field
+bit 0 - unused
+bits 3-1 - luminace
+bits 7-4 - hue

+ +COLPM0 COLPM1 COLPM2 COLPM3 +- Colors of players and missiles
+bit 0 - unused
+bits 3-1 - luminace
+bits 7-4 - hue

+ +CONSOL +- Consol keys
+This is the only read/write register in GTIA. +Value written is negated on read. Bits 0-2 are ANDed +with keys status. Reset bit means key pressed.
+bit 0 - START key
+bit 1 - SELECT key
+bit 2 - OPTION key
+bit 3 - click sound
+bits 4-7 - unused (=0)

+ +GRAFM +- Graphics of missiles
+bits 1,0 - graphics of missile 0
+bits 3,2 - graphics of missile 1
+bits 5,4 - graphics of missile 2
+bits 7,6 - graphics of missile 3

+ +GRAFP0 GRAFP1 GRAFP2 GRAFP3 +- Graphics of players

+ +GTIACTL +- GTIA control
+bits 3-0 - priorities of players and missiles
+0001 - P0, P1, P2, P3, PF0, PF1, PF2, PF3, BAK
+0010 - P0, P1, PF0, PF1, PF2, PF3, P2, P3, BAK
+0100 - PF0, PF1, PF2, PF3, P0, P1, P2, P3, BAK
+1000 - PF0, PF1, P0, P1, P2, P3, PF2, PF3, BAK
+Players/missiles and playfields are mentioned from highest to lowest priority.
+Other combinations of bits 3-0 cause strange side effects.
+bit 4 - set all missiles color to COLPF3
+bit 5 - enable ORing colors P0 with P1 and P2 with P3 on common areas
+bits 7,6 - GTIA extra graphics mode
+00 - off
+01 - 16 luminaces
+10 - 9 colors
+11 - 16 hues

+ +HITCLR +- Clear collision registers
+Any value written to this register causes collision registers to be reset.

+ +HPOSM0 HPOSM1 HPOSM2 HPOSM3 +- Horizontal positions of missiles

+ +HPOSP0 HPOSP1 HPOSP2 HPOSP3 +- Horizontal positions of players

+ +KOLM0P KOLM1P KOLM2P KOLM3P +- Collisions of missiles with players
+bit 0 - collision with player 0
+bit 1 - collision with player 1
+bit 2 - collision with player 2
+bit 3 - collision with player 3
+bits 4-7 - unused (=0)

+ +KOLM0PF KOLM1PF KOLM2PF KOLM3PF +- Collisions of missiles with playfield
+bit 0 - collision with playfield 0
+bit 1 - collision with playfield 1
+bit 2 - collision with playfield 2
+bit 3 - collision with playfield 3
+bits 4-7 - unused (=0)

+ +KOLP0P KOLP1P KOLP2P KOLP3P +- Collisions of players with players
+bit 0 - collision with player 0
+bit 1 - collision with player 1
+bit 2 - collision with player 2
+bit 3 - collision with player 3
+bits 4-7 - unused (=0)

+ +KOLP0PF KOLP1PF KOLP2PF KOLP3PF +- Collisions of players with playfield
+bit 0 - collision with playfield 0
+bit 1 - collision with playfield 1
+bit 2 - collision with playfield 2
+bit 3 - collision with playfield 3
+bits 4-7 - unused (=0)

+ +PAL +- PAL system flag
+bit 0 - unused
+bits 1-3 - 000 if TV system is PAL. Else it is NTSC
+bits 4-7 - unused (=0)

+ +PMCTL +- Player/Missile Control
+bit 0 - get missiles data from ANTIC
+bit 1 - get players data from ANTIC
+bit 2 - lock triggers when pressed
+bits 3-7 - unused

+ +SIZEM +- Sizes of missiles
+Two bits set size of each missile:
+00 - single size
+01 - double size
+10 - single size
+11 - quad size
+bits 1,0 - size of missile 0
+bits 3,2 - size of missile 1
+bits 5,4 - size of missile 2
+bits 7,6 - size of missile 3

+ +SIZEP0 SIZEP1 SIZEP2 SIZEP3 +- Sizes of players
+bits 1,0 - size of player (see SIZEM)
+bits 2-7 - unused

+ +TRIG0 TRIG1 TRIG3 +- Triggers
+TRIG0 and TRIG1 contain trigger status of two joysticks. +TRIG3 contains presence of cartridge.
+bit 0 - reset if trigger pressed
+bits 1-7 - unused (=0)

+ +VDELAY +- Vertical delay of players and missiles
+Causes players and missiles to be displayed one scanline lower. +Works only in two-line resolution.
+bit 0 - delay missile 0
+bit 1 - delay missile 1
+bit 2 - delay missile 2
+bit 3 - delay missile 3
+bit 4 - delay player 0
+bit 5 - delay player 1
+bit 6 - delay player 2
+bit 7 - delay player 3

+ + + \ No newline at end of file diff --git a/doc/index.htm b/doc/index.htm new file mode 100644 index 0000000..f1df23b --- /dev/null +++ b/doc/index.htm @@ -0,0 +1,33 @@ + + +X-ASM 2.2 Package Documentation + + +

+

X-ASM Package version 2.2

+by Fox/Taquart

+

+

+Manuals of utilities:

+ + + + + + +
X-Assembler6502 cross-assembler
X-BOOTAtari executable -> disk image converter
X-HEADSimple Atari executable analyzer
X-LOADSIO2PC interface Atari executable loader
GR0DOS screen adjuster
+

+

+

+Atari XL/XE documentation (under construction):

+ + +
GTIAGTIA chip documentation
CPUBUGS.ASX6502 bugs detector source +
+

+

+

+All programs are freeware. Copyright (c) Taquart 1999. +

+ + \ No newline at end of file diff --git a/doc/xasm.htm b/doc/xasm.htm new file mode 100644 index 0000000..f69d2df --- /dev/null +++ b/doc/xasm.htm @@ -0,0 +1,714 @@ + + +X-Assembler 2.2 Manual + + +
+

X-Assembler version 2.2

+by Fox/Taquart

+

+ +

+

INTRODUCTION + USAGE + SYNTAX + FAQ + BACK +

+The X-Assembler is an cross-assembler, which generates code for the 6502 processor. +It is 99% compatible with Quick Assembler on 8-bit Atari. +
+

CHANGES

+

Version 2.2

+ +

Version 2.0

+ +

Version 1.2

+ + +

+

INTRODUCTION + USAGE + SYNTAX + FAQ + BACK +

+ +

System requirements

+ +

Creating a source program

+Source file should be plain ASCII file. Although different EOLs are supported, +you would probably prefer CR/LF EOLs because of text editor.
+Single line of source should not be longer than 256 characters. +There is no limitation on the length of the file.
+Source may contain tabulators, which are treated as spaces.
+Assembler is not case-sensitive. +
+

Converting Quick Assembler files

+You must convert Atari text file into PC text file (EOL's from $9b to $0d/$0a), +ATASCII 0-31 and 128-255 characters should be replaced with standard ASCII +characters, using QAsm expressions.
+You also have to change all OPT directives, +but usually you needn't them at all. +
+

Assembling a source program

+You run assembler from DOS prompt with following syntax:
+
XASM source [options]
+
source is name of source file. +If no extension given, the .ASX is added by default.

+Optional options are: +

+
/c +
Enable listing false conditionals.
+By default lines skipped because of false condition are not listed.

+ +

/e +
Enable setting environment variables when error occurs.
+With this option, X-Asm sets two environment variables: ERRFILE and ERRLINE. +They may be used in a batch file to locate error and set editor on it. +For example, in my batch file I use such construction: +
XASM %1 /e
+IF NOT ERRORLEVEL 1 GOTO ok
+NCE +%ERRLINE% %ERRFILE%
+
+NCE stands for Norton Classic Editor.

+If there was no error, variables point at last warning. +If no warning occured, they are removed from the environment.

+

/i +
Disable listing included source.
+Only main source file will be listed.

+

/l[:fname] +
Enable generating listing. +If no fname given, listing is written to source.lst.

+ +

/n +
Check source and object modification times and assemble only +if source is newer than object file. X-Asm does NOT check included +nor inserted files but only main source, so be careful with this option.

+

/o:fname +
Specify object name. Default is source.obx.

+

/s +
Disable converting spaces to tabs in listing. +Using tabs makes listing file shorter.
+Tab stops are assumed to be every 8 characters.

+

/t[:fname] +
List label table. +If no fname given, table is written at the end of listing.

+

+ +If source is incorrect, X-Asm stops on first encountered error.

+ +Errorlevels returned by X-Asm:
+3 = bad parameters, assembling not started
+2 = error occured
+1 = warning(s) only
+0 = no errors, no warnings
+ +

Listing structure

+Line of listing includes: +
    +
  • decimal number of line of source file (if source is different than in +previous listed line, appropriate message line is generated) +
  • hexadecimal origin +
  • hexadecimal bytes written to object file
    +Listed are also generated headers. A xxxx-yyyy> in place of origin +represents generated header: $xxxx is the first and $yyyy +is the last byte of the block. +A FFFF> represents two $ff bytes written as a header prefix.
    +A plus sign placed after hex numbers stands for more bytes written to object +in this line, not listed through lack of space. +
  • remaining part of listing line is a copy of source line +
+ +

Label table structure

+Line of label table includes: +
    +
  • some label attributes:
    +n - label defined but not used elsewhere
    +2 - label value known in pass 2 only (label definition uses forward +reference and thus you can't do forward references to that label) +
  • hexadecimal value of the label +
  • name of the label +
+ +

 +

INTRODUCTION + USAGE + SYNTAX + FAQ + BACK +

+Lines of source code may be: + +Comment lines must have one of the following characters in the FIRST column +of the line: * ; | + +

+

Expressions  Statements

+Expressions are numbers combined with operators and brackets. +You should use square brackets, because parentheses are reserved +for 6502 indirect addressing. + +

Numbers

+Numbers are 32-bit signed integers, in the range of -$7fffffff..$7fffffff. +A number can be: + + + + + + + +
  • a decimal number
-12345
  • a hexadedecimal number
$abcd
  • a binary number
%10100101
  • an ASCII character
'a' or "a"
  • an origin counter
*
  • a hardware register
^31
+
+An abbreviation of Atari hardware register:
+^0x means $d00x
+^1x means $d01x
+^2x means $d20x
+^3x means $d30x
+^4x means $d40x
+where x is a hexadecimal digit. +
+ + + +
  • an op-code
{lda #0}
+
+Byte op-code of instruction inside braces. Operand is discarded +and is necessary only for identifying addressing mode. +Instruction should begin right after left brace and right brace should +immediately follow the operand or the command in implied addressing mode. +
+

+ +

Operators

+Currently there are 19 operators:

+ + + + + + + + + + + + + + + + + + + + + +
+ Addition
- Subtraction
* Multiplication
/ Division
% Remainder
& Bitwise and
| Bitwise or
^ Bitwise xor
<< Arithmetic shift left
>> Arithmetic shift right
= Equal
<> Not equal
!= Not equal (same as <>)
< Less than
> Greater than
<= Less or equal
>= Greater or equal
&& Logical and
|| Logical or
+

+Operator precedence: + + + + + + + +
first[]
* / % & << >>
+ - | ^
= <> != < > <= >=
&&
last ||
+

+Compare and logical operators assume that zero is false and non-zero is true. +They return 1 for true.

+When calculating expression, 32-bit arithmetic is used. When range of 32 bits +is exceeded, 'Arithmetic overflow' error is generated.

+ +

 +

Expressions  Statements

+A statement is divided into fields: + +There should be at least one space between every two fields +and there can't be any space within a field excluding strings. + +

Label field

+This field is optional. It starts from first character of line, without +any blank characters before. It has two applications: + +You can not define a label in line which you repeat.

+ + +

Operation field

+Operation field is the only field which is always required. +You have to put one or more spaces or tab characters between label +and operation field. If no label is defined, line must start with a blank +character. Operation field consists of one or two instructions. +The latter case is called instructions pairing, because a pair +of instructions have shared operand. You separate instructions +with a colon.
+Example: +
 adc:sta $80
+
is equivalent to +
 adc $80
+ sta $80
+
+Single instruction always consists of 3 letters. It can be: +
    +
  1. 6502 command
    +One of 56 well known processor commands.

    + +
  2. compiler directive
    +One of the following:

    +

    +
    EQU - assign a value of expression to the label +
    Note that label represents a number, not a text macro.
    +Examples: +
    five equ 5
+here equ *
+
    + +
    OPT - set assembling options +
    Currently there are two options: listing generating and headers generating. +You can turn any of these on or off.
    +Default (if no OPT specified) is opt l+h+.
    +Examples: +
     opt l-    listing off
+ opt h-    headers off
+ opt l+h-  listing on, headers off
+
    + +
    ORG - set new origin counter +
    You can set some options applied to new header (if headers are on): +
      +
    • a: tells X-Asm to always make a header, even it is unnecessary, +like in ORG *. +
    • f: works same as a:, but additionally tells to generate +a $ff,$ff prefix before header. X-Asm adds it to the first header in file +by default, so use this option only if you want the $ff's somewhere inside.
      +
    +Examples: +
     org $600
+ org f:$700
+table org *+100
+
    +In the latter example table points to 100 bytes +of uninitialized data (note label is assigned to * +before ORG directive is executed).

    + +

    DTA - define data +
    There are various data types: +
      +
    • numbers +
        +
      • bytes: b(200) +
      • words: a(10000) +
      • low bytes of words: l(511) defines byte 255 +
      • high bytes of words: h(511) defines byte 1
        +You may enter many expressions in parentheses and combine different types +of data in single line, separating things with commas.
        +You may also define a sinus table. Syntax is:
        +sin(centre,amp,size,first,last)
        +where: +
          +
        • centre is a number which is added to every sinus value +
        • amp is the amplitude of sinus +
        • size is the period of sinus +
        • first,last define range of values in the table. +They are optional. Default are 0,size-1. +
        +Example: dta a(sin(0,1000,256,0,63)) defines table of 64 words +representing a quarter of sinus with amplitude of 1000.

        +

      • real numbers: r(-1.23456e12)
        +Real numbers are written in 6-byte Atari Floating-Point format. You can't +combine reals with operators, as you can integers.

        +

      +
    • text strings +
        +
      • ASCII strings: c'Text' or c"Text" +
      • ANTIC strings: d'Text' or d"Text" +
      +A character string consists of any of characters surrounded by quotation +marks. Within a string, a single quotation mark character is +represented by two succesive quotation marks.
      +Placing a * character after a string inverts +high bit in every byte of string.

      +

    +Examples of DTA: +
    + dta b(2,5),a(1000,-1),l(12345,sin(0,127,256))
+ dta d"ANTIC"*,c'It''s a string',b(155)
+
    + +
    ICL - include another source file +
    Specifies another file to be included in the assembly as if the contests of +the referenced file appeared in place of the ICL statement. +The included file may contain other ICL statements. +The .ASX extension is added if none given.

    +Examples: +

    + icl 'macros.asx'
+ icl 'c:\atari\xasm\fileio'
+
    + +
    END - end assembling file +
    Remaining part of the file is not assembled. If this statement does +not occur, assembler stops assembling when encounters end of file.
    +Example: +
    + end
+
    + +
    INS - insert contents of file +
    Copies every byte of specified file into object file and moves origin +counter, as if these bytes were defined with DTA.
    +You may specify range of inserted file. Syntax is: +
    + ins 'file'[,offset[,length]]
+
    +First byte in file has offset 0.
    +If offset is negative, it is counted from the end of file.
    +Examples: +
    + ins 'picture.raw'
+ ins 'file',-256   insert last 256 bytes of file
+ ins 'file',10,10  insert bytes 10..19 of file
+
    + +
    RUN - generate run address +
    The Atari executable program should have run address specified. +A program may be loaded in many areas of memory and started from any address. +
     run addr
+
    +is equivalent to: +
     org $2e0
+ dta a(addr)
+
    +Examples: +
     run start
+ run program
+
    + +
    INI - generate init address +
    The Atari executable program may have some routines which are executed +during loading process. There may be many init blocks in one file.
    +Examples: +
     ini init
+ ini showpic
+
    + +
    ERT - generate error if expression is true +
    Examples: +
     ert *>$c000
+ ert len1>$ff||len2>$ff
+
    + +
    IFT - assemble if expression is true
    +ELS - else
    +EIF - end if
    +
    With these directives you can construct fragments which +are assembled when a condition is met. +Conditional constructions can be nested.
    +Example: +
    noscr equ 1
+ ift noscr
+ lda #0
+ els
+ lda #$22
+ eif
+ sta $22f
+
    +Above example can be rewritten using line repeating feature: +
    noscr equ 1
+:noscr<>0 lda #0
+:noscr=0 lda #$22
+ sta $22f
+
    + +
    +
  3. pseudo-command
    +It is something like built-in macro. +Note that it is not an illegal instruction and works on typical 6502.

    +

    +
    ADD - addition without carry +
    If you ever programmed 6502, you must have noticed that you had +to use a CLC before ADC for every simple addition.
    +X-Asm can do it for you. ADD replaces two instructions: +CLC and ADC.

    + +

    SUB - subtraction +
    It is SEC and SBC.

    + + +

    RCC, RCS, REQ, RMI, RNE, RPL, RVC, RVS - conditional repeat +
    They are branches to the previous instruction. +They take no operand, because the branch target +is the address of previously assembled instruction.
    +Example: +
     ldx #0
+ mva:rne $500,x $600,x+
+
    +The example code copies memory $500-$5ff to $600-$6ff. +With standard 6502 commands only it would be: +
     ldx #0
+loop lda $500,x
+ sta $600,x
+ inx
+ bne loop
+
    + +
    SCC, SCS, SEQ, SMI, SNE, SPL, SVC, SVS - conditional skip +
    They are branches over the next instructions. No operand is required, +because the target is the address of instruction following +the next instruction.
    +Example: +
     lda #40
+ add:sta $80
+ scc:inc $81
+
    +In the above example word variable $80 is incremented by 40.
    +Nor conditional repeat nor skip pseudo-commands require operand, +thus they can be paired with any other command.

    + +

    JCC, JCS, JEQ, JMI, JNE, JPL, JVC, JVS - conditional jumps +
    They are a kind of 'long' branches. While standard branches +(BNE, BEQ) have range of -128..+127, these jumps have range +of all 64 kB.
    +Example: +
     jne dest
+
    is equivalent to: +
     seq:jmp dest
+
    + +
    INW - increment word +
    It is a 16-bit memory increment command.
    +Example: +
     inw dest
+
    is equivalent to: +
     inc dest
+ sne:inc dest+1
+
    + +
    MVA, MVX, MVY - move byte using accumulator, X or Y +
    Any of these pseudo-commands requires two operands +and substitutes two commands: +
     mva source dest = lda source : sta dest
+ mvx source dest = ldx source : stx dest
+ mvy source dest = ldy source : sty dest
+
    + +
    MWA, MWX, MWY - move word using accumulator, X or Y +
    They also require two operands +and are combinations of two MV*'s: +one to move low byte, and the other to move high byte.
    +You can't use indirect nor pseudo addressing modes with MW*. +Destination must be absolute address (indexed or not).
    +When source is also absolute, a MW* SOURCE DEST will be: +
     mv* source   dest
+ mv* source+1 dest+1
+
    +When source is immediate, a MW* #IMMED DEST will be: +
     mv* <immed dest
+ mv* >immed dest+1
+
    +When <immed equals >immed and immed +is not forward-referenced, X-Asm uses optimization: +
     mv* <immed dest
+ st* dest+1
+
    +
    +
+ +

Operand

+It depends on the operation field. Some statements don't need any operand, +other need two operands.

+ +6502 commands require operand depending on the addressing mode. +Addressing modes should be entered in standard convention except +the accumulator addressing mode, which should be marked with a +@ character (as in Quick Assembler).

+ +There are two extra immediate addressing modes: +< and >, +which use low/high byte of word rather than byte value.

+ +In absolute addressing modes, X-Asm examines expression and uses zero-page +addressing mode if it thinks it is possible to do it. You may override it +with a: and z: prefixes.

+ +Examples: +

+ nop
+ asl @
+ lda >$1234	assembles to lda #$12
+ lda $100,x
+ lda a:0	generates 16-bit address
+ jmp ($0a)
+ lda ($80),y
+
+ +There are also pseudo addressing modes, which are similar to +pseudo-commands. You may use them as standard addressing modes +in all 6502 commands and pseudo-commands excluding +MWA, MWX and MWY only: +
 cmd a,x+    =  cmd a,x   : inx
+ cmd a,x-    =  cmd a,x   : dex
+ cmd a,y+    =  cmd a,y   : iny
+ cmd a,y-    =  cmd a,y   : dey
+ cmd (z),y+  =  cmd (z),y : iny
+ cmd (z),y-  =  cmd (z),y : dey
+ cmd (z,0)   =  ldx #0    : cmd (z,x)
+ cmd (z),0   =  ldy #0    : cmd (z),y
+ cmd (z),0+  =  ldy #0    : cmd (z),y : iny
+ cmd (z),0-  =  ldy #0    : cmd (z),y : dey
+
+ +

Comment

+Comment in a statement does not start from any special character +like ; for example. Comment field is implied when appropriate +number of operands was taken.

+ +

 +

INTRODUCTION + USAGE + SYNTAX + FAQ + BACK +

+ + + \ No newline at end of file diff --git a/doc/xboot.htm b/doc/xboot.htm new file mode 100644 index 0000000..8c590ea --- /dev/null +++ b/doc/xboot.htm @@ -0,0 +1,68 @@ + + +X-BOOT 4.0 Manual + + +
+

X-BOOT version 4.0

+by Fox/Taquart

+

+
+ +

INTRODUCTION

+This tool converts Atari executable file (.OBX) into Atari disk image (.ATR), +which can be used in emulator. For loading executable into real Atari +you need no .ATR, try using X-LOAD. +

CHANGES

+

Version 4.0

+ +

Version 3.2

+ +

Version 3.1

+ + +
+

USAGE

+There are two ways of running X-BOOT: + +The former converts single file, the latter a set of files.

+Parameters in brackets are optional.

+/p switch forces writing 'professional loader', which allows you to load +code/data under ROM and disables ROM and interrupts while starting program. +By default, standard loader is used, which can load any Atari executable +not demanding DOS or any special loader.

+Both loaders disable Atari Basic, so you needn't hold OPTION key while +booting.

+ +

+

DETAILS

+Produced ATR is single density and as short as possible. +Loader occupies one boot sector.

+X-BOOT does not write executable in ATR as Atari file. +You can't read it from DOS or extract it somehow or other. +You can only run it by booting.

+For more details, view sources of loaders: +

+Loaders are so simple that they even do not detect end of file. Instead, +they are modified when end of file is reached: disk image contains one +additional block, which doesn't belong to executable file, but changes +loader to run program instead of initializing. + + \ No newline at end of file diff --git a/doc/xbootpro.asx b/doc/xbootpro.asx new file mode 100644 index 0000000..cafce0d --- /dev/null +++ b/doc/xbootpro.asx @@ -0,0 +1,64 @@ +* Boot executable file loader coded by Fox/Taquart +* Reads file from ATR prepared with X-BOOT. +* Professional version - can load file under ROM. +* Interrupts and ROM are disabled when running loaded program. + + opt h- + org $480 + +bufr equ $400 128-byte buffer + +tp equ $43 Temporary byte +vc equ $44 Start and end vectors (4 bytes) + +* Boot code +boot dta b(0,1),a(boot,$e477) Boot header + mva #0 $22f Make screen blank... + mva #$52 $2c8 ... and pink ;) + lda 20 Wait for VBLK + cmp:req 20 + mwa #rts $2e0 Set default run vector + dta b({lda a:0}) Skip two bytes +secrts sec Return with error +rts rts + mva:pha >rts $2e3 Set init address... + mva:pha boot+$80 Exactly 128 bytes should be used + +* X-BOOT adds this block at the end of loaded file +* It changes jmp ($2e2) to jmp ($2e0) + opt h+ + org init+1 + dta l($2e0) + + end \ No newline at end of file diff --git a/doc/xbootstd.asx b/doc/xbootstd.asx new file mode 100644 index 0000000..d5e4309 --- /dev/null +++ b/doc/xbootstd.asx @@ -0,0 +1,63 @@ +* Boot executable file loader coded by Fox/Taquart +* Reads file from ATR prepared with X-BOOT. +* Standard loader - ROM and interrupts enabled. + + opt h- + org $780 + +bufr equ $700 128-byte buffer + +tp equ $43 Temporary byte +vc equ $44 Start and end vectors (4 bytes) + +* Boot code +boot dta b(0,1),a(boot,$e477) Boot header +txtpos equ 215 + ldy #txtpos Print text +print mva text-txtpos,y ($58),y+ + cpy #txtpos+txtlen + bcc print + mwa #rts $2e0 Set default run vector + mva >bufr $305 Set buffer address + mva #$ff ^31 Turn BASIC off + dta b({lda a:0}) Skip two bytes +secrts sec Return with error +rts rts + mva:pha >rts $2e3 Set init address... + mva:pha boot+$80 Exactly 128 bytes should be used + +* X-BOOT adds this block at the end of loaded file +* It changes jmp ($2e2) to jmp ($2e0) + opt h+ + org init+1 + dta l($2e0) + + end \ No newline at end of file diff --git a/doc/xhead.htm b/doc/xhead.htm new file mode 100644 index 0000000..6cc855f --- /dev/null +++ b/doc/xhead.htm @@ -0,0 +1,42 @@ + + +X-HEAD 1.1 Manual + + +
+

X-HEAD version 1.1

+by Fox/Taquart

+

+
+ +

INTRODUCTION

+This tool prints headers of Atari executable. +You can examine which memory locations file loads into. +X-HEAD also shows init and run addresses. +

CHANGES

+

Version 1.1

+
    +
  • .OBX is default extension of Atari executable +
+

Version 1.0

+
    +
  • first release +
+ +
+

USAGE

+Simply run X-HEAD with executable filename. No options are supported yet.

+X-HEAD will read the file and display its headers in following format: +

 bbbb-eeee xxxx
+where bbbb is the begin, eeee - the end of the block, +and xxxx is the execution address (init or run vector).

+The summary includes:
+xxxx bytes - length of file, including headers
+xxxx blocks - number of headers
+xxxx inits - number of init blocks (02e2-02e3)
+xxxx modules - number of FFFF headers (one at the beginning is required)

+All displayed numbers are hexadecimal, of course.

+You can redirect output to a file, for example: +

XHEAD TEST >TEST.HDR
+
+
\ No newline at end of file
diff --git a/doc/xload.htm b/doc/xload.htm
new file mode 100644
index 0000000..8f2c4ba
--- /dev/null
+++ b/doc/xload.htm
@@ -0,0 +1,81 @@
+
+
+X-LOAD 1.0 Manual
+
+
+

+
X-LOAD version 1.0

+by Fox/Taquart

+

+

+
+
INTRODUCTION

+This tool can be used for loading executable files from PC into real
+Atari computer via SIO2PC interface. Only input and output lines are
+used, so that X-LOAD should work with all types of interface.

+However, it is experimental version. I'm not sure if it will work
+with every hardware. I've noticed it is not stable and sometimes
+transmission can hang or distortions in loaded data may appear.
+The reason is that there is no error-checking, while transmission is
+fast (57.6 kbits/sec).

+
CHANGES

+
Version 1.0

+
    
+
  •  first release
+

+
+

+
USAGE

+You run X-LOAD from DOS prompt with executable filename and optional
+options:

+

+
/1 - /4
+
Specify COM port number, which interface is attached to.
+Default is COM2.

+
/p
+
Force using 'professional loader', which allows you to load
+code/data under ROM and disables ROM and interrupts while starting program.
+By default, standard loader is used, which can load any Atari executable
+not demanding DOS or any special loader.

+

+After you run X-LOAD, you only have to boot your Atari and the program
+will be loaded and run.

+While loading, you can watch on your PC memory locations, which program
+loads to.

+After program was loaded and run, X-LOAD terminates. You may exit it
+earlier at any time by pressing ESC key.

+
+

+
DETAILS

+First X-LOAD sends a byte to Atari and then waits until Atari is booted.
+That byte can be used to detect from Atari, that PC is ready for transmission.
+When you are testing your program, you may code periodic checking
+if a byte was received, and performing cold reset in that case.
+So that you needn't touch your Atari to run program on it.

+While booting, X-LOAD accepts two commands for disk drive 1:

+
    
+
  •  'S' - read status. Used for checking presence of disk drive.
+
  •  'R' - read sector (only first). Used for reading boot program.
+

+After Atari receives and runs its loader, the transmission runs at 57600
+bits/sec. You can not hear any transmission sound, because the frequency
+is too high for a human.

+Transmission protocol is very simple: Atari sends a byte to inform that
+it is ready for receiving data. Then PC sends a 3-byte header and a block
+of data. First two bytes of header are high and low byte of address
+of last block byte minus $ff. Third byte equals low byte of
+($100-block_length). Then come block data, which are loaded directly
+into their memory location.
+For more details, view sources of loaders:
+

+You may have noticed that X-LOAD is somehow similar to X-BOOT, which also
+has two loaders. The main difference is that X-BOOT loaders use system
+routines to get sectors at regular speed of 19200 bits/sec.
+They use sector buffer and require some low memory locations not to be changed
+because of operating system. In this respect X-LOAD loaders are better, because
+allow loading into whole memory except for loader code.
+
+
\ No newline at end of file
diff --git a/doc/xloadpro.asx b/doc/xloadpro.asx
new file mode 100644
index 0000000..c86a7e4
--- /dev/null
+++ b/doc/xloadpro.asx
@@ -0,0 +1,60 @@
+* Boot executable file loader coded by Fox/Taquart
+* Receives file from X-LOAD via SIO2PC interface.
+* Professional version - can load file under ROM.
+* Interrupts and ROM are disabled when running loaded program.
+
+	opt	h-
+	org	$400
+
+* Boot code
+boot	dta	b(0,1),a(boot)	Boot header
+arts	dta	a(rts)
+
+	dta	b({lda #$60})	Skip rts
+rts	rts
+
+	sei			Disable interrupts
+	inc	^4e
+	inc	^40		Make screen blank
+	mva	#$08	^24	Set transmission speed
+	mva	#$00	^26
+	mva	#$28	^28
+	sta	^29		Reset counters
+	mva	#$23	^2f	Send enable
+	sta	^2d		Send a byte
+wait	sta	^4a		Wait until sent
+	asl	@
+	bcc	wait
+	mva	#$13	^2f	Receive enable
+	ldy	#2
+head	jsr	get		Receive address (high/low byte)
+	sta	stor,y
+	mva	arts-1,y	$2e2-1,y	Set init address
+	pha			Put return address on stack
+	dey
+	bne	head
+	jsr	get		Receive length (one byte)
+	tax
+load	jsr	get		Receive data
+stor	sta	a:0,x+		Store in memory
+	bne	load
+	mva	$10	^2e	Reset POKEY
+	mva	#3	^2f
+init	jmp	($2e2)		Call init routine
+
+get	lda	#$20		Function: Receive one byte
+	sta	^2e		Enable receive interrupt
+	bit:rne	^2e		Wait for interrupt request
+	sty	^2e		Disable receive interrupt
+	lda	^2d		Get byte
+	rts
+
+:boot+$80-*	dta	b(0)	Padd with zeros to full sector
+
+* X-LOAD adds this block at the end of loaded file
+* It changes jmp ($2e2) to jmp ($2e0)
+	opt	h+
+	org	init+1
+	dta	l($2e0)
+
+	end
\ No newline at end of file
diff --git a/doc/xloadstd.asx b/doc/xloadstd.asx
new file mode 100644
index 0000000..258e18d
--- /dev/null
+++ b/doc/xloadstd.asx
@@ -0,0 +1,60 @@
+* Boot executable file loader coded by Fox/Taquart
+* Receives file from X-LOAD via SIO2PC interface.
+* Standard loader - ROM and interrupts enabled while running loaded program.
+
+	opt	h-
+	org	$700
+
+* Boot code
+boot	dta	b(0,1),a(boot)	Boot header
+arts	dta	a(rts)
+
+	dta	b({lda #$60})	Skip rts
+rts	rts
+
+	sei			Disable interrupts
+	inc	^4e
+	mva	#$08	^24	Set transmission speed
+	mva	#$00	^26
+	mva	#$28	^28
+	sta	^29		Reset counters
+	mva	#$23	^2f	Send enable
+	sta	^2d		Send a byte
+wait	sta	^4a		Wait until sent
+	asl	@
+	bcc	wait
+	mva	#$13	^2f	Receive enable
+	ldy	#2
+head	jsr	get		Receive address (high/low byte)
+	sta	stor,y
+	mva	arts-1,y	$2e2-1,y	Set init address
+	pha			Put return address on stack
+	dey
+	bne	head
+	jsr	get		Receive length (one byte)
+	tax
+load	jsr	get		Receive data
+stor	sta	a:0,x+		Store in memory
+	bne	load
+	mva	$10	^2e	Reset POKEY
+	mva	#3	^2f
+	lsr	^4e		Enable interrupts
+	cli
+init	jmp	($2e2)		Call init routine
+
+get	lda	#$20		Function: Receive one byte
+	sta	^2e		Enable receive interrupt
+	bit:rne	^2e		Wait for interrupt request
+	sty	^2e		Disable receive interrupt
+	lda	^2d		Get byte
+	rts
+
+:boot+$80-*	dta	b(0)	Padd with zeros to full sector
+
+* X-LOAD adds this block at the end of loaded file
+* It changes jmp ($2e2) to jmp ($2e0)
+	opt	h+
+	org	init+1
+	dta	l($2e0)
+
+	end
\ No newline at end of file
diff --git a/file_id.diz b/file_id.diz
deleted file mode 100644
index 3c4a8f1..0000000
--- a/file_id.diz
+++ /dev/null
@@ -1,7 +0,0 @@
-    \/
-    /\ - Assembler 2.0
---------------------------
-      by Fox/Taquart
---------------------------
-8-bit Atari 6502 assembler
-   for PC 386+ / MS-DOS
\ No newline at end of file
diff --git a/hardware.asx b/hardware.asx
deleted file mode 100644
index e042fd1..0000000
--- a/hardware.asx
+++ /dev/null
@@ -1,107 +0,0 @@
-*** GTIA
-HPOSP0	equ ^00 (w)	Horizontal POSition of Player 0
-KOLM0PF	equ ^00 (r)	KOLlision Missile 0 to Play Field
-HPOSP1	equ ^01 (w)	Horizontal POSition of Player 1
-KOLM1PF	equ ^01 (r)	KOLlision Missile 1 to Play Field
-HPOSP2	equ ^02 (w)	Horizontal POSition of Player 2
-KOLM2PF	equ ^02 (r)	KOLlision Missile 2 to Play Field
-HPOSP3	equ ^03 (w)	Horizontal POSition of Player 3
-KOLM3PF	equ ^03 (r)	KOLlision Missile 3 to Play Field
-HPOSM0	equ ^04 (w)	Horizontal POSition of Missile 0
-KOLP0PF	equ ^04 (r)	KOLlision Player 0 to Play Field
-HPOSM1	equ ^05 (w)	Horizontal POSition of Missile 1
-KOLP1PF	equ ^05 (r)	KOLlision Player 1 to Play Field
-HPOSM2	equ ^06 (w)	Horizontal POSition of Missile 2
-KOLP2PF	equ ^06 (r)	KOLlision Player 2 to Play Field
-HPOSM3	equ ^07 (w)	Horizontal POSition of Missile 3
-KOLP3PF	equ ^07 (r)	KOLlision Player 3 to Play Field
-SIZEP0	equ ^08 (w)	SIZE of Player 0
-KOLM0P	equ ^08 (r)	KOLlision Missile 0 to Players
-SIZEP1	equ ^09 (w)	SIZE of Player 1
-KOLM1P	equ ^09 (r)	KOLlision Missile 1 to Players
-SIZEP2	equ ^0a (w)	SIZE of Player 2
-KOLM2P	equ ^0a (r)	KOLlision Missile 2 to Players
-SIZEP3	equ ^0b (w)	SIZE of Player 3
-KOLM3P	equ ^0b (r)	KOLlision Missile 3 to Players
-SIZEM	equ ^0c (w)	SIZE of Missiles
-KOLP0P	equ ^0c (r)	KOLlision Player 0 to Players
-GRAFP0	equ ^0d (w)	GRAphic oF Player 0
-KOLP1P	equ ^0d (r)	KOLlision Player 1 to Players
-GRAFP1	equ ^0e (w)	GRAphic oF Player 1
-KOLP2P	equ ^0e (r)	KOLlision Player 2 to Players
-GRAFP2	equ ^0f (w)	GRAphic oF Player 2
-KOLP3P	equ ^0f (r)	KOLlision Player 3 to Players
-GRAFP3	equ ^10 (w)	GRAphic oF Player 3
-TRIG0	equ ^10 (r)	TRIGger 0
-GRAFM	equ ^11 (w)	GRAphic oF Missiles
-TRIG1	equ ^11 (r)	TRIGger 1
-COLPM0	equ ^12 (w)	COLor of Player/Missile 0
-COLPM1	equ ^13 (w)	COLor of Player/Missile 1
-TRIG3	equ ^13 (r)	TRIGger 3
-COLPM2	equ ^14 (w)	COLor of Player/Missile 2
-PAL	equ ^14 (r)	PAL flag
-COLPM3	equ ^15 (w)	COLor of Player/Missile 3
-COLPF0	equ ^16 (w)	COLor of Play Field 0
-COLPF1	equ ^17 (w)	COLor of Play Field 1
-COLPF2	equ ^18 (w)	COLor of Play Field 2
-COLPF3	equ ^19 (w)	COLor of Play Field 3
-COLBAK	equ ^1a (w)	COLor of BAcKground
-GTIACTL	equ ^1b (w)	GTIA ConTroL
-VDELAY	equ ^1c (w)	Vertical DELAY
-PMCNTL	equ ^1d (w)	Player/Missile CoNTroL
-HITCLR	equ ^1e (w)	HIT CLeaR
-CONSOL	equ ^1f (r/w)	CONSOL
-
-*** POKEY
-AUDF1	equ ^20 (w)	AUDio Frequency 1
-POT0	equ ^20 (r)	POTentiometr 0
-AUDC1	equ ^21 (w)	AUDio Control 1
-POT1	equ ^21 (r)	POTentiometr 1
-AUDF2	equ ^22 (w)	AUDio Frequency 2
-POT2	equ ^22 (r)	POTentiometr 2
-AUDC2	equ ^23 (w)	AUDio Control 2
-POT3	equ ^23 (r)	POTentiometr 3
-AUDF3	equ ^24 (w)	AUDio Frequency 3
-AUDC3	equ ^25 (w)	AUDio Control 3
-AUDF4	equ ^26 (w)	AUDio Frequency 4
-AUDC4	equ ^27 (w)	AUDio Control 4
-AUDCTL	equ ^28 (w)	AUDio ConTroL
-POTST	equ ^28 (r)	POTentiomers STatus
-KBCODE	equ ^29 (r)	KeyBoard CODE
-SKTRES	equ ^2a (w)	Serial and Keyboard RESet
-RANDOM	equ ^2a (r)	RANDOM
-POTGO	equ ^2b (w)	POTentiometr GOes
-SEROUT	equ ^2d (w)	SERial OUT
-SERIN	equ ^2d (r)	SERial IN
-IRQEN	equ ^2e (w)	Interrupt ReQuest ENable
-IRQST	equ ^2e (r)	Interrupt ReQuest STatus
-SKCTL	equ ^2f (w)	Serial and Keyboard ConTroL
-SKSTAT	equ ^2f (r)	Serial and Keyboard STATus
-
-*** PIA
-PORTA	equ ^30 (r/w)	PORT A
-PORTB	equ ^31 (r/w)	PORT B
-PACTL	equ ^32 (r/w)	Port A ConTroL
-PBCTL	equ ^33 (r/w)	Port B ConTroL
-
-*** ANTIC
-DMACTL	equ ^40 (w)	Direct Memory Access ConTroL
-CHRCTL	equ ^41 (w)	CHaRacters ConTroL
-DLPTR	equ ^42 (w)	Display List PoinTeR
-HSCROL	equ ^44 (w)	Horizontal SCROLl
-VSCROL	equ ^45 (w)	Vertical SCROLl
-PMBASE	equ ^47 (w)	Player/Missile BASE
-CHBASE	equ ^49 (w)	CHaracter BASE
-WSYNC	equ ^4a (w)	Wait for SYNChronisation
-VCOUNT	equ ^4b (r)	Vertical COUNT
-LPENH	equ ^4c (r)	Light PEN Horizontal
-LPENV	equ ^4d (r)	Light PEN Vertical
-NMIEN	equ ^4e (w)	Non-Maskable Interrupt ENable
-NMIST	equ ^4f (r)	Non-Maskable Interrupt STatus
-
-*** CPU
-NMIVEC	equ $fffa	Non-Maskable Interrupt VECtor
-RESETVC	equ $fffc	RESET VeCtor
-IRQVEC	equ $fffe	Interrupt ReQuest VECtor
-
-	end
\ No newline at end of file
diff --git a/quickref.txt b/quickref.txt
deleted file mode 100644
index 2bf338c..0000000
--- a/quickref.txt
+++ /dev/null
@@ -1,99 +0,0 @@
-X-ASM 2.0 QUICK REFERENCE
-=========================
-
-6502 commands
--------------
-ADC - add with carry
-AND - and
-ASL - arithmetic shift left
-BCC - branch if carry clear
-BCS - branch if carry set
-BEQ - branch if equal
-BIT - test bits
-BMI - branch if minus
-BNE - branch if not equal
-BPL - branch if plus
-BRK - break
-BVC - branch if overflow clear
-BVS - branch if overflow set
-CLC - clear carry
-CLD - clear decimal
-CLI - clear interrupts
-CLV - clear overflow
-CMP - compare
-CPX - compare with X
-CPY - compare with Y
-DEC - decrement
-DEX - decrement X
-DEY - decrement Y
-EOR - exclusive or
-INC - increment
-INX - increment X
-INY - increment Y
-JMP - jump
-JSR - jump to subroutine
-LDA - load accumulator
-LDX - load X
-LDY - load Y
-LSR - logical shift right
-NOP - no operation
-ORA - or accumulator
-PHA - push accumulator
-PHP - push flags
-PLA - pull accumulator
-PLP - pull flags
-ROL - rotate left
-ROR - rotate right
-RTI - return from interrupt
-RTS - return from subroutine
-SBC - subtract with carry
-SEC - set carry
-SED - set decimal
-SEI - set interrupts
-STA - store accumulator
-STX - store X
-STY - store Y
-TAX - transfer accumulator to X
-TAY - transfer accumulator to Y
-TSX - transfer stack pointer to X
-TXA - transfer X to accumulator
-TXS - transfer X to stack pointer
-TYA - transfer Y to accumulator
-
-X-Asm 2.0 pseudo-commands
--------------------------
-ADD - add
-INW - increment word
-JCC - jump if carry clear
-JCS - jump if carry set
-JEQ - jump if equal
-JMI - jump if minus
-JNE - jump if not equal
-JPL - jump if plus
-JVC - jump if overflow clear
-JVS - jump if overflow set
-MVA - move byte using accumulator
-MVX - move byte using X
-MVY - move byte using Y
-MWA - move word using accumulator
-MWX - move word using X
-MWY - move word using Y
-SUB - subtract
-
-X-Asm 2.0 directives
---------------------
-DTA - define data
-EIF - end if
-ELS - else
-END - end
-EQU - equal
-ERT - error if true
-ICL - include
-IFT - if true
-INI - init
-INS - insert
-OPT - options
-ORG - origin
-RUN - run
-
-===
diff --git a/readme.txt b/readme.txt
deleted file mode 100644
index 0c539bd..0000000
--- a/readme.txt
+++ /dev/null
@@ -1,75 +0,0 @@
-       |||            X-Assembler version 2.0 for MS-DOS            |||
-       |||  A powerful ATARI XL/XE software development tool on PC  |||
-      / | \           designed and coded by Fox/Taquart            / | \
-
-                                      ÜÜÜÜÜÜÜÜÛÛÛÛÛÛÛÛÛÛÛÛÛÛÜÜÜÜ
-                              ÜÜÜÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ
-                        ÜÜÜÛÛÛÛÛÛÛÛÛÛßßßßßß          ßßßßßßßÛÛÛÛ
-                    ÜÜÛÛÛÛÛÛÛßßß           ÜÛÛÜ     ÜÜÜÜ       ß
-                 ÜÛÛÛÛÛÛßß                 ÛÛÛÛ     ÛÛÛÛÛÛÛÛÜÜ
-              ÜÛÛÛÛÛßß         ÛÛÛ  ÜÜ     ßÛÛÛ       ßßÛÛÛÛÛÛÛÛÜÜ
-            ÜÛÛÛÛß         ÜÜÜÜÛÛÛÛßßÜÜÜÜÜ  ÛÛ             ßßßÛÛÛÛÛÜÜ
-          ÜÛÛÛß           ßÛßßßÛÛÛ  ÜÛÛ ÜÛ  ÛÛ                  ßßÛÛÛÛÜ
-         ÜÛÛß    ÜÜ  ÛÛÜ ÜÜÜ   ÛÛÛ  ÛÛÜÛß   ÛÛ                     ßÛÛÛÜ
-        ÛÛß      ßß  ÛÛÛÛßÛÛÛ  ÛÛÛ  ÛÛ  ÜÜÜ ÛÛÜ                      ßÛÛÛ
-       ÛÛß      ÛÛÛÜ ÛÛÛ  ÛÛÛ  ÛÛÛ  ßÛÛÛßß  ßßß         ÜÛÛ           ßÛÛÜ
-      ÛÛß       ÛÛÛ  ÛÛÛ  ßÛÛ  ÛÛÛ              ÜÜ      ÛÛÛ  ÜÜÛÛÜ     ÛÛÛ
-      ÛÛ        ÛÛÛ  ÛÛß   ÛÛ  ßß   ÛÛÛ  ÜÜ    ßßß    ÜÜÛÛÛ ÜÛÛ ÜÛß    ÛÛÛ
-      ÛÛ        ÛÛÛ             ÜÜÜÜÛÛÛßßßÜÛÛÛ ÛÛÜ  ÛÛÛßÛÛÛ ÛÛÜÛß      ÛÛß
-      ÛÛ         ßß             ßßßßÛÛÛ ÜÛÛßß  ÛÛÛ ÛÛÛ  ÛÛÛ ÛÛ  ÜÜÜ   ÛÛß
-      ÛÛ                   ÜÜ   ÛÛ  ÛÛÛ ßÛÛÜ   ÛÛÛ ÛÛÛÜÛÛÛÛ ßÛÛÛßß   ÛÛß
-      ßÛÛ            ÜÛÛÜÜ ÛÛ   ÛÛÜ ÛÛÛ    ÛÛÛ ÛÛÛ ßÛÛßßÛÛß        ÜÛÛß
-       ßÛÛÜ         ÛÛß ÛÛ ÛÛ   ÛÛÛ ÛÛÛ   ÜÛÛß ßßß               ÜÛÛß
-        ßÛÛÜÜ       ÛÛ   ÛÛ ÛÛÜÜÛÛÛ ÛÛÛ  ßÛß                  ÜÛÛÛß
-          ßÛÛÛÜ     ßÛÜÜÛÛß ßÛÛßßßß                       ÜÜÛÛÛßß
-            ßßÛÛÛÜÜ  ßßßßß                           ÜÜÜÛÛÛÛßß
-               ßßÛÛÛÛÛÜÜÜÜ                  ÜÜÜÜÜÛÛÛÛÛÛÛßß
-                    ßßÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛßßß
-                          ßßßßßßßßßßßßßßßßßßß
-
-            ÜÜÛÛÛÛÛÛÜÜ    ÛÛÛÛÛÛÛÛÛÛÛÛÛ    ÜÜÛÛÛÛÛÛÛÜÜ     ÜÜÛÛÛÛÛÛÛÛÜÜ
-          ÛÛÛÛÛß  ßßßßß   ÛÛÛÛÛ          ÜÛÛÛÛÛß ßÛÛÛÛÛÜ  ÛÛÛÛß   ÛÛÛÛÛÛ
-         ÛÛÛÛÛÛÜÜÜÜÜÜÜ    ÛÛÛÛÛÛÛÛÛÛÜÜÜ  ÛÛÛÛÛÛ   ÛÛÛÛÛÛ         ÜÛÛÛÛÛß
-         ÛÛÛÛÛÛß ßÛÛÛÛÛÛ         ßÛÛÛÛÛÛ ÛÛÛÛÛÛ   ÛÛÛÛÛÛ     ÜÜÛÛÛÛßß
-         ßÛÛÛÛÛÜ ÜÛÛÛÛÛÛ  ÛÛÛÜ   ÜÛÛÛÛÛß ßÛÛÛÛÛÜ ÜÛÛÛÛÛß  ÜÜÛÛÛÛÛÜÜÜÜÜÜÜ
-           ßßÛÛÛÛÛÛÛßß     ßßÛÛÛÛÛÛßßß     ßßÛÛÛÛÛÛßßß    ÛÛÛÛÛÛÛÛÛÛÛÛÛÛ
-           ÜÜÜ    ÜÜÜ     ÜÜ     ÜÜ    ÜÜÜ    ÜÜ     ÜÜ     ÜÜ    ÜÜÜ
-           Û  Û   Û  Û   Û  Û   Û  ß   ÛÜÜ   ßÜ ß   ßÜ ß   Û  Û   Û  Û
-           Ûßß    ÛßßÜ   Û  Û   Û  Ü   Û     Ü ßÜ   Ü ßÜ   Û  Û   ÛßßÜ
-           ß      ß  ß    ßß     ßß    ßßß    ßß     ßß     ßß    ß  ß
-
-Copyright
----------
-This version of X-Asm is FREEWARE. Feel free to distribute it where you want.
-
-Contests of this package
-------------------------
-ATARI.PAL	Atari palette 256 * RGB * 6 bits
-CHANGES.TXT	What's new in this version
-CPUBUGS.ASX	6502 bugs tester source & bugs description
-DLIST.TXT	Atari Display List op-codes
-FILE_ID.DIZ	.DIZ file
-HARDWARE.ASX	Atari XL/XE hardware addresses
-README.TXT	This file
-QUICKREF.TXT	6502 commands & X-Asm directives quick reference
-XASM.COM	X-Assembler program
-XASM.TXT	X-Assembler documentation
-XBOOT.COM	X-Boot - converts Atari executables into .ATR files
-XBOOT.TXT	Notes for X-Boot
-XBOOTPRO.ASX	Source of X-Boot professional loader
-XBOOTSTD.ASX	Source of X-Boot standard loader
-XHEAD.COM	X-Head - shows structure of Atari executables
-XHEAD.TXT	Notes for X-Head
-XPAL.COM	X-Pal - shows ATARI.PAL
-
-Contact
--------
-               Author:                                For swap:
-             FOX/Taquart                           SLAVES/Taquart
-             Piotr Fusik                            Slawek Sledz
-             ul. Cicha 9                       ul. Pozytywist¢w 2/77
-       05-300 Minsk Mazowiecki                     20-369 Lublin
-               Poland                                  Poland
-    e-mail: pfusik@elka.pw.edu.pl              e-mail: slaves@pol.pl
-
-===
diff --git a/xasm.htm b/xasm.htm
deleted file mode 100644
index 3eabe95..0000000
--- a/xasm.htm
+++ /dev/null
@@ -1,509 +0,0 @@
-
-
-X-Assembler 2.0 Manual
-
-
-

-
X-Assembler version 2.0

-coded by Fox/Taquart
-

-

-
INTRODUCTION

-The X-Assembler is an assembler, which generates code for the 6502 processor.
-It is 99% compatible with Quick Assembler on 8-bit Atari.
-

-
System requirements

-
    
-
  •  a PC compatible computer with 386 or better CPU
-
  •  a MS-DOS compatible OS
-
  •  a numeric coprocessor for generating sinus tables.
-  Your CPU probably has a built-in coprocessor.
-

-

-
Creating a source program

-Source file should be standard text file with IBM-style EOLs: CR/LF. You can
-use any text editor on PC to prepare your source code.
-Single line of source should not be longer than 256 characters.
-There is no limitation on the length of the file.
-Source may contain tabulators - there are treated as spaces.
-Assembler is NOT case-sensitive.
-

-
Converting Quick Assembler files

-You must convert Atari text file into PC text file (EOL's from $9b to $0d/$0a),
-ATASCII 0-31 and 128-255 characters should be replaced with standard ASCII
-characters, using QAsm expressions.

-You also have to change all OPT directives, but usually you needn't them
-at all.
-

-
Assembling a source program

-Syntax (parameters in brackets are optional):

-
XASM source [options]
-
'source' is name of source file.
-If no extension given, the .ASX is added by default.

-Options are:
-

-
/c
-
Enable listing false conditionals.
-
/i
-
Disable listing included source.
-
/l[:fname]
-
Enable generating listing. If no fname given, listing is written to source.lst.
-
/o:fname
-
Specify object name. Default is source.obx.
-
/s
-
Disable converting spaces to tabs. Using tabs makes listing file shorter.

-Tab stops are assumed to be every 8 characters.
-
/t[:fname]
-
List label table. If no fname given, table is written at the end of listing.
-

-
-If source is incorrect, X-Asm displays ONLY FIRST encountered error.

-
-Errorlevels returned by X-Asm:

-3 = bad parameters, assembling not started

-2 = error occured

-1 = warning(s) only

-0 = no errors, no warnings

-
-
Listing structure

-Line of listing includes:
-
    
-
  •  decimal number of line of source file (if source is different than in
-previous listed line, appropriate message line is generated)
-
  •  hexadecimal origin
-
  •  hexadecimal bytes written to object file
-Listed are also generated headers. A xxxx-yyyy> in place of origin is
-a generated header: $xxxx is the first and $yyyy is the last byte of block.
-A FFFF> represents two $ff bytes written as a header prefix.
    
-A plus sign placed after hex numbers stands for more bytes written to object
-in this line, not listed through lack of space.
-
  •  remaining part of listing line is a copy of source
-

-
-
Label table structure

-Line of label table includes:
-
    
-
  •  some info of label:
    
-  n - label not used
    
-  2 - label value known in pass 2 only (label definition uses forward reference
-      and thus you can't do forward references to that label)
-
  •  hex value of label
-
  •  name of label
-

-
-

-
X-ASM LANGUAGE STRUCTURE

-Lines of source code may be:
-
    
-
  •  empty lines - ignored, of course
-
  •  comments - ignored, too
-
  •  statements - not ignored :-)
-

-Comment lines must have one of the following characters in the FIRST column
-of the line: * ; |
-
-
Numbers

-Numbers are 32-bit signed integers, in the range of -$7fffffff..$7fffffff.
-A number can be:
-
    
-
  •  a decimal number          -12345
-
  •  a hexadedecimal number    $abcd
-
  •  a binary number           %10100101
-
  •  a character               'a' or "a" (new in 2.0!)
-
  •  a hardware register       ^31
-
  •  an origin counter         *
-

-I think only 'a hardware register' should be explained. It is a short way
-of accessing Atari hardware registers:

-^0x means $d00x

-^1x means $d01x

-^2x means $d20x

-^3x means $d30x

-^4x means $d40x

-where x is a hexadecimal digit.
-
-
Expressions

-Expressions are numbers combined with operators and brackets.
-You should use square brackets, because parentheses are reserved
-for 6502 indirect addressing. Currently there are 19 operators:

-
-+  Addition

--  Subtraction

-*  Multiplication

-/  Division

-%  Remainder

-&  Bitwise and

-|  Bitwise or

-^  Bitwise xor

-<< Arithmetic shift left

->> Arithmetic shift right

-=  Equal

-<> Not equal

-!= Not equal (same as <>)

-<  Less than

->  Greater than

-<= Less or equal

->= Greater or equal

-&& Logical and

-|| Logical or

-
-Operator precedence:
-
-first  []
-       * / % & << >>
-       + - | ^
-       = <> != < > <= >=
-       &&
-last   ||
-

-Compare and logical operators assume that zero is false and non-zero is true.
-They return -1 for true.

-When calculating expression, 32-bit arithmetic is used. When range of 32 bits
-is exceeded, 'Arithmetic overflow' error is generated.

-If result of expression has improper size, 'Value out of range' error occurs.

-Note difference beetwen X-Asm 2.0 and QAsm/X-Asm 1.2: in older assemblers,
-which used 16-bit arithmetic, a LDA 0-1 was correct (LDA $ffff), but X-Asm 2.0
-encounters an error: address can't be negative.

-X-Asm recognizes now signed bytes: LDA #-1 is OK.
-
-
Statements

-A statement is divided into fields: a label field, an operation field,
-one or two operand fields, and a comment field. There should be at least
-one space between every two fields and there can't be any space within a field
-excluding strings.
-
-
Label field

-This field is optional. It is required only by the EQU directive.
-Specyfying this field definies a label. Defined label represents an integer
-of range -$ffff..$ffff.

-Name of label must begin in column 1 and can contain letters, digits
-and underscores (_). Digit can't be label's first character. Name of label
-can be as long as you want and all the characters are meaningful.

-In Quick Assembler only 6 leading characters were recognized
-and some programs may not compile well under X-Asm for this reason.

-Defining a label without using EQU makes it equal to current value
-of the origin counter. Label can't be redefined.
-
-
Operation field

-Operation field is the only field which is always required.
-You have to put one or more spaces or tab characters between label
-and operation field. If no label is defined, line must start with a blank
-character. Operation field is always 3 letters long. It can be:
-
    
-
  1.  a 6502 processor command
-
  2.  a compiler directive
-
  3.  a pseudo-command
-

-
    
-
  1.  6502 command
    
-One of 56 well known processor commands.

    
-
-
  2.  compiler directive
    
-One of the following:
-
    
-
    EQU - assign a value of expression to the label
-
    Note that label represents a number, not a text macro.
    
-Examples:
-
    five equ 5
-ten  equ five+five
-
    
-
-
    OPT - set assembling options
-
    Currently there are two options: listing generating and headers generating.
-You can turn any of these on or off.
    
-Examples:
-
     opt l-    listing off
- opt h-    headers off
- opt l+h-  listing on, headers off
-
    
-Remember not to put a space between options:
-
     opt l+ h-
-
    
-is actually
-
     opt l+
-
    
-because h- is a comment.
    
-Default (if no opt specified) is opt l+h+.
    
-
-
    ORG - set new origin counter
-
    Examples:
-
     org $600         code will be located starting from $0600
-table org *+100   'table' points to 100 bytes of uninitialized data
-
    
-New! You can set some options applied to new header (if headers are on):
-
     org $600
- rts
- org a:$601
-
    
-'a:' tells X-Asm to always make a header, even it is unnecessary (as in above).
-So by default X-Asm 2.0 does not generate unnecessary headers, distinct from
-QAsm and X-Asm 1.2.
-
     org f:$700
-
    
-'f:' works same as 'a:', but additionally tells to generate a $ff,$ff prefix
-before header. X-Asm adds it to the first header in file by default, so use
-this option only if you want the $ff's somewhere inside.
    
-
-
    DTA - define data
-
    You may define:
-
      
-
    •  numbers
-  
        
-  
      •  bytes: b(200)
-  
      •  words: a(10000)
-  
      •  low bytes of words: l(511) defines byte 255
-  
      •  high bytes of words: h(511) defines byte 1
-  You may enter many expressions in parentheses and combine different types
-  of data in single line.
        
-  You may also define a sinus table. Enter this expression:
        
-  sin(centre,amp,size,first,last)
        
-  where:
-  
          
-  
        •  centre is a number which is added to every value of sinus
-  
        •  amp is the amplitude of sinus
-  
        •  size is the period of sinus
-  
        •  first,last define range of values in the table.
-    They are optional. Default are 0,size-1.
-  
        
-  Example: dta a(sin(0,1000,256,0,63)) defines table of 64 words representing
-  a quarter of sinus with amplitude of 1000.
-  
      •  real numbers: r(-1.23456e12)
        
-  Real numbers are written in 6-byte Atari Floating-Point format. You can't
-  combine reals with operators, as you can integers.
        
-  
      
-
    •  text strings
-  
        
-  
      •  ASCII strings: c'Text' or c"Text"
-  
      •  ANTIC strings: d'Text' or d"It's something new!"
-  
      
-  A character string consists of any of characters surrounded by quotation
-  marks. Within a string, a single quotation mark character is
-  represented by two succesive quotation marks.
      
-  Placing a '*' character after a string inverts bit 7 in every byte of string.
      
-
    
-Examples of DTA:
-
    - dta b(2,5),a(1000,-1),l(12345,sin(0,127,256))
- dta d"ANTIC"*,c'It''s a string',b(155)
-
    
-
-
    ICL - include another source file
-
    Specifies another file to be included in the assembly as if the contests of
-the referenced file appeared in place of the ICL statement. The included file
-may contain other ICL statements.
    
-Examples:
-
    - icl 'macros.asx'
- icl 'c:\atari\xasm\fileio.asx'
-
    
-
-
    END - end assembling of file
-
    Remaining part of the file is not assembled. If this statement does not occur,
-assembler stops assembling when encounters end of file.
    
-Example:
-
    - end
-
    
-
-
    INS - insert contents of file
-
    Copies every byte of specified file into object file and moves origin counter,
-as if these bytes were defined with DTA.
    
-Examples:
-
    - ins 'picture.raw'
- ins 'tables.dat'
-
    
-New! You may specify range of inserted file. Syntax is:
-
    - ins 'file'[,offset[,length]]
-
    
-First byte in file has offset 0.
    
-If offset is negative, it is counted from the end of file.
-
    - ins 'file',-256   inserts last 256 bytes of file
- ins 'file',10,10  inserts bytes 10..19 of file
-
    
-
-
    RUN - generate run address
-
    The Atari executable program should have run address specified. Remember that
-a program may be loaded in many areas of memory and started from any address.
-
     run addr
-
    
-is equivalent to:
-
     org $2e0
- dta a(addr)
-
    
-Examples:
-
     run start
- run program
-
    
-
-
    INI - generate init address
-
    The Atari executable program may have some routines which are executed during
-loading process. There may be many init blocks in one file.
-Examples:
-
     ini init
- ini showpic
-
    
-
-
    ERT - generate error if expression is true
-
    Examples:
-
     ert *>$c000
- ert len1>$ff||len2>$ff
-
    
-
-
    IFT - assemble if expression is true
    
-ELS - else
    
-EIF - end if
    
-
    Example:
-
    noscr equ 1
- ift noscr
- lda #0
- els
- lda #$22
- eif
- sta $22f
-
    
-
-
    
-
  3.  pseudo-command
    
-It is something like built-in macro. It replaces two or more standard
-processor commands. Note that it is not an illegal instruction and works
-on typical 6502.
-
    
-
    ADD - addition without carry
-
    If you ever programmed 6502, you must have noticed that you had to use a CLC
-before ADC for every simple addition.
    
-X-Asm can do it for you. ADD simply replaces two instructions: CLC and ADC.
    
-
-
    SUB - subtraction
-
    It is SEC and SBC.
    
-
-
    JNE, JEQ, JCC, JCS, JPL, JMI, JVC, JVS - conditional jumps
-
    They are a kind of 'long' branches. While standard branches (BNE, BEQ) have
-range of -128..+127, these jumps have range of all 64 kB.
    
-For example: a JNE DEST is replaced with:
-
     beq *+5
- jmp dest
-
    
-
-
    INW - increment word
-
    It is a 16-bit memory increment command. An INW DEST will be replaced by:
-
     inc dest
- bne _skip
- inc dest+1
-_skip equ *
-
    
-The _skip label is not declared of course.
    
-
-
    MVA, MVX, MVY - move byte using accumulator, X or Y
-
    These pseudo-commands require two operands.
-
     mva source dest = lda source : sta dest
- mvx source dest = ldx source : stx dest
- mvy source dest = ldy source : sty dest
-
    
-
-
    MWA, MWX, MWY - move word using accumulator, X or Y
-
    Also require two operands. They are something like combination of two MV*'s:
-one to move low byte, and the other to move high byte.
    
-You can't use indirect nor pseudo addressing modes with MW*.
    
-Destination must be absolute address (indexed or not).
    
-When source is also absolute, a MW* SOURCE DEST will be:
-
     mv* source   dest
- mv* source+1 dest+1
-
    
-When source is immediate, a MW* #IMMED dest will be
-
     mv* <immed dest
- mv* >immed dest+1
-
    
-but when <IMMED = >IMMED and IMMED is not forward-referenced,
-X-Asm uses optimization:
-
     mv* <immed dest
- st* dest+1
-
    
-
    
-

-
-
Operand

-It depends on the operation field. Some statements don't need an operand
-or need two operands.

-
-6502 commands require operand depending on the addressing mode.
-Addressing modes should be entered in standard convention except
-the accumulator addressing mode, which should be marked with a @ character
-(as in Quick Assembler).

-
-There are two extra immediate addressing modes: < and >, which use low/high
-byte of word is used rather than byte value.

-
-In absolute addressing modes, X-Asm examines expression and uses zero-page
-addressing mode if it thinks it is possible to do it. You may override it
-with a: and z: prefixes.

-
-Examples:
-
- nop
- asl @
- lda >$1234	assembles to lda #$12
- lda $100,x
- lda a:0	generates 16-bit address
- jmp ($0a)
- lda ($80),y
-

-
-New! X-Asm 2.0 brings pseudo addressing modes. They are similar to
-pseudo-commands and you may use them as standard addressing modes
-in all 6502 commands and pseudo-commands, excluding MW*:
-
 cmd a,x+    =  cmd a,x   : inx
- cmd a,x-    =  cmd a,x   : dex
- cmd a,y+    =  cmd a,y   : iny
- cmd a,y-    =  cmd a,y   : dey
- cmd (z),y+  =  cmd (z),y : iny
- cmd (z),y-  =  cmd (z),y : dey
- cmd (z,0)   =  ldx #0    : cmd (z,x)
- cmd (z),0   =  ldy #0    : cmd (z),y
-

-
Problems

-These notes may help you solve problems:
-
    
-
  •  No spaces are allowed within a field.
-
    label equ 1 + 2
-
    
-causes label to be equal 1 (+ 2 is treated as a comment).
    
-
-
  •  < and > represent addressing modes rather than LOW and HIGH operators.
    
-You specify lda <table, not lda #<table like in most 6502 assemblers.
    
-
-
  •  Label definition does not include a colon
-
    label: lda ^4b     ERROR - colon after label name
-
    
-
-
  •  Exactly one run address should be specified
    
-Remember that unlike in other assemblers
-
     end start
-
    
-does not tell the assembler that start is the run address (it is a comment).
-You must specify the run address with RUN directive.
    
-
-
  •  X-Asm reads source twice (in pass 1 and pass 2)
    
-This allows forward references, but not too complex.
    
-Keep in mind that assembler should know all the values in second pass.
    
-Example:
-
    two   equ one+one   This value is known in 2nd pass only
-one   equ 1         This value is known as early as in 1st pass
-
    
-These values can be fixed in 2 passes.
    
-But if you insert following statement as first line:
-
    three equ one+two
-
    
-X-Asm will generate an error because it doesn't know the value of three in
-second pass.
    
-(sorry for v1.2 users: EQU forward reference didn't work at all).
    
-
-
  •  X-Asm displays only first error
    
-When you correct one error don't be surpised if you get another one.
    
-
-
  •  If you encounter X-Asm works improperly, please let me know.
-

-
-
\ No newline at end of file
diff --git a/xboot.txt b/xboot.txt
deleted file mode 100644
index 34cc9ce..0000000
--- a/xboot.txt
+++ /dev/null
@@ -1,16 +0,0 @@
-X-Boot 3.2 by Fox/Taquart
-Some (un)important notes
-=========================
-
-The only change from version 3.1: Now .OBX is default extension of executable.
----
-This tool converts Atari executable (.OBX) into Atari disk image (.ATR).
-Produced ATR is single density and as short as possible. It has a loader
-in one boot sector. You can choose one of two built-in loaders:
-standard and professional. Professional loader allows you to load code/data
-under ROM and disables ROM and interrupts while starting program.
-Both loaders disable Atari Basic. For details, view sources of loaders.
-X-Boot does not write your program in ATR as Atari file, you can only run it
-by booting.
-
-===
diff --git a/xbootpro.asx b/xbootpro.asx
deleted file mode 100644
index bf390f7..0000000
--- a/xbootpro.asx
+++ /dev/null
@@ -1,70 +0,0 @@
-* Boot executable file loader coded by Fox/Taquart
-* Version for professionals - can load file under ROM.
-* Note interrupts and ROM are disabled when running loaded program.
-
-	opt	h-
-	org	$480
-
-bufr	equ	$400
-
-tp	equ	$43
-vc	equ	$44
-
-* Boot header
-boot	equ	*
-rts	rts
-	dta	b(1),a(boot,$e477)
-* Nice blank screen
-	mva	#0	$22f
-	mva	#$52	$2c8
-	lda	20
-	cmp	20
-	beq	*-2
-* Init run vector
-	mwa	#rts	$2e0
-	ldy	#$fe
-* Load header
-lhead	mwa	#rts	$2e2
-	ldx	<-5
-* Store byte of header
-hput	sta	vc+4,x+
-	stx	tp
-	jmp	get
-next	inw	vc
-get	iny
-	bpl	getx
-	inw	$30a
-	mva	#$ff	^31
-	lsr	^4e
-	cli
-	jsr	$e453
-	sec
-	bmi	rts
-	sei
-	mvy	#0	^4e
-	dec	^31
-getx	lda	bufr,y
-	ldx	tp
-	bne	hput
-	sta	(vc,x)
-	lda	vc
-	cmp	vc+2
-	bne	next
-	lda	vc+1
-	cmp	vc+3
-	bne	next
-endseq	tya
-	pha
-	jsr	init
-	pla
-	tay
-	bpl	lhead	!
-
-init	jmp	($2e2)
-
-* This will be added at the end of loaded file
-	opt	h+
-	org	endseq
-	jmp	($2e0)
-
-	end
\ No newline at end of file
diff --git a/xbootstd.asx b/xbootstd.asx
deleted file mode 100644
index b51d8db..0000000
--- a/xbootstd.asx
+++ /dev/null
@@ -1,69 +0,0 @@
-* Boot executable file loader coded by Fox/Taquart
-* Standard loader - ROM and interrupts enabled.
-
-	opt	h-
-	org	$780
-
-bufr	equ	$700
-
-tp	equ	$43
-vc	equ	$44
-
-* Boot header
-boot	equ	*
-rts	rts
-	dta	b(1),a(boot,$e477)
-* Print text
-txtpos	equ	215
-	ldy	#txtpos
-print	mva	text-txtpos,y	($58),y+
-	cpy	#txtpos+txtlen
-	bcc	print
-* Init run vector
-	mwa	#rts	$2e0
-	mva	>bufr	$305
-	mvy	#$ff	^31
-	dey	#$fe
-* Load header
-lhead	mwa	#rts	$2e2
-	ldx	<-5
-* Store byte of header
-hput	sta	vc+4,x+
-	stx	tp
-	jmp	get
-next	inw	vc
-get	iny
-	bpl	getx
-	inw	$30a
-	jsr	$e453
-	sec
-	bmi	rts
-	ldy	#0
-getx	lda	bufr,y
-	ldx	tp
-	bne	hput
-	sta	(vc,x)
-	lda	vc
-	cmp	vc+2
-	bne	next
-	lda	vc+1
-	cmp	vc+3
-	bne	next
-endseq	tya
-	pha
-	jsr	init
-	pla
-	tay
-	bpl	lhead	!
-
-init	jmp	($2e2)
-
-text	dta	d'Loading... '
-txtlen	equ	*-text
-
-* This will be added at the end of loaded file
-	opt	h+
-	org	endseq
-	jmp	($2e0)
-
-	end
\ No newline at end of file
diff --git a/xhead.txt b/xhead.txt
deleted file mode 100644
index 1b48771..0000000
--- a/xhead.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-X-Head 1.1 by Fox/Taquart
-Some (un)important notes
-=========================
-
-The only change from version 1.0: Now .OBX is default extension.
----
-This tool prints headers of Atari executable.
-It also shows program init and run addresses.
-Other things displayed:
-xxx bytes - length of file, including headers
-xxx blocks - number of headers
-xxx inits - number of init blocks (02e2-02e3)
-xxx modules - number of FFFF headers (one at the beginning is required)
-You can redirect output to a file, for example:
-XHEAD TEST.COM >TEST.HDR
-
-===
\ No newline at end of file