The astro8-computer from thecatgentlemen

astro8-computer's Introduction

The Astro-8 is a 16-bit computer design. It has a (almost) working Logisim Evolution circuit, along with an emulator on Windows, Mac, and Linux, for running code at full speed. There is an assembly language, along with a higher level language called Armstrong, plus more which are actively being built by the community.

I created a video about the creation of this and how it works, which you can view here:

Demos

There are some demos for the Astro-8, such as the pong game and a typing program. You can locate those in the folder /example_armstrong_programs/.

Go here for the documentation and more previews for some other demos

Programming

The two most supported ways to program for the computer is using the assembly language or Armstrong.

Documentation

Installation

Windows

Navigate to the most recent release, and download the Windows version
Unzip the downloaded file

Linux

Make sure you have SDL2 installed on your system
Navigate to the most recent release, and download the Linux version
Unzip the downloaded file

From Source

Clone this repository in a command line using git clone https://github.com/sam-astro/Astro8-Computer.git OR by downloading the repository as a .ZIP file and unzipping it to your location of choice
Make sure you have SDL2 installed on your system
Enter the directory Astro8-Computer/Astro8-Emulator/linux-build
Run CMake using cmake .. to generate Unix Makefile
Run make -j5 to generate executable
The executable is Astro8-Computer/Astro8-Emulator/linux-build/Astro8-Emulator

Other projects related to the Astro-8:

These projects are not always compatable with the main branch of the official Astro8-Computer repository. Please read the instructions in their project's repo before using.