Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sam-astro/astro8-computer
Custom 16-bit homebrew CPU, emulator, renderer, circuit, and language
https://github.com/sam-astro/astro8-computer
assembler assembly assembly-language compiled-language computer computer-architecture cpp cpu emulator
Last synced: 2 days ago
JSON representation
Custom 16-bit homebrew CPU, emulator, renderer, circuit, and language
- Host: GitHub
- URL: https://github.com/sam-astro/astro8-computer
- Owner: sam-astro
- License: mit
- Created: 2022-06-05T02:14:18.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-11T05:33:26.000Z (about 1 month ago)
- Last Synced: 2024-12-20T20:10:00.506Z (2 days ago)
- Topics: assembler, assembly, assembly-language, compiled-language, computer, computer-architecture, cpp, cpu, emulator
- Language: C++
- Homepage:
- Size: 301 MB
- Stars: 763
- Watchers: 21
- Forks: 86
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Badge License]][License] [![Button Discord]][Discord Server]
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:
[![Button Video]][Video]
## 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](https://sam-astro.github.io/Astro8-Computer/docs/Demos.html)
## Programming
The two most supported ways to program for the computer is using the [assembly language](https://sam-astro.github.io/Astro8-Computer/docs/Architecture/Instruction%20Set.html) or [Armstrong](https://sam-astro.github.io/Astro8-Computer/docs/Programming/README.html).
## Documentation
[![Button Documentation]][Documentation]
## Installation
### Windows
1. Navigate to [the most recent release](https://github.com/sam-astro/Astro8-Computer/releases), and download the **Windows** version
2. Unzip the downloaded file
### Linux
1. Make sure you have [SDL2 installed](https://wiki.libsdl.org/Installation#supported_platforms) on your system
For debian based operating systems, you can do this with:
```
sudo apt-get install -y libsdl2-2.0-0 libsdl2-mixer-2.0-0
```
2. Navigate to [the most recent release](https://github.com/sam-astro/Astro8-Computer/releases), and download the **Linux** version
3. Unzip the downloaded file
### From Source
1. 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
2. Make sure you have [SDL2 installed](https://wiki.libsdl.org/Installation#supported_platforms) on your system
3. Enter the directory `Astro8-Computer/Astro8-Emulator/linux-build`
4. Run CMake using `cmake ..` to generate Unix Makefile
5. Run `make -j5` to generate executable
6. 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.
* https://github.com/LucasJG1994/Astro8-VM - Astro8-VM BY [@LucasJG1994](https://github.com/LucasJG1994)
* https://github.com/GerardSmit/Astro8 - Astro8 C# and Web emulator BY [@GerardSmit](https://github.com/GerardSmit)
* https://github.com/GerardSmit/Astro8 - Yabal, a high-level C-like language BY [@GerardSmit](https://github.com/GerardSmit)
[Logisim Evolution]: https://github.com/logisim-evolution/logisim-evolution
[Documentation]: https://sam-astro.github.io/Astro8-Computer/
[Video]: https://www.youtube.com/watch?v=Zt0JfmV7CyI
[License]: LICENSE
[Discord Server]: https://discord.gg/9p82dTEdkN
[Badge License]: https://img.shields.io/github/license/sam-astro/Astro8-Computer
[Button Documentation]: https://img.shields.io/badge/Documentation-008FC7?style=flat-square&logoColor=white&logo=GitBook
[Button Video]: https://img.shields.io/badge/Video-c91111?style=flat-square&logoColor=white&logo=YouTube
[Button Discord]: https://img.shields.io/badge/Discord_Server-573f75.svg?style=social&logo=Discord