# 04 - Proceso de Instalación de macOS

## 🎯 Objetivo

Instalar macOS Sequoia (o versión elegida) en tu PC con hardware Hackintosh.

---

## 📋 Pre-Instalación - Checklist

### Antes de Arrancar el USB

- [ ] **BIOS configurado** según [01-bios-settings.md](01-bios-settings.md)
- [ ] **USB instalador creado** con EFI OpenCore
- [ ] **Verificado SSDT-AWAC.aml** en EFI/OC/ACPI (CRÍTICO)
- [ ] **Verificado boot-arg `agdpmod=pikera`** en config.plist
- [ ] **Disco destino** preparado (mínimo 80GB recomendado)
- [ ] **Conexión a Internet** (Ethernet preferiblemente)
- [ ] **Teclado USB** conectado
- [ ] **Monitor** conectado a la GPU AMD RX 6800 XT

### Particionamiento del Disco

**Opción A: Usar todo el disco** (Recomendado para instalación limpia)

**Opción B: Dual Boot con Windows**

1. En Windows, abrir **Disk Management**
2. **Shrink** una partición (mínimo 100GB)
3. Dejar el espacio **sin asignar** (no formatear)

---

## 🚀 Paso 1: Arrancar desde el USB

### 1.1 Conectar USB y Arrancar

1. **Conectar el USB instalador**
2. **Encender el PC**
3. Presionar **F8** repetidamente para **Boot Menu**

### 1.2 Seleccionar el USB

En el Boot Menu ASUS:
```
Boot Option #1: UEFI: <nombre del USB>
```

Seleccionar con Enter.

---

## 📱 Paso 2: OpenCore Picker

Deberías ver el **OpenCore Boot Picker**:

```
OpenCore 0.9.7

macOS Installer
Recovery
```

### Si NO ves el OpenCore Picker:

1. Verificar que EFI/OC/ está en el USB
2. Verificar config.plist
3. Verificar configuración BIOS
4. Consultar sección de **Solución de Problemas** abajo

### Seleccionar "macOS Installer"

Con las flechas, seleccionar **"macOS Installer"** y presionar **Enter**.

---

## ⏳ Paso 3: Carga de macOS

### 3.1 Apple Logo

Verás el logo de Apple con una barra de progreso.

**Tiempo**: 2-5 minutos

### 3.2 Si se reinicia automáticamente

Esto es **NORMAL**. OpenCore recargará el instalador.

```
Primera carga: Puede reiniciar 1-2 veces
```

---

## 🖥️ Paso 4: Pantalla de Instalación

### 4.1 Selección de Idioma

```
Choose your language: Español (o preferencia)
Click en la flecha
```

### 4.2 Utilidades de macOS

Deberías ver **"macOS Utilities"**:

```
- Restore from Time Machine Backup
- Reinstall macOS
- Get Help Online
- Disk Utility
```

---

## 💽 Paso 5: Disk Utility (Formatear Disco)

### 5.1 Abrir Disk Utility

Click en **"Disk Utility"** → **Continue**

### 5.2 Seleccionar el Disco Destino

En la columna izquierda, seleccionar el disco donde instalarás macOS.

**⚠️ IMPORTANTE**: Seleccionar el disco **completo**, no una partición.

### 5.3 Borrar y Formatear

1. Click en el botón **"Erase"** (Borrar)
2. Configurar:

| Campo | Valor |
|-------|-------|
| **Name** | Macintosh HD |
| **Format** | APFS |
| **Scheme** | GUID Partition Map |

3. Click en **"Erase"**

### 5.4 Verificar

Deberías ver:

```
Macintosh HD
  - Macintosh HD - Data
  - Preboot
  - Recovery
```

### 5.5 Cerrar Disk Utility

Click en **"Done"** → **"Disk Utility"** → **Quit Disk Utility**

---

## 📦 Paso 6: Instalar macOS

### 6.1 Elegir "Reinstall macOS"

De vuelta en macOS Utilities:
```
Click en: Reinstall macOS Sequoia
Click en: Continue
```

### 6.2 Aceptar Términos

Click en **"Agree"** → **"Agree"** nuevamente

### 6.3 Seleccionar Disco

```
Select the disk where you want to install macOS:
Macintosh HD
```

Click en **"Install"**

### 6.4 Iniciar Instalación

macOS comenzará a copiar archivos:

```
Preparing installation...
Installing macOS...
Time remaining: ~20-30 minutos
```

### 6.5 Primer Reinicio

Durante la instalación, el sistema se reiniciará **automáticamente**.

**IMPORTANTE**: Al arrancar después del reinicio:
1. **Presionar F8** para Boot Menu
2. **Seleccionar el USB** otra vez
3. **NO seleccionar** el disco duro todavía

---

## 🔄 Paso 7: Continuación de la Instalación

### 7.1 Segunda Carga

El sistema continuará la instalación:

```
Installing: 5 minutes remaining...
Configuración...
```

### 7.2 Segundo Reinicio

Se reiniciará nuevamente.

**Esta vez**:
1. **Presionar F8** para Boot Menu
2. **Seleccionar el USB**
3. En OpenCore Picker, seleccionar **"Macintosh HD"** (no el installer)

---

## 🎉 Paso 8: Primer Arranque - Configuración

### 8.1 Asistente de Configuración

Verás la pantalla **"Hello"** con diversos idiomas.

```
Continúa con la configuración inicial:
1. País o región: Argentina (o tu país)
2. Teclado: Spanish - ISO o ANSI
3. Red: Seleccionar Ethernet (AppleIGC debería funcionar)
4. Transferir información: Not now
5. Apple ID: Puedes saltar este paso inicialmente
```

### 8.2 Crear Cuenta

```
Nombre: [Tu nombre]
Nombre de cuenta: [tu_usuario]
Contraseña: [tu_contraseña]
```

### 8.3 Express Setup

```
Location Services: Enable (o Disable si prefieres)
Siri: Enable o Disable
Screen Time: Set up later
```

### 8.4 Finalizar

El sistema preparará tu escritorio...

---

## 🔧 Paso 9: Post-Instalación Inmediata

### 9.1 Verificar Hardware Funcional

Abrir **Acerca de este Mac**:

```
Apple menu () → Acerca de este Mac
```

**Verificar**:
- [ ] CPU: Correcta
- [ ] Memoria: 32GB mostrados
- [ ] Gráficos: AMD RX 6800 XT
- [ ] Serie/UUID: Correctos (SMBIOS)

### 9.2 Verificar Red

```
Ajustes del Sistema → Red
```

**Ethernet**: Debería mostrar "Conectado"
**Wi-Fi**: Puede no funcionar todavía (requiere AirportItlwm)

### 9.3 Verificar Audio

Reproducir un sonido desde Preferencias del Sistema → Sonido

---

## 🐛 Solución de Problemas

### Problema: Kernel Panic (Pantalla con texto vertical)

**Causas comunes**:
- CFG Lock no deshabilitado
- config.plist incorrecto
- Kexts faltantes

**Soluciones**:

1. **Agregar boot-args de depuración**:

En config.plist → Boot → NVRAM → Add → boot-args:
```
-v keepsyms=1
```

2. **Verificar CFG Lock**:
```
config.plist → Kernel → Quirks:
  AppleCpuPmCfgLock: YES
  AppleXcpmCfgLock: YES
```

3. **Verificar Kexts**:
```
Asegurarse de tener:
- Lilu.kext
- VirtualSMC.kext
- WhateverGreen.kext
```

### Problema: Pantalla negra después de Apple logo

**Soluciones**:

1. **Verificar WhateverGreen.kext**
2. **Agregar boot-arg**:
```
-v agdpmod=pikera
```

3. **Verificar GPU en DeviceProperties**:
```
config.plist → DeviceProperties → Add
PciRoot(0x0)/Pci(0x2,0x0)
```

### Problema: Se reinicia constantemente

**Soluciones**:

1. **Deshabilitar XMP** en BIOS temporalmente
2. **Verificar Cpuid1Data** para Raptor Lake
3. **Probar con SMBIOS diferente** (MacPro7,1)

### Problema: No detecta red Ethernet

**Soluciones**:

1. **Verificar AppleIGC.kext** está en EFI/OC/Kexts/
2. **Verificar config.plist** → Kernel → Kexts → AppleIGC.kext está enabled
3. **Verificar BIOS** → Network Stack está habilitado

### Problema: No funciona Wi-Fi

**Soluciones**:

1. **Verificar AirportItlwm.kext** está presente
2. **Verificar versión compatible** con tu macOS
3. **Alternativa**: Usar itlwm.kext + app Helios

### Problema: No funciona Audio

**Soluciones**:

1. **Verificar AppleALC.kext** está presente
2. **Probar diferentes layout-id**:
   - 1, 3, 5, 7, 11, 13, 28, 99
3. **Usar Hackintool** para detectar layout correcto

---

## 📋 Checklist Instalación Completada

- [ ] macOS instalado en el disco
- [ ] Primer arranque completado
- [ ] Cuenta de usuario creada
- [ ] Ethernet funcionando
- [ ] Gráficos AMD RX 6800 XT detectados
- [ ] Audio funcionando (o configurado)
- [ ] SMBIOS correcto en "Acerca de este Mac"

---

## 🎯 Próximos Pasos

### Instalar EFI en el Disco (Obligatorio)

Actualmente estás arrancando desde el USB. Necesitas copiar el EFI al disco.

1. **Arrancar desde USB**
2. **Montar EFI del disco**:
```bash
# En Terminal
diskutil list
# Identificar tu disco (ej: disk1)
sudo diskutil mount disk1s1
```

3. **Copiar EFI**:
```bash
# Desde el USB EFI al disco EFI
sudo cp -R /Volumes/EFI/OC /Volumes/DESTINO_EFI/OC/
```

4. **Verificar**:
```bash
ls /Volumes/DESTINO_EFI/OC/
```

5. **Reiniciar y arrancar desde el disco** (sin USB)

---

**Siguiente paso: [05 - Post-Instalación](05-post-install.md)**
