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.
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
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.
For the most authentic experience editing LST files, free Atari classic fonts (see below) may be installed to get full ATASCII support via the Unicode user-defined area (work-in-progress).
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, to show rulers at multiples of 38/40 characters, and to draw a final ruler at 254 characters. If the Atari Classic Int font is installed, it will be used. (This font will be required for full ATASCII support in future.)
This file provides context-aware syntax coloring of AtariBASIC with built-in error-checking. Syntax coloring makes it even easier to write AtariBASIC and instantly catch syntax errors. Best with Atari800.tmTheme and the Atari Classic fonts.
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 the Atari 800 emulator.
The Build command will run the current BASIC file in atari800 or Atari800MacX, depending on which was last selected. 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.
The Build command saves the current file as SUBLIME.LST in your configured Atari hard drive (H:) folder and tells the emulator to load and run H:SUBLIME3.LST, so file loading is about as fast as it can be.
NOTE: Currently there's no support for Atari special characters, which would require an input method, translation between Unicode and ATASCII, etc. For now, use CHR$ and other techniques to program special characters while this is sorted out.
- Sublime Text 3 - A light and fast extensible editor with a Python core. Can use TextMate bundles.
- Atom - A powerful modular editor. May run sluggishly on older systems.
- 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 - A build from 2012 that mostly works with macOS Sierra - but disable sound or it will crash! (The project needs a new Quartz-based UI and other code updates before building with current Xcode is possible.)
- Atari Classic Fonts - Regular, Chunky, Smooth, and ExtraSmooth - especially for use with
Atari800.tmTheme. The newest all-in-one font is preferred, because it has 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.
- Better support for Batari Basic in the macOS ecosystem. Playfield/sprite tools (web-based, Javascript).