This is version . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

Bug/65 Version 2.0 (C) 1982 McStuff Co. and Optimized Systems Software, Inc.#

Powerful, individual adaptable debugger for Atari 8 bit computers#

Image:#

Bug/65 Version 2.0 (C) 1982 McStuff Company and Optimized Systems Software, Inc.

BUG/65 Disassembly#

ATR-Image:#

Manuals:#

  • BUG-65 Manual 1.pdf(info) ; size: 102 KB
  • BUG-65 Manual 2.pdf(info) ; size: 283 KB
  • BUG-65 Manual 3.pdf(info) ; size: 213 KB
  • BUG-65 Manual 4.pdf(info) ; size: 233 KB
  • BUG-65 Manual 5.pdf(info) ; size: 987 KB
  • BUG-65 Version 2.0 Manual with ERRATA(info) ; size: 2.7 MB ; this manual contains as the only one an error page: 'ERRORS IN YOUR BUG/65 MANUAL' (page 4 in the pdf file). As of this moment, it is not understood, why the there mentioned commands: N, O, R', R", W' and W" do not work with the above version 2.0 of BUG/65. Either we have version 1.1 for real, while 2.0 is shown at start or something else is wrong here. Anyway, the mentioned pages on the error page do match with pages in the rest of the manual. Maybe the 'old boys club' from the golden age can solve this? Any help in that case is very welcome at any time. We really appreciate if you can help us.

Please take into account, that in the manuals above version 1.1 is mentioned, while just version 2.0 above is available up to now. If you own version 1.1, please let us know. We can make you an offer, you can't resist. ;-)

BUG/65 User Command Handler Example#


The MAC/65 file of the 'User Command Handler Example': 'USRCOMHD.M65' is already on the atr image above.

BUG/65 does not print with XL/XE OS:#

Device ID $3F instead $40. BUG/65 jumps indirect into the put-byte-routine of the OS ($E436 -> $FECA+1), therefore no IOCB-channel is opened and the device number is missing.
Patch:
Load BUG/65 and change the following:
ORG+$068B LDX #36
          LDY #E4
          JMP 2777
=>
ORG+$068B JMP 0600
0600	  PHA
	  LDX #10
	  LDA #1
	  STA 341,X
	  PLA
	  JMP FECB
BUGV4FIX.COM ; We are still searching for that file, it seems to be lost. Any help, any hint in that case is very much appreciated. :-)

Please take into account, that the fix seems to be for version 1.1(?) of BUG/65, which is lost, too. :-((

At the end of the Bug/65 manual we can read:

1. Copy the files BUG65.COM and BUGV4FIX.COM to a version 4 disk using the COPY24 command (see the DOSXL manual for details on this command).
2. At the version 4 "D1:" prompt, type the command: BUGV4FIX (RETURN).
3. The file BUG65.COM on that disk is now compatible with version 4 of DOSXL.

WARNING: Do NOT perform the BUGV4FIX command on your version 2 master disk!

Creating a non-relocatable version#


In order to allow itself to be relocated virtually anywhere in memory, BUG/65 as shipped includes a relocation bit map and relocation program. In addition, relocatable BUG/65 always loads in at locations $9800 through $BC00. If these addresses are "poison" to you (e.g., if you want to use BUG/65 with a cartridge plugged in), you may wish to produce a non-relocatable version designed to run within an address range you pick. If so, USING A 48K SYSTEM, simply specify the loadpoint, as shown in the preceding section (e.g., via BUG65 7000) and allow BUG/65 to load and relocate. Then exit to OS/A+ (via Quit) and use OS/A+ intrinsic command SAVE to save a non-relocatable version. The address range to be SAVEd may be calculated as follows:

SAVE filename.com loadpoint+$200 loadpoint+$1FFF

Thus, if you had specified "BUG65 7000", you could save the non-relocatable version via

SAVE BUG7000.COM 7200 8FFF

thus also giving it a name which will later remind you where it will load at. To execute this non-relocatable version, simply type in its name (BUG7000 in the example shown).

Summary of major features of BUG/65#

• A full set of debugging commands - change memory, display memory, goto user program with break points, etc.
• Binary file read and write, including appended write
• A disassembler
• An instant assembler providing labelling capability
• Expanded command addressing capability: hex or decimal addresses, + and - operators supported, relocated addresses supported
• Read or write disk sector(s)
• Multiple commands permitted in a command line. Command lines can be repeated with a single keystroke or repeated forever with the special slash operator.
• Support for relocatable assemblers - the base of a module can be specified and then used to reference addresses in that module
• BUG/65 commands can be executed from a command file, and there is a command to create command files
• Hex to decimal and decimal to hex conversions provided
• Memory protection of BUG/65's code and data. BUG/65 won't allow you to use a BUG/65 command that will destroy any part of BUG/65 itself. For example, you can't use the Fill command to overwrite BUG/65's code.
• Page zero sharing. BUG/65 shares page zero with a user program by keeping two copies of the shared page zero locations - one for the user and one for BUG/65 itself.

Command Summary of BUG/65:#



Command Summary of BUG/65 Version 2.0 (C) 1982 McStuff Company and Optimized Systems Software, Inc.

Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
txt
BUG-65 APPEND PROGRAM ON MAC-6... 1.6 kB 1 28-Jan-2015 21:07 Roland B. Wassenberg BUG-65 APPEND PROGRAM ON MAC-65
pdf
BUG-65 Manual 1.pdf 99.8 kB 1 28-Jan-2015 21:06 Roland B. Wassenberg BUG-65 Manual 1
pdf
BUG-65 Manual 2.pdf 280.2 kB 1 28-Jan-2015 21:06 Roland B. Wassenberg BUG-65 Manual 2
pdf
BUG-65 Manual 3.pdf 211.1 kB 1 28-Jan-2015 21:06 Roland B. Wassenberg BUG-65 Manual 3
pdf
BUG-65 Manual 4.pdf 232.9 kB 1 28-Jan-2015 21:06 Roland B. Wassenberg BUG-65 Manual 4
pdf
BUG-65 Manual 5.pdf 986.3 kB 1 28-Jan-2015 21:06 Roland B. Wassenberg BUG-65 Manual 5
txt
BUG-65 User Command Handler Ex... 2.5 kB 1 09-Feb-2015 11:23 Roland B. Wassenberg BUG-65 User Command Handler Example 1
txt
BUG-65 User Command Handler Ex... 2.1 kB 1 09-Feb-2015 11:23 Roland B. Wassenberg BUG-65 User Command Handler Example 2
pdf
BUG-65 Version 2.0 manual-fina... 2,653.3 kB 1 09-Feb-2015 11:22 Roland B. Wassenberg BUG-65 Version 2.0 manual-final with errorpage
txt
Bug-65 Disassembly.txt 149.1 kB 1 13-Feb-2015 01:20 Roland B. Wassenberg Bug-65 Disassembly
pdf
Bug-65 Manual Rev. 1.0 (1982)(... 1,288.8 kB 1 26-Apr-2020 13:41 Roland B. Wassenberg Bug-65 Manual Rev. 1.0 (1982)(OSS Software)(US)-with table of contents-Original-
pdf
Bug-65 Manual Rev. 1.1 (1982)(... 23,638.3 kB 1 26-Apr-2020 13:42 Roland B. Wassenberg Bug-65 Manual Rev. 1.1 (1982)(OSS Software)(US)-re-edit with OCR.pdf
pdf
Bug-65 Reference Manual v1.0 (... 2,366.8 kB 1 26-Apr-2020 11:57 Roland B. Wassenberg Bug-65 Reference Manual v1.0 (1982)(OSS Software)(US)_.pdf
jpg
Bug-65.jpg 45.2 kB 1 28-Jan-2015 21:08 Roland B. Wassenberg BUG-65 picture
jpg
Command Summary 1.jpg 122.0 kB 1 12-Feb-2015 15:22 Roland B. Wassenberg Command Summary 1
jpg
Command Summary 2.jpg 130.4 kB 1 12-Feb-2015 15:22 Roland B. Wassenberg Command Summary 2
jpg
Command Summary.jpg 228.3 kB 1 12-Feb-2015 15:25 Roland B. Wassenberg Command Summary
atr
MAC-65 2.00 and 4.20 with Bug-... 92.2 kB 2 09-Feb-2015 11:22 Roland B. Wassenberg MAC-65 2.00 and 4.20 with Bug-65 2.0 and DOS XL 2.30
atr
MAC-65_2.00_and_4.20_with_Bug-... 92.2 kB 1 15-Feb-2015 16:33 Roland B. Wassenberg MAC-65_2.00_and_4.20_with_Bug-65_2.0_normal_and_V4_ready_and_DOS_XL_2.30
atr
OSS Bug-65 with OSS DOS XL 2.3... 92.2 kB 1 12-Feb-2015 15:17 Roland B. Wassenberg OSS Bug-65 with OSS DOS XL 2.30p 2000-9000 and 3000 Color
atr
OSS Bug-65 with OSS DOS XL 2.3... 92.2 kB 1 12-Feb-2015 15:16 Roland B. Wassenberg OSS Bug-65 with OSS DOS XL 2.30p 2000-9A00
cas
OSS_BUG_65_2.0.cas 11.4 kB 1 16-Feb-2015 02:20 Roland B. Wassenberg OSS_BUG_65_2.0.CAS
atr
OSS_Bug-65_with_OSS_DOS_XL_2.3... 92.2 kB 1 15-Feb-2015 16:33 Roland B. Wassenberg OSS_Bug-65_with_OSS_DOS_XL_2.30p_2000-9000_and_3000_Color
atr
OSS_Bug-65_with_OSS_DOS_XL_2.3... 92.2 kB 1 15-Feb-2015 16:33 Roland B. Wassenberg OSS_Bug-65_with_OSS_DOS_XL_2.30p_2000-9A00
jpg
Page 4.jpg 253.8 kB 1 09-Feb-2015 11:23 Roland B. Wassenberg Errata
jpg
Page 47.jpg 158.9 kB 1 09-Feb-2015 11:24 Roland B. Wassenberg Page 47
jpg
Page 48.jpg 104.2 kB 1 09-Feb-2015 11:24 Roland B. Wassenberg Page 48
zip
bug65.zip 140.7 kB 1 16-Feb-2015 20:50 Roland B. Wassenberg BUG/65 manual - html-version
« This particular version was published on 13-Feb-2015 08:56 by Carsten Strotmann.