Tools and enhancements to make working with 6502 Assembly Language on macOS more enjoyable, especially for retro-coding the Atari Computer and Atari 2600 VCS.
Copy the contents of the Sublime folder to your Packages/User folder (e.g., ~/Library/Application Support/Sublime Text 3/Packages/User). Edit AtariTools.sh to configure the paths of your installed emulators and build tools. See below for the other tools you'll need.
The Atari800 theme provides the classic Atari blue-colored background and bluish-white text, plus extra color-coding used by the syntaxes for AtariBASIC and bAtariBASIC.
In order to edit Atari BASIC (.LST) files you'll need to install the free Atari Classic fonts (see below). Tgese provide full ATASCII support by mapping the special characters to the Unicode user-defined area. Special ATASCII characters are automatically translated when passing code to and from the emulator.
AtariTools.sh is the common location where you'll set up the paths to your tools and other settings. Use this file to set the path to atari800 (default is MacPorts /opt/local/bin), the path to your HardDrive1 folder, preferred Atari 800 emulator, emulation settings, etc. For the Atari 800, you can mount up to 2 floppy disk images. (At least one floppy is required to get a DOS loaded.)
For bAtariBASIC, the $bB environment variable should already exist, but it can be set or overridden here if needed.
Settings suitable for 6502 code. Applies to .asm and .s files.
A pretty smart syntax parser for Atari and Apple 6502 code with some fixes compared to others.
- Parses well-formed
dasm,ca65, and Atari 8-bit syntax. - Mostly good at auto-finding the end of valid commands, so it can parse code with implicit comments (e.g., Apple DOS).
- Includes
syntax_test_6502.asmto test the markup with Sublime PackageDev (Cmd-B).
Syntax coloring for .lnk files (used with ld65 -C).
Uses 'dasm' with the 'vcs' libraries to build the active 6502 source file for the Atari 2600 and run it in the configured emulator. This is the preferred build method during game development. It doesn't (currently) kill previous instances of atari800, so be sure to quit them to ensure they don't pile up!
To help with the development of bAtariBasic, I've created a proper Github fork of bAtariBASIC where I'm cleaning up code, fixing bugs, and integrating 64K support by RevEng (v39 2017-01-08). I highly recommend working with this fork as it goes forward.
Settings for bAtariBASIC (.BAS) files, including the use of the Atari800 theme (no special font) to gain the extra syntax highlighting.
Context-aware syntax coloring of bAtariBASIC 1.1 syntax with built-in error-checking. (work-in-progress)
AtariTools includes AtariBASIC syntax parsing/coloring and a build command to run AtariBASIC in your preferred Atari 800 emulator.
This file provides the hook for Sublime to use the Atari800 theme for .LST files, defines rulers at multiples of 38/40 characters, and a max length ruler at 254 characters. If the Atari Classic (Regular) font is installed, it will be used. (This font is needed for proper ATASCII support in Sublime.)
This syntax provides context-aware syntax coloring of AtariBASIC with built-in error-checking. It makes the code much more readable with standard code fonts, but of course it looks best with Atari800.tmTheme. A work in progress, it needs better expression handling.
This adds Tools > Build System > AtariBASIC to the menu so you can use Build Command-B to load and run the active LST file in your favorite Atari 800 emulator.
The Build command will run the current BASIC file in atari800 or Atari800MacX, depending on what you last selected under Build With…. Make sure your atari800 and Atari800MacX default settings have BASIC enabled, a local folder exposed as hard drive H:, and up to two floppies mounted for development purposes.
Build saves a copy of the current file with ATASCII encoding as SUBLIME.LST to your configured Atari hard drive (H:) folder. The emulator then loads and runs H:SUBLIME.LST directly for fastest file loading. At this stage you can toggle Turbo in the emulator to speed things up.
Edit this file! The AtariTools.sh file contains the configuration values and file paths that will be used by the helper scripts. Provide paths to your emulators and your "H1:" hard drive folder.
Used by the Build command to convert bAtariBASIC code to Assembly and compile it with dasm.
Used by the Build command to do a standard build for the Atari 2600 using dasm.
Used by the Build command to run AtariBASIC code in the emulator you have configured in the AtariTools.sh script.
Build and run Atari Assembly Language code with ca65 / cl65.
This wrapper for atascii is used to pipe "P:" device output from atari800 or Atari800MacX to Sublime Text (subl).
- Configure the
atari800"Print Command" to use this script. - Configure the
Atari800MacX"Print cmd" to use this script.
Native binary of atascii.cpp to convert ATASCII <-> Unicode with ATASCII extensions.
Python version of atascii converted from C++ with assistance from Mistral-small-3.2-24b.
The C++ source code of atascii which converts ATASCII <-> Unicode. Requires unistd.h, stdio.h, stdlib.h, libgen.h.
WIP - Tokenizer to compile AtariBASIC (.LST) text into .BAS format.
WIP - Loader, tokenizer, and interpreter for AtariBASIC written in Python. It can load and list BAS files in tokenized form but it currently has no tokenizer or interpreter. See basic.py -h for command-line options.
Script to read a structured Atari XEX, COM, or BIN file and display its contents. See xexinfo.py -h for command-line options.
This file, set up for a 2600 cartridge build, is used by Atom's standard Build package to specify the project build command and error pattern. Use the AtomBuild folder as a template for other 2600 code builds. For some cases make might be preferable.
- Fast build with
dasm.- Set
asm_namein.atom-build.js. Then it will build withF9(and build-on-save, if set). Passes all errors back to the build module. - Uses
/usr/localinstall of 'dasm' and 'vcs' to build the project. Change if needed. - Public domain 2600 combat game source code included for testing.
- Set
- Sublime Text 3 - A light and fast extensible editor with a Python core. Can use TextMate bundles.
- atari800 - A good, working Atari emulator that fails much of the acid test but runs pretty well. (Use F1 for settings!) Also available via package managers like MacPorts and Homebrew.
- Atari800MacX - This nice Mac UI wrapper for Atari800. There's a Universal version 6.0.1 but sometimes 5.3.1 seems to work better.
- Atari Classic Fonts - Regular, Chunky, Smooth, and ExtraSmooth - especially for use with
Atari800.tmTheme. Use the newest all-in-one font for full ATASCII support. - Eightbit-Atari-Fonts - Many more Atari custom fonts for use with
Atari800.tmTheme. - dasm - A 6502 cross-assembler most commonly used to build Atari 2600 code. Also included with bAtariBASIC.
- cc65 - A C cross-compiler for many 6502 platforms. A rich set of libraries is included.
- ca65 - A 6502 macro-assembler, also including headers for many 6502 platforms.
- Atari tools - Includes the
atrcommand-line tool to manage ATR disk images and files.
Python is a great language for quick implementations and it's natively supported in Sublime Text.
- Sublime Importer to convert Atari BASIC tokenized files.
- Tokenizer for AtariBASIC so no emulator is needed to convert LST to BAS.
- Interpreter to run and debug AtariBASIC in other environments.
- Better support for Batari Basic in the macOS ecosystem.
- Tools: Character, Map, Player/Missile, and Bitmap editing tools.