Skip to content

nguillaumin/perihelion-m68k-tutorials

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The Atari ST MC68000 Assembly Language Tutorials

Build Status

This repository contains the text of the tutorials written by perihelion to learn Motorola 68000 development on the Atari ST.

The original tutorials can be found on the Atari Forums

The texts have been converted from the single-page PDF into AsciiDoc, then manually corrected where necessary. The assembly sources have been reformatted and split out in separate files. Apart from minor edits, the text and sources are identical to the originals.

The main motivation to do so were:

  • Have an alternative format to the original PDF

  • Ability to read the tutorials in a browser, in a (hopefully) pleasant font

  • Make it it easier to read on mobile devices / small screens

  • Setup a cross-compilation system for development on a modern machine host to compile the example sources (see src/)

  • Produce an e-book (ePub) for e-readers

  • Have access to the raw text so that it can be shared and improved by other contributors (possibly contribute entirely new tutorials?)

Assembling the examples

The example sources are in src/. They can be cross-assembled using vasm. A Makefile is provided to assemble all examples, as well as building a .st image with all the examples and running it with Hatari.

See the content of the Makefile for details.

To do

A few issues remain:

  • I grabbed some images such as the different sprite operations (AND, OR, etc.) from the original PDF. It would be better to write the programs that generated these images and grab a screenshot instead.

  • The tabs on the code example and source files are a bit too wide, making them hard to read on small screens. They should be reduced.

  • Update the source code to be compatible with Devpac so that it can be compiled on an Atari (remove spaces after commas).

Releases

No releases published

Packages

No packages published

Languages