# skyrilhd/fujitsu-esprimo-q956-hackintosh architecture

> Architecture diagram of the GitHub repository skyrilhd/fujitsu-esprimo-q956-hackintosh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skyrilhd/fujitsu-esprimo-q956-hackintosh
- Repository: https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh

## Overview

This repository is a machine-specific OpenCore EFI bundle for the Fujitsu ESPRIMO Q956, rather than an application with editable runtime source. Its principal workflow is to install the EFI folder on a boot partition, let UEFI launch OpenCore, and select a boot option; the README also documents using OpenShell to add an internal-disk boot entry. The bundle includes configuration, ACPI tables, drivers, and kexts for the documented hardware capabilities. The relationships below rely on README statements and filenames; binary behavior was not inspected.

Main entry points: [`EFI`](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI) (EFI bundle), [`EFI/OC/OpenCore.efi`](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/OpenCore.efi) (OpenCore), [`EFI/BOOT/BOOTx64.efi`](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/BOOT/BOOTx64.efi) (Fallback loader), [`EFI/OC/Tools/OpenShell.efi`](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/Tools/OpenShell.efi) (OpenShell tool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["UEFI boot"]
  node_efi["EFI bundle"]
  node_fallback["Fallback loader<br/>[BOOTx64.efi]"]
  node_opencore["OpenCore<br/>[OpenCore.efi]"]
end

subgraph group_config["Boot configuration"]
  node_configplist["OpenCore config<br/>[config.plist]"]
  node_acpi["ACPI tables"]
end

subgraph group_hardware["Hardware support"]
  node_kexts["Kernel extensions"]
  node_audio["Audio support<br/>[AppleALC.kext]"]
  node_network["Wi-Fi and Bluetooth"]
  node_ethernet["Ethernet support<br/>[IntelMausi.kext]"]
  node_graphics["Graphics support<br/>[WhateverGreen.kext]"]
  node_usb["USB support<br/>[USBMap.kext]"]
  node_sleep["Hibernation sleep"]
end

subgraph group_ui["Boot tools and UI"]
  node_drivers["UEFI drivers"]
  node_resources["Picker resources"]
  node_shell["OpenShell tool<br/>[OpenShell.efi]"]
end

node_user(("System operator"))
node_firmware["UEFI firmware"]
node_partition[("EFI partition")]

node_user -->|"copies EFI"| node_partition
node_partition -->|"boots from"| node_firmware
node_firmware -->|"loads fallback"| node_fallback
node_fallback -.->|"starts"| node_opencore
node_firmware -->|"loads directly"| node_opencore
node_opencore -.->|"uses config"| node_configplist
node_opencore -.->|"uses tables"| node_acpi
node_opencore -.->|"loads drivers"| node_drivers
node_opencore -.->|"shows picker"| node_resources
node_user -->|"launches tool"| node_shell
node_shell -->|"adds boot entry"| node_opencore
node_efi -->|"provides audio"| node_audio
node_efi -->|"provides Wi-Fi/BT"| node_network
node_efi -->|"provides Ethernet"| node_ethernet
node_efi -->|"provides acceleration"| node_graphics
node_efi -->|"provides USB"| node_usb
node_efi -->|"enables hibernation"| node_sleep
node_efi -.->|"includes extensions"| node_kexts

click node_efi "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI"
click node_fallback "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/BOOT/BOOTx64.efi"
click node_opencore "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/OpenCore.efi"
click node_configplist "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/config.plist"
click node_acpi "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/ACPI"
click node_kexts "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts"
click node_audio "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/AppleALC.kext"
click node_network "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts"
click node_ethernet "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/IntelMausi.kext"
click node_graphics "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/WhateverGreen.kext"
click node_usb "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/USBMap.kext"
click node_sleep "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/HibernationFixup.kext"
click node_drivers "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Drivers"
click node_resources "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Resources"
click node_shell "https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/Tools/OpenShell.efi"

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_efi,node_fallback,node_opencore toneBlue
class node_configplist,node_acpi,node_partition toneAmber
class node_kexts,node_audio,node_network,node_ethernet,node_graphics,node_usb,node_sleep toneMint
class node_drivers,node_resources,node_shell toneRose
class node_user,node_firmware toneIndigo
```

## Components

### UEFI boot

- [EFI bundle](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI): `EFI`
- [Fallback loader](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/BOOT/BOOTx64.efi): `EFI/BOOT/BOOTx64.efi`
- [OpenCore](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/OpenCore.efi): `EFI/OC/OpenCore.efi`

### Boot configuration

- [OpenCore config](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/config.plist): `EFI/OC/config.plist`
- [ACPI tables](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/ACPI): `EFI/OC/ACPI`

### Hardware support

- [Kernel extensions](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts): `EFI/OC/Kexts`
- [Audio support](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/AppleALC.kext): `EFI/OC/Kexts/AppleALC.kext`
- [Wi-Fi and Bluetooth](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts): `EFI/OC/Kexts`
- [Ethernet support](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/IntelMausi.kext): `EFI/OC/Kexts/IntelMausi.kext`
- [Graphics support](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/WhateverGreen.kext): `EFI/OC/Kexts/WhateverGreen.kext`
- [USB support](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/USBMap.kext): `EFI/OC/Kexts/USBMap.kext`
- [Hibernation sleep](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Kexts/HibernationFixup.kext): `EFI/OC/Kexts/HibernationFixup.kext`

### Boot tools and UI

- [UEFI drivers](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Drivers): `EFI/OC/Drivers`
- [Picker resources](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/tree/main/EFI/OC/Resources): `EFI/OC/Resources`
- [OpenShell tool](https://github.com/skyrilhd/fujitsu-esprimo-q956-hackintosh/blob/main/EFI/OC/Tools/OpenShell.efi): `EFI/OC/Tools/OpenShell.efi`

### Other components

- **System operator**
- **UEFI firmware**
- **EFI partition**

## Connections

- System operator → EFI partition: copies EFI (evidence: `README.md`)
- EFI partition → UEFI firmware: boots from (evidence: `README.md`)
- UEFI firmware → Fallback loader: loads fallback (evidence: `README.md`)
- Fallback loader → OpenCore: starts
- UEFI firmware → OpenCore: loads directly (evidence: `README.md`)
- OpenCore → OpenCore config: uses config
- OpenCore → ACPI tables: uses tables
- OpenCore → UEFI drivers: loads drivers
- OpenCore → Picker resources: shows picker
- System operator → OpenShell tool: launches tool (evidence: `README.md`)
- OpenShell tool → OpenCore: adds boot entry (evidence: `README.md`)
- EFI bundle → Audio support: provides audio (evidence: `README.md`)
- EFI bundle → Wi-Fi and Bluetooth: provides Wi-Fi/BT (evidence: `README.md`)
- EFI bundle → Ethernet support: provides Ethernet (evidence: `README.md`)
- EFI bundle → Graphics support: provides acceleration (evidence: `README.md`)
- EFI bundle → USB support: provides USB (evidence: `README.md`)
- EFI bundle → Hibernation sleep: enables hibernation (evidence: `README.md`)
- EFI bundle → Kernel extensions: includes extensions
