# ⚡ Pi-DOS & Win-Pi : Guide de Démarrage Rapide

Ce pack contient tout le nécessaire pour transformer votre **Cheap Yellow Display (ESP32-2432S028)** en une station de travail rétro ultime.

## 📦 Contenu du Pack
- **Firmware** : `esp32-firmware.bin` (MicroPython v1.22+).
- **Système** : `pidos.py` (Shell), `win.py` (GUI), `libpidos.py` (API).
- **Drivers** : `cyd.py`, `st7789.py`, `xpt2046.py`.
- **Utilitaires** : `edlin.py` (Editeur), `clavier.py` (Terminal hôte).
- **Environnement** : `requirements.txt` pour configurer les outils de flashage.
- **Scripts** : Flashage et déploiement automatique.

## 🛠️ Installation (Linux/macOS)

### 0. Préparer l'environnement Python
Avant de commencer, créez un environnement virtuel et installez les outils nécessaires :
```bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```

### 1. Préparer le matériel (Flasher MicroPython)
Branchez votre CYD en USB et lancez le script de flashage :
```bash
./flash_cyd.sh /dev/ttyUSB0
```
*Note : Cela effacera tout le contenu actuel du CYD pour installer l'environnement MicroPython propre.*

### 2. Installer les drivers
Une fois MicroPython installé, envoyez les pilotes indispensables :
```bash
./install_drivers.sh /dev/ttyUSB0
```

### 3. Installer Pi-DOS (Système)
Pour que Pi-DOS se lance automatiquement au démarrage, utilisez le script `run_on_cyd.sh` qui va l'installer en tant que `main.py` :
```bash
./run_on_cyd.sh pidos.py
```

### 4. Lancement
Redémarrez le CYD. Le terminal Pi-DOS s'affiche. Tapez `win` pour lancer l'interface graphique.

## ⌨️ Utilisation du clavier PC
Pour taper confortablement depuis votre ordinateur vers le CYD :
```bash
python3 clavier.py
```

## 📖 Documentation détaillée
- [README_PIDOS.md](README_PIDOS.md) : Manuel complet.
- [CYD_HARDWARE_GUIDE.md](CYD_HARDWARE_GUIDE.md) : Détails techniques du matériel.

---
*Amusez-vous bien dans le futur de 1992 !* 🕶️🚀
