# PySys-Basics

**Repository Path**: joy_2_0/py-sys-basics

## Basic Information

- **Project Name**: PySys-Basics
- **Description**: PySys-Basics 是一个用于理解计算机系统底层机制的轻量级学习示例项目。内容涵盖二进制数据处理、简单指令执行过程模拟以及基础汇编文件解析。该项目以可运行的 Python 脚本为核心，通过最小实现展示底层系统从 二进制 → 汇编 → 执行逻辑 的基本路径，适合作为计算机系统基础、自制 CPU 模拟器入门、以及编译与体系结构课程的实验原型。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-25
- **Last Updated**: 2025-11-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 计算机系统基础, 二进制, 指令集, 汇编

## README

# PySys-Basics

PySys-Basics 是一个面向计算机系统初学者的基础示例项目，通过简洁的 Python 实现展示二进制输入、汇编代码与执行逻辑之间的基本联系。项目包含三个核心组件：二进制输入文件、RISC-V 风格的汇编示例、以及用于解析与处理这些数据的 Python 脚本。

---

## 📌 Included Modules / 模块说明

### 1. computer_system.py  
用于模拟最小计算机系统执行逻辑，接受二进制输入并基于既定规则进行处理。该脚本可作为理解指令执行路径、数据流转与底层运算过程的起点。

### 2. binary.txt  
包含示例二进制数据，如指令编码或内存布局片段，用于驱动系统模拟脚本。文件中的值可被替换，以测试不同输入下的执行行为。

### 3. source.s  
RISC-V 风格的汇编代码示例，展示基本指令格式（如 `lui`, `addi`, `sw`, `add` 等），用于辅助理解二进制映射、寄存器操作与简单汇编语义。

---

## 🚀 Usage / 使用方式

1. 将 `binary.txt` 与 `source.s` 保持在项目根目录。
2. 运行以下命令执行系统模拟：

```bash
python computer_system.py