OSX-KVM - November 2021 Batch Update #1

Changes:

- Fixed `mac_hdd_ng.img` name in docs (jturnism)

CREDITS.md

@@ -128,4 +128,6 @@
 
 - https://github.com/thiagokokada - Makefile to improve usability
 
+- https://github.com/jturnism - doc fixes
+
 Note: Individual files have more specific 'credits' in them.

README.md

@@ -142,7 +142,7 @@ Phenom II X3 720 does not. Ryzen processors work just fine.
   ```
 
 * Create a virtual HDD image where macOS will be installed. If you change the
-  name of the disk image from `mac_hdd.img` to something else, the boot scripts
+  name of the disk image from `mac_hdd_ng.img` to something else, the boot scripts
   will need to be updated to point to the new image name.
 
   ```

References.md

@@ -13,3 +13,7 @@
 * https://github.com/ofawx/VmAssetCacheEnable
 
 * https://dortania.github.io/OpenCore-Install-Guide/troubleshooting/extended/post-issues.html
+
+- https://wiki.archlinux.org/title/QEMU#UNIX_socket
+
+- https://wiki.archlinux.org/title/PCI_passthrough_via_OVMF#USB_controller

boot-passthrough.sh

@@ -46,6 +46,7 @@ args=(
   # 01:00.1 Audio device [0403]: Advanced Micro Devices, Inc. [AMD/ATI] Ellesmere HDMI Audio [Radeon RX 470/480 / 570/580/590] [1002:aaf0]
   #         Subsystem: Sapphire Technology Limited Ellesmere HDMI Audio [Radeon RX 470/480 / 570/580/590] [1da2:aaf0]
   -device vfio-pci,host=01:00.0,multifunction=on
+  # -device vfio-pci,host=01:00.0,multifunction=on,romfile=gpu_original_bios.bin
   -device vfio-pci,host=01:00.1
   # ASMedia ASM1142 USB 3.1 Host Controller (comment out as needed)
   # 03:00.0 USB controller [0c03]: ASMedia Technology Inc. ASM1142 USB 3.1 Host Controller [1b21:1242]

notes.md

@@ -170,6 +170,17 @@ AMD RX 570 GPU (May 2021).
 * To reuse the keyboard and mouse devices from the host, setup "Automatic
   login" in System Preferences in macOS and configure Synergy software.
 
+Note: On `Pop!_OS`, use the `kernelstub` command to change the kernel boot
+arguments.
+
+Note 2: Use [AMD VBFlash](https://www.techpowerup.com/download/ati-atiflash/)
+to dump the AMD GPU bios, and pass on to QEMU. This is especially required if
+your AMD GPU is not starting up properly (resulting in "no signal" on the
+monitor).
+
+Tested GPUs: ZOTAC GeForce GT 710 DDR3 (<= Big Sur), Sapphire Radeon RX 570.
+
+
 UPDATE: Project sponsors get access to the `Private OSX-KVM repository`, and
 direct support. This private repository has a playbook to automate 95% of this
 work in a rugged, consistent manner.
@@ -239,9 +250,12 @@ These steps will need to be adapted for your particular setup.
 
 ### Virtual Sound Device
 
-*Warning: The OpenCore distribution that comes with OSX-KVM already has
-`VoodooHDA OC`. Do NOT mix VoodooHDA with AppleALC. You may want to consider
-HDA passthrough if it is practical or use HDMI audio instead*
+https://github.com/chris1111/VoodooHDA-OC
+
+This kext can be used on macOS 10.12 to macOS Big Sur 11.2 to get emulated
+sound card working. Do NOT mix VoodooHDA with AppleALC. You may want to
+consider HDA passthrough or USB sound card passthrough or use HDMI audio
+instead.
 
 Note: The emulated sound output can be choppy, and distorted. Use Sound Card /
 USB Sound Card passthrough instead.
@@ -249,6 +263,10 @@ USB Sound Card passthrough instead.
 Note: It seems that playback of Flash videos requires an audio device to be
 present.
 
+![USB Sound Card](./screenshots/QHM623_USB_Sound_Card_1.jpg)
+
+This cheap(est) USB sound card works pretty well on macOS.
+
 
 ### Building QEMU from source