Metadata-Version: 2.4
Name: taracpu
Version: 1.3.4
Summary: C compiler, assembly simulator and FPGA tools for the TARA16 teaching processor.
Author: Ayon Chakraborty
License-Expression: GPL-3.0-or-later
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt5>=5.15
Requires-Dist: matplotlib>=3.5
Requires-Dist: pyserial>=3.5
Dynamic: license-file

# TARA Studio

TARA Studio is a desktop app for learning computer architecture with the TARA16
processor. TARA stands for Teaching Architecture for RISC Assembly. The app
combines a C compiler, an assembly simulator and tools for working with an FPGA.

## What you can do

**C compiler:** Write C programs, compile them and view the generated assembly.
Send the result to the simulator or export it. The compiler supports a small
16-bit C dialect and comes with example programs.

**Assembly simulator:** Write and assemble TARA16 programs. Run them or step
through one instruction at a time. View registers, memory, machine code and the
64 × 64 pixel display. Examples include basic exercises, sorting, graphics and games.

**FPGA tools:** Connect to a TARA16 processor on a supported FPGA board. Load
programs, run them and inspect memory. A simulator memory target is available
for use without a board.

## Install and run

Requires Python 3.9 or later.

```bash
python -m pip install taracpu
taracpu
```

The C compiler is included. FPGA board programming uses openFPGALoader and
requires a suitable bitstream.

A [browser simulator](https://cse.iitm.ac.in/~ayon/courses/CS2300/taracpu/)
is also available.

## Author and license

Developed by Ayon Chakraborty, IIT Madras.
Licensed under GPL-3.0-or-later.
