# machad3x/ryzentosh-5700x-b450-rtx-3080ti architecture

> Architecture diagram of the GitHub repository machad3x/ryzentosh-5700x-b450-rtx-3080ti, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti
- Repository: https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti

## Overview

Este repositório é uma configuração EFI personalizada e guias para instalar e executar macOS Tahoe num PC AMD com GPU NVIDIA. O fluxo principal começa no arranque por USB, segue pela instalação do macOS e cópia da EFI para o disco interno, e continua com a atualização via OCLP e a instalação manual do driver NVK. O README documenta também áudio, rede, Bluetooth e mapeamento USB. Sem excertos de código, as relações abaixo refletem apenas os passos e configurações explicitamente descritos no README; não inferem chamadas internas da EFI.

Main entry points: [`EFI/OC/Kexts`](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts) (Extensões kernel), [`EFI/OC/config.plist`](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/OC/config.plist) (Configuração OC), [`EFI/BOOT/BOOTx64.efi`](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/BOOT/BOOTx64.efi) (Arranque EFI), [`EFI/OC/OpenCore.efi`](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/OC/OpenCore.efi) (OpenCore)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Arranque EFI"]
  node_bootx64["Arranque EFI<br/>[BOOTx64.efi]"]
  node_opencore["OpenCore<br/>[OpenCore.efi]"]
  node_config["Configuração OC<br/>[config.plist]"]
  node_drivers["Drivers EFI"]
  node_resources["Recursos OpenCore"]
end

subgraph group_hardware["Suporte de hardware"]
  node_acpi["Tabelas ACPI"]
  node_kexts["Extensões kernel"]
  node_usbmap["Mapeamento USB<br/>[UTBMap.kext]"]
  node_audio["Áudio Realtek<br/>[AppleALC.kext]"]
  node_ethernet["Ethernet Realtek"]
  node_wifi["Wi-Fi MediaTek"]
  node_bluetooth["Bluetooth MediaTek<br/>[SimpleMtkBtFw.kext]"]
end

subgraph group_install["Instalação macOS"]
  node_installer["Instalador macOS"]
  node_internaldisk[("Disco interno")]
  node_oclp["OpenCore Legacy Patcher"]
  node_tahoe["macOS Tahoe"]
end

subgraph group_gpu["Driver NVIDIA"]
  node_nvk["Driver NVIDIA NVK"]
end

node_user(("Utilizador"))
node_firmware["Firmware UEFI"]

node_user -->|"reinicia e escolhe"| node_firmware
node_firmware -->|"arranca por USB"| node_bootx64
node_bootx64 -.->|"inicia OpenCore"| node_opencore
node_user -->|"seleciona instalador"| node_installer
node_installer -->|"instala Sequoia"| node_internaldisk
node_user -->|"copia EFI"| node_internaldisk
node_user -->|"atualiza e aplica patches"| node_oclp
node_oclp -->|"instala patches"| node_tahoe
node_user -->|"instala manualmente"| node_nvk
node_config -->|"configura carga"| node_kexts
node_config -.->|"configura ACPI"| node_acpi
node_opencore -.->|"usa configuração"| node_config
node_config -.->|"configura drivers"| node_drivers
node_config -.->|"configura recursos"| node_resources
node_kexts -->|"inclui mapa"| node_usbmap
node_kexts -->|"inclui suporte áudio"| node_audio
node_kexts -->|"inclui suporte Ethernet"| node_ethernet
node_kexts -->|"inclui suporte Wi-Fi"| node_wifi
node_kexts -->|"inclui suporte Bluetooth"| node_bluetooth
node_user -->|"mapeia portas"| node_usbmap
node_nvk -->|"fornece driver GPU"| node_tahoe

click node_bootx64 "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/BOOT/BOOTx64.efi"
click node_opencore "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/OC/OpenCore.efi"
click node_config "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/OC/config.plist"
click node_acpi "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/ACPI"
click node_drivers "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Drivers"
click node_kexts "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts"
click node_resources "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Resources"
click node_usbmap "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/UTBMap.kext"
click node_audio "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/AppleALC.kext"
click node_ethernet "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/RealtekRTL8111.kext"
click node_wifi "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/AirportMtkWlan.kext"
click node_bluetooth "https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/SimpleMtkBtFw.kext"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootx64,node_opencore,node_config,node_drivers,node_resources toneBlue
class node_acpi,node_kexts,node_usbmap,node_audio,node_ethernet,node_wifi,node_bluetooth toneAmber
class node_installer,node_internaldisk,node_oclp,node_tahoe toneMint
class node_nvk toneRose
class node_user,node_firmware toneIndigo
```

## Components

### Arranque EFI

- [Arranque EFI](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/BOOT/BOOTx64.efi): `EFI/BOOT/BOOTx64.efi`
- [OpenCore](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/OC/OpenCore.efi): `EFI/OC/OpenCore.efi`
- [Configuração OC](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/blob/master/EFI/OC/config.plist): `EFI/OC/config.plist`
- [Drivers EFI](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Drivers): `EFI/OC/Drivers`
- [Recursos OpenCore](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Resources): `EFI/OC/Resources`

### Suporte de hardware

- [Tabelas ACPI](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/ACPI): `EFI/OC/ACPI`
- [Extensões kernel](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts): `EFI/OC/Kexts`
- [Mapeamento USB](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/UTBMap.kext): `EFI/OC/Kexts/UTBMap.kext`
- [Áudio Realtek](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/AppleALC.kext): `EFI/OC/Kexts/AppleALC.kext`
- [Ethernet Realtek](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/RealtekRTL8111.kext): `EFI/OC/Kexts/RealtekRTL8111.kext`
- [Wi-Fi MediaTek](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/AirportMtkWlan.kext): `EFI/OC/Kexts/AirportMtkWlan.kext`
- [Bluetooth MediaTek](https://github.com/machad3x/ryzentosh-5700x-b450-rtx-3080ti/tree/master/EFI/OC/Kexts/SimpleMtkBtFw.kext): `EFI/OC/Kexts/SimpleMtkBtFw.kext`

### Instalação macOS

- **Instalador macOS**
- **Disco interno**
- **OpenCore Legacy Patcher**
- **macOS Tahoe**

### Driver NVIDIA

- **Driver NVIDIA NVK**

### Other components

- **Utilizador**
- **Firmware UEFI**

## Connections

- Utilizador → Firmware UEFI: reinicia e escolhe (evidence: `README.md`)
- Firmware UEFI → Arranque EFI: arranca por USB (evidence: `README.md`)
- Arranque EFI → OpenCore: inicia OpenCore
- Utilizador → Instalador macOS: seleciona instalador (evidence: `README.md`)
- Instalador macOS → Disco interno: instala Sequoia (evidence: `README.md`)
- Utilizador → Disco interno: copia EFI (evidence: `README.md`)
- Utilizador → OpenCore Legacy Patcher: atualiza e aplica patches (evidence: `README.md`)
- OpenCore Legacy Patcher → macOS Tahoe: instala patches (evidence: `README.md`)
- Utilizador → Driver NVIDIA NVK: instala manualmente (evidence: `README.md`)
- Configuração OC → Extensões kernel: configura carga (evidence: `README.md`)
- Configuração OC → Tabelas ACPI: configura ACPI
- OpenCore → Configuração OC: usa configuração
- Configuração OC → Drivers EFI: configura drivers
- Configuração OC → Recursos OpenCore: configura recursos
- Extensões kernel → Mapeamento USB: inclui mapa (evidence: `README.md`)
- Extensões kernel → Áudio Realtek: inclui suporte áudio (evidence: `README.md`)
- Extensões kernel → Ethernet Realtek: inclui suporte Ethernet (evidence: `README.md`)
- Extensões kernel → Wi-Fi MediaTek: inclui suporte Wi-Fi (evidence: `README.md`)
- Extensões kernel → Bluetooth MediaTek: inclui suporte Bluetooth (evidence: `README.md`)
- Utilizador → Mapeamento USB: mapeia portas (evidence: `README.md`)
- Driver NVIDIA NVK → macOS Tahoe: fornece driver GPU (evidence: `README.md`)
