Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/limitedeternity/yanes
The most hardcore calculator you’ve ever seen
https://github.com/limitedeternity/yanes
6502-processor assembly rust simulator
Last synced: 8 days ago
JSON representation
The most hardcore calculator you’ve ever seen
- Host: GitHub
- URL: https://github.com/limitedeternity/yanes
- Owner: limitedeternity
- License: mit
- Created: 2021-01-17T17:55:56.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-03-01T11:22:03.000Z (almost 3 years ago)
- Last Synced: 2024-12-20T15:17:39.765Z (24 days ago)
- Topics: 6502-processor, assembly, rust, simulator
- Language: Rust
- Homepage:
- Size: 154 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# yanes
> The most hardcore calculator you’ve ever seen
Yanes is a software-based device model (simulator), which implements 6502-like CPU instructions, memory address space, a screen and a keyboard.
## Spec
**OpCodes**: http://www.6502.org/tutorials/6502opcodes.html
**Address Space Layout**:
- CPU Data: **0x0000 – 0x00FF**
- The latest keypress in form of ASCII code is stored at **0x00FF**.
- Stack: **0x0100 – 0x01FF**
- VGA Buffer: **0x0200 – 0x05FF**
* Layout:
* Color Codes:
- Program Space: **0x8000 – 0xFFF0**
- Therefore, max size is **0x7FF0** bytes.
- Programs are executable machine code sequences for this simulator. You can either write one manually using a hex editor of your choice or use an assembler to produce it.
- Reset Vector: **0xFFFC**
- IRQ Vector: **0xFFFE**
- If you want to override `BRK` behavior, you can write an address of your custom procedure there.
In case you want to revert its default behavior (program termination), you just need to null the IRQ Vector.
## Example
Let’s look into the `example/` directory:
This program draws 0 or 1 depending on whether `0` or `1` was pressed on the keyboard.
Let’s compile our example assembly script using my fork of [@jenra-uwu's asm6502](https://github.com/jenra-uwu/asm6502): `asm6502/target/release/asm6502 -o examples/draw_0_or_1.bin -d examples/draw_0_or_1.s`.
After that we can run the compiled program using yanes: `target/release/yanes examples/draw_0_or_1.bin`.
We see, that infinite loop works correctly. Now, if we press `0`:
We'll see a drawn zero. And if we press `1`:
The screen will be cleared and a drawn 1 will appear. To exit Yanes, press `ESC`.
`ESC` key injects `BRK` instruction at the `PC` register position and, therefore, terminates the program. After that, a CPU dump will be printed into the `STDOUT` in form of state of all registers at the moment of program termination:
## Building
1. Install the Rust toolchain using [rustup.rs](https://rustup.rs/).
2. `git clone --recurse-submodules` this repo.
3. Pull your favourite C/C++ compiler ([Windows](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019), [Linux](https://en.wikipedia.org/wiki/You_Know_What_to_Do), [MacOS](https://www.ics.uci.edu/~pattis/common/handouts/macmingweclipse/allexperimental/macxcodecommandlinetools.html)).
4. Run `cargo build --release` there and in `asm6502/` directory.
## Meta
Vyacheslav Bespalov – [Other projects](https://github.com/limitedeternity?tab=repositories)
Distributed under the MIT license. See `LICENSE` for more information.
[@limitedeternity](https://github.com/limitedeternity)
## Contributing
1. [Fork it](https://github.com/limitedeternity/yanes/fork)
2. Commit your changes
3. Create a new Pull Request