A web adaptation of ARCTools originally made in Java.
arc-tools-web is an interactive web-based simulator for the ARC (a subset of the SPARC instruction set) assembly language. Write, assemble, run, and debug ARC assembly code directly in your browser.
- Updates to dated original version of ARCTools written in Java
- Fixed crashes
- Improved code editor
- Improved error handling
- Cleaner UI
- Integrated Assembly Code Editor (using the Monaco Editor)
- Syntax highlighting and auto-completion for ARC assembly language
- Line numbers and error highlighting
- Full Client-Side CPU Simulation
- Complete implementation of the ARC instruction set
- View and modify all 32 general-purpose registers
- Monitor and control program counter, trap base register, and condition codes
- Execute step-by-step or run continuously
- Set breakpoints for debugging
- Memory Inspection
- Up to 4GB memory space, using 4KB page size
- View memory contents in real-time
- Display values in hexadecimal or decimal format
- I/O Simulation
- Console output for program interaction
- Keyboard input support
- File Operations
- Create, open, and save assembly files
- Load pre-assembled binary files
- Automatic assembly of code to machine code
- Debugging Tools
- Step through code instruction by instruction
- Run until breakpoint
- Clear registers and memory
| SETHI/BRANCH | CALL | ALU | MEMORY |
|---|---|---|---|
| sethi | call | add | ld |
| ba | addcc | ldsb | |
| bcc | and | ldsh | |
| bcs | andcc | ldub | |
| be | andn | lduh | |
| bg | andncc | st | |
| bge | jmpl | stb | |
| bgu | or | sth | |
| bl | orcc | halt | |
| ble | orn | ||
| bleu | orncc | ||
| bn | rd | ||
| bne | rett | ||
| bneg | sll | ||
| bpos | sra | ||
| bvc | srl | ||
| bvs | sub | ||
| subcc | |||
| ta | |||
| wr | |||
| xnor | |||
| xnorcc | |||
| xor | |||
| xorcc |
| Instruction | Base Instruction |
|---|---|
| not | xnor param1, %r0, param2 |
| neg | sub %r0, param1, param2 |
| inc | add param1, 1, param1 |
| dec | sub param1, 1, param1 |
| clr | and param1, %r0, param1 |
| cmp | subcc param1, param2, %r0 |
| tst | orcc %r0, param1, %r0 |
| mov | or %r0, param1, param2 |
| nop | sethi 0, %r0 |
Use the simulator directly in your browser without installation: Arc Assembly Simulator
To run the simulator locally:
- Clone the repository:
git clone https://github.com/RivanJarjes/arc-tools-web.git cd arc-tools-web - Install dependencies:
npm install - Start the development server:
npm run dev - Open http://localhost:3000 in your browser
The simulator supports the full ARC instruction set including:
- Arithmetic operations (add, sub, etc.)
- Logical operations (and, or, xor, etc.)
- Memory operations (ld, st, ldub, stb, etc.)
- Branch instructions (ba, be, bne, etc.)
- System calls through traps (ta)
- Frontend: Next.js, React
- Editor: Monaco Editor
- Styling: Tailwind CSS
- Icons: Font Awesome
- The simulator is designed for educational purposes and may not implement all edge cases
- Performance may be limited for very large programs
- Some advanced features of hardware ARC implementations may not be available (most trapping cases for example)
- Add entire SPARC instruction-set
- Add assembly to binary instruction visualizer similar to original Arc-Tools