*********************************************************************** ** T h e C r a w l y C r y p t C o l l e c t i o n ** * P r e s e n t s * ** Programming Files ** *********************************************************************** ************************************************************************* ** Programming Books and References in ASCII ** ** \PROGRAM\BOOKS\ ** ************************************************************************* 68K_BOOK Atari ST Machine Specific Programming In Assembly - A complete book (in ASCII format) by Robert C. Arp, Jr. A comprehensive guide to assembly programming on the ST. Goes from VERY basic to advanced GEM programming. Includes several illustrations in both IMG and PS format. Also has viewer program for illustrations. 68K_CRIB A couple of "crib notes" containing useful information about commonly used aspect of 680x0 assembly language. The "crib notes" are in Degas (*.PI3) format and should be printed out. ALW2 Assembly Language Workshop vol. 2 by Clayton Walnum - now shareware! This is the COMPLETE text of the book. It is now SHAREWARE. Obtained directly from Delphi where Clayton is a sysop! ARGV GEMDOS EXTENDED ARGUMENT (ARGV) SPECIFICATION. In a discussion about Pexec & command lines, the question of the ARGV standard came up. Here are the docs for it. Dated August 22, 1990. Includes example source code. BLIT Complete programmer's guide to the Blitter chip - in ASCII format. This guide should provide all the information you need to program the blitter chip. CMDMENTS List of 'commandments' from the CODEHeads telling how to PROPERLY steal OS vectors for your own use. A 'MUST READ' for all ST programmers. DSKTPINF This archive contains two text files which tell "everything there is to tell" about the DESKTOP.INF file format. Now you can customize your desktop.inf file. ERRATA1 A huge compilation of corrections and additions to The Atari Compendium by SDS Publishing. The Compendium is the most complete and comprehensive programming refernce book available for the ST/TT/ Falcon! GDOS All you ever wanted to know about GDOS - by Douglas Wheeler. This document is in ASCII format. GEMDOS ASCII file that explains how to program with GEMDOS. MC68KTU2 A 68000 assembly programming tutorial series, text in First Word format. OS The Operating Sytem of the Atari ST by John Ogawa is an article that describes the workings of the Atari ST's operating system. It gives a history of TOS & an overview of what each part of TOS (BIOS, AES, VDI, etc) does. PEXEC The Pexec Cookbook by Allan Pratt (Atari). This document completely explains the uses of the Pexec() call. Appended to the this doc are some comp.sys.atari.st articles on the subject of program calling. PROGEM Entire set of 'Professional GEM' tutorial articles written by Tim Oren. Includes C source code examples by John Brochu (author of PICSWITCH). Learn how to write a LEGAL GEM program. VERY good & detailed. UNIXMODE Details on implementing the UNIXMODE Extended Filename Standard which provides a uniform, user-controlled way of mapping filenames which do NOT exceed the GEMDOS restrictions on length and case to the names which are GEMDOS legal. XHDI_110 This is the third edition of the XHDI programmer's specification. This folder contains: the XHDI specification in English and German, bindings for Pure/Turbo C, and a sample XHDI aware application. ************************************************************************* ** Compilers, Assemblers, Disassemblers, Resource Editors, Etc. ** ** \PROGRAM\COMPILER\ ** ************************************************************************* AS32 AS 32 is an Intel 8031(2)/8051 cross assembler by Ken Stauffer (University of Calgary) / ported to the ST by Ate Brink (Utrecht University - The Netherlands). Now you can create Intel programs on the ST. BCF BC-FORTRAN77 version 1.3C by Andre Koestli is an extensive Fortran development system. The purpose of this version is to make a great FORTRAN77 compiler available for programmers. Contains complete ENGLISH documentation! BOB13ST David Betz's Tiny Object-Oriented Language from DDJ Sept 91. Full source code is included. CL098ST CLASS, The Clark Cross Assembler/Disassembler Ver 0.99b by Lutz Vieweg is a cross assembler that creates object code for the "Clarke processor" that is found in such machines as the HP48sx. Includes complete ENGLISH documentation. CLISP CLISP names this implementation of COMMON LISP for the Atari ST. LISP is a programming language that was invented by J. McCarthy in 1959. It's applications are in the domains of symbolic knowledge processing (AI), numerical mathematics, and commercial programs like editors (EMACS) and CAD (AUTOCAD). English docs. CPXBAS1B A CPX module by Oliver Teuber that contains a complete working implementation of David Gillespie's Chipmunk BASIC 1.0. Includes an ENGLISH doc file describing all commands. ELAN1V5 The Elan programming language version 1.5 - developed in 1974 at the Technical University of Berlin as an alternative to Basic. This is a full ST implementation of Elan. F2C This folder contains an Atari ST/TT implementation of a Fortran-to-C converter, developed by AT&T Bell Laboratories and Bellcore. It will take a Fortran source file and convert it to a C source file. F77 A Compiler-Driver by U. Bartelt for Fortran compilers. This driver program is Freeware and requires the BC Fortran 77 compiler version 1.3c. FASBIN21 The Frankenstein Cross Assemblers v2.1. Provides support for about 20 different processors and micro-controllers. Complete manuals for the different assemblers are provided in DVI & ASCII format. The manuals are in ENGLISH! Includes complete source code to all the cross assemblers so you can customize them or add support for a different processor. HSC140 Ian's Heat-and-Serve C version 1.40. THIS IS A MODIFIED VERSION OF SOZOBON C! This version has been customized by Ian Lepore, and is NOT an official release of Sozobon, Ltd. Includes extensive ENGLISH documentation. M2POSX14 Modula-2 Posix 1.4, Implementation einiger POSIX-Systemaufrufe in Modula-2 NASM20B NASM version 2.0 is a cross-development package for 6502 computers. Includes a cross-assembler, linker librarian, disassembler and more for the 6502. Now you can develop 6502 based programs on your ST. Includes complete C source code. ORCS Ottos' Resource Construction Set. A very good RSC editor from Germany. Includes a built in icon editor. One of the best RSC editors around - although not as good as Interface. PBUG1_21 Peace Debug version 1.21 - a low level debugger from Germany - includes English documentation for most of the package. PC_220 PureC-Shell version 2.20 by Frank Schramm is a shareware replacement shell for use with Application Systems Heidelberg's Pure C programming package. All docs are in German. PROFILE Program by David Rowley that monitors another program and reports what percentage of time the monitored programs spends in each routine. This can let you see what parts of your program may need optimizing. RATFOR A Fortran pre-compiler for use with BC-Fortran 77. REASS_US Cross assembler/disassembler for many 8 bit processors - includes complete source code so you can modify it to suit your needs. This is the 8-bit hackers dream come true. SOZOBON Sozobon (NO BOZOS backwards) C compiler version 2.0. This folder includes the complete compiler, English documentation, and the source code for the compiler. STJO2122 Oberon-2 compiler version 1.22 for the Atari ST, restricted version. Documentation provided as ascii (all German). The Linker doesn't optimize the code in this restricted version. SZADB21B Sozobon ADB style debugger version 2.1mj. This folder contains the executable programs and documentation. Szadb is a low level (assembly language) symbolic debugger for Atari computers with a user interface mimicking, to a great extent, a popular Un*x adb. Atari version allows for debugging of GEM programs by providing separate program and debugger screens which can be exchanged by a keypress. TMPMN201 Templemon version 2.01 by Johannes Hill & Thomas Tempelmann is a machine language monitor and debugger for the Atari 680x0 computers. The program and docs are in German. VICI_102 VICI version 1.02 for Atari the ST,TT by Peter Seitz is an Eiffel interpreter. Now you can write programs in the EIFFEL language and run them on your ST. Includes the interpreter/ compiler & example EIFFEL source code! ************************************************************************* ** Graphics And Digital Sound Programming Information ** ** \PROGRAM\GRFX_SND\ ** ************************************************************************* AUDIO An ASCII document that gives complete information about various digital sound formats including *.WAV, *.VOC, *.AVR, and *.MOD. If you are planning to do any work with digital sound you NEED this document! DEGAS_LD Well commented Assembly source code for a Degas picture viewer that will load and display a Degas file in all ST compatible resolutions. DSC_S1 Complete, well commented assembly source code that demonstrates how to load Degas, Degas Elite, and NeoChrome format picture files. Includes a text tutorial file that explains the file formats of those graphics files. GIF89A Official specification for GIF (Graphics Interchange Format) version 89a. This is the complete programming reference provided by CompuServe, the originators of GIF. IFF_DOCS "EA IFF 85" Standard for Interchange Format Files by Jerry Morrison of Electronic Arts. The IFF graphics format is an attempt to create a file format for graphics that is program independent, compiler independent, machine independent, and device independent. This is complete documentation of the IFF standard. IMGSPECS Understanding color IMGs by Dr. Bob is a description of IMG file formats, bi-level and color. The IMG standard from DRI is composed of a file header and encoded (or not encoded) bit-image data. MUSIC_S Heavily commented assembly source code to the "madmax" music playback routines. Includes several sample song files to experiment with,. PICFRMT April 9, 1990 version of documentation compiled by David Baggett detailing the NEO, Degas [+Elite], Tiny, Spectrum, Art Director, C.O.L.O.R., Doodle, GEM, STAD, IFF, MAC, and many more graphic file formats. PLAYBACK Program and source code by Tristan Hunting to play back digitized sounds at variable rates using interrupts. Source in assembly, C, and various Basics. Q_SOURCE Example GFA Basic source code that demonstrates how to play back Quartet digital song files on the ST. SPECOUT C routines to create a SPECTRUM 512 file. Includes documentation, source code, and example program. It does a very good job of documenting the Spectrum format (both file and screen) and explaining how it all works. All files written by John Rosenberg. TCBTRACK Complete assembly source code for playing back TCB (The Care Bears) Soundtracker digital music files. While this code appears to be functional, it is NOT commented at all. TIFFLIB A collection of Pure/Turbo C sources for using the TIFF graphics format. These routines are designed to hide as much of the details of TIFF as possible so that the "dirty work" is transparent to the programmer using these routines. ************************************************************************* ** Hardware Projects ** ** \PROGRAM\HARD_PRJ\ ** ************************************************************************* 144_NEWL Complete instructions by Wes Newell for installing a high density (1.44 meg) floppy in any Atari ST. Originally posted as a public message in the AtariNet tech echo. 2_5RAM A 2.5 MegaByte RAM Expansion for the Atari ST by Christopher Hicks. This document details the addition of an extra 2 Megs of RAM to a standard 520/ 1040 STF/ STFM. This procedure should work for any motherboard revision. 38400BPS A hardware project by Jrgen Meyer that will give every ST / STe a 38400 serial port. This upgrade consits of a TTL-chip, the 74LS74 (and a switch to choose the high baudrate) and is very easy to install. 4JADAPT Plans to build an adapter that lets you use 4 joysticks with the ST. The 2 extra joysticks connect through the parallel port and will work with many games (including "Leatherneck"). AUDIO Adding Audio Ports To An ATARI ST by William Mills. A hardware project that allows the ST to be connected to a stereo or amp using standard RCA connectors. It also allows the use of headsets, for video games. FADEFIX Instructions to fix a common problem with Atari SM124 monochrome monitors. Most SM124s have an insufficently regulated power supply which allows the 70 volt line to drift high when less than a certain number of pixels are lit. FLOP14ST Complete plans that show how to add a 1.44 meg floppy disk drive to your ST. Replace that old 720K floppy with a new high density floppy drive today! NEXMSYNC NEC MultiSync II to Atari ST by David S. Weaver. This archive contains a text file that describes how to build a switch box to connect the MultiSync to the ST to allow use of color or monochrome with the flick of a switch. RGBTOCOM Atari RGB to Composite Video Converter by Anees Munshi. Complete docs & schematic to build a device that converts an ST analog RGB signal to an NTSC composite signal which can be displayed on a composite monitor, or TV. TOS206IN Instructions to install TOS 2.06 in an ST without using a TEC board or a TAB board. ************************************************************************* ** Hardware Information and References in ASCII ** ** \PROGRAM\HARD_REF\ ** ************************************************************************* DMA Complete docs describing how to talk to the DMA port, the ICD Adscsi+ host adapter, etc. DMA_DOCS Doc file from Supra describing the DMA port and how to access it. Also details bopot sector information. Includes source code examples. EXE_TIME An English document that details the time required to execute all 68000 assembly instructions. Very usefull if you want to add up how much time one group of instructions will take to execute compared to another group of instructions. HARDWARE Complete description of all ST/STe/Mega STe/TT/Falcon hardware registers in ASCII and Atari Works foramt IO This document by Douglas P. B. Renaux details the hardware and software aspects of the ST Cartridge port. Dated Feb. 27, 1986 MEMMAP A simple memory map of the 520ST. Not very comprehensive but does give a rough idea of where everything is mapped out to. SM124 This archive contains the complete schematics for the Atari SM124 Monochrome monitor. The schematics are in *.IMG format. View and/or print with GEM-View, Calamus, Touchup, etc. THEREF THEREF is a comprehensive Directory of Hard Drives, Floppy Drives, Optical Drives, and Drive Controllers & Host Adapters. It is designed to help the novice and pro alike with integration problems and system setups. ************************************************************************* ** Miscellaneous Programming Files ** ** \PROGRAM\MISC\ ** ************************************************************************* ASCIICPX ASCII Table by Dietmar Rabich [March 2, 1991] is a CPX module that shows all ASCII characters along with their hexadecimal, decimal, and binary values. A very handy tool for programmers. ATA_LX02 Atari Linux patchlevel 02 of 01-May-94 is a clone of the Unix operating system. This is a complete source code release. GNU-C and MinixFS are required to compile and use this release of Linux. MFS606S This is a pre-alpha version of minixfs. It is source only because it's likely to be buggy, and if you don't know how to compile a program then it isn't for you. Docs are in a mess: they are being revised. SED_5_64 SED version 5.64 by Anton Stepper and Claus Brod is an all purpose monitor for the Atari ST and TT. Program and docs are in German. TN_PCALC Take Note Programmer's Calculator version 1.0 by John L. Jacobi is a very good calculator which will run as a desk accessory or as a program. Has way too many features to list - suffice it to say it is a top notch professional calculator.