19 posts in this topic
Recently Browsing 0 members
No registered users viewing this page.
A New Driver for Realtek RTL8111
Due to the lack of an OS X driver that makes use of the advanced features of the Realtek RTL81111/8168 series I started a new project with the aim to create a state of the art driver that gets the most out of those NICs which can be found on virtually any cheap board on the market today. Based on Realtek's Linux driver (version 8.035.0) I have written a driver that is optimized for performance while making efficient use of system resources and keeping the CPU usage down under heavy load.
Key Features of the Driver
Supports Realtek RTL8111/8168 B/C/D/E/F/G found on recent boards. Support for multisegment packets relieving the network stack of unnecessary copy operations when assembling packets for transmission. No-copy receive and transmit. Only small packets are copied on reception because creating a copy is more efficient than allocating a new buffer. TCP, UDP and IPv4 checksum offload (receive and transmit). TCP segmentation offload under IPv4. Support for TCP/IPv6 and UDP/IPv6 checksum offload. Fully optimized for Mountain Lion (64bit architecture) but should work with Lion too. As of now there is no support for Snow Leopard but it can be added if someone will create the necessary patches. Supports Wake on LAN. Support for Energy Efficient Ethernet (EEE) which can be disabled by setting enableEEE to NO in the drivers Info.plist without rebuild. The default is YES. The driver is published under GPLv2.
As checksum offload doesn't work with jumbo frames they are currently unsupported and will definitely never be. No support for 32bit kernels.
Before you install the driver you have to remove any installed driver for RTL8111/8168.
Goto /S/L/E and delete the old driver (Lnx2mac, AppleRealtekRTL8169, etc.). Recreate the kernel cache. Open System Preferences and delete the corresponding network interface, e. g. en0. If you forget this step you might experience strange problems with certain Apple domains, iTunes and iCloud later. Reboot. Install the new driver and recreate the kernel cache. I recommend to use Kext Wizard or a similar utility for the installation. Reboot Open System Preferences again, select Network and check if the new network interface has been created automatically or create it manually now. Configure the interface.
Help - I'm getting kernel panics!
Well, before you start complaining about bugs after you upgraded macOS and ask me to publish a driver update, you should first try to resolve the issue on your own by cleaning the system caches.
As the driver uses macOS's private network driver interface, which is supposed to be used by Apple provided drivers only, you might run into problems after an OS update because the linker may fail to recognize that IONetworking.kext has been updated and that the driver needs to be linked against the new version (Apple provided drivers avoid this problem because they are always updated together with IONetworking.kext). As a result, the linking process produces garbage and the driver may call arbitrary code when trying to call functions from IONetworking.kext. This usually results in unpredicted behavior or a kernel panic. In order to recover from such a situation, you should clean the System Caches forcing the linker to recreate it's caches:
Delete all the files in /System/Library/Caches and it's subdirectories but leave the directories and the symbolic links intact. This is very important! Reboot. Recreate the kernel cache. Reboot again.
Make sure you have followed the installation instructions especially when you have issues with certain domains while the others are working fine. Use the debug version to collect log data when trying to track down problems. The kernel log messages can be found in /var/log/system.log. For Sierra and above use "log show --predicate "processID == 0" --debug" in order to retrieve kernel logs. Include the log data when asking for support or giving feedback. I'm an engineer, not a clairvoyant. Check your BIOS settings. You might want to disable Network Boot and the UEFI Network Stack as these can interfere with the driver. Double check that you have removed any other Realtek kext from your system because they could prevent the driver from working properly. Verify your bootloader configuration, in particular the kernel flags. Avoid using npci=0x2000 or npci=0x3000. In Terminal run netstat -s in order to display network statistics. Carefully examine the data for any unusual activity like a high number of packets with bad IP header checksums, etc. In case auto-configuration of the link layer connection doesn't work it might be necessary to select the medium manually in System Preferences under Network for the interface. Use Wireshark to create a packet dump in order to collect diagnostic information. Keep in mind that there are many manufacturers of network equipment. Although Ethernet is an IEEE standard different implementations may show different behavior causing incompatibilities. In case you are having trouble try a different switch or a different cable.
How can I retrieve the kernel logs? In Terminal type "grep kernel /var/log/system.log". I want to disable Energy Efficient Ethernet (EEE) but I don't know how? Take a look at the driver's Info.plist file. There you will find an option named <key>enableEEE</key>. Change its value from <true/> to <false/>. Don't forget to recreate the kernel cache after changing the value. WoL from S5 doesn't work with this driver but under Windows it's working. Is this a driver bug? No it isn't, the driver is working as it should because OS X doesn't support WoL from S5.
The driver has been successfully tested under 10.8.x and 10.9 with the B, C, D, E, F and G versions of the RTL8111/8168 and is known to work stable on these devices.
Version 2.2.2 (2018-01-21) Force ASPM state to disabled/enabled according to the config parameter setting. Requires 10.12 or newer. Version 2.2.1 (2016-03-12): Updated underlying linux sources from Realtek to 8.041.00. Added support for RTL8111H. Implemented Apple’s polled receive driver model (RXPOLL). Requires 10.11 or newer. Support for older versions of OS X has been dropped. Version 2.0.0 (2015-06-21): Uses Apple's private driver interface introduced with 10.8. Supports packet scheduling with QFQ. Please note that 2.0.0 is identical to 2.0.0d2. Only the version number has changed. Version 1.2.3 (2014-08-23): Reworked TSO4 and added support for TSO6. Version 1.2.2 (2014-08-44): Added an option to disable Active State Power Management (ASPM, default disabled) as ASPM seems to result in unstable operation of some chipsets. Resolved a problem with Link Aggregation after reboot. Added a workaround for the multicast filter bug of chipset 17 (RTL8111F) which prevented Bonjour from working properly Version 1.2.0 (2014-04-24): Updated underlying linux sources from Realtek to 8.037.00. Improved interrupt mitigate to use a less aggressive value for 10/100 MBit connections. Version 1.1.3 (2013-11-29): Improved transmit queue handling made it possible to reduce CPU load during packet transmission. Improved deadlock detection logic in order to avoid false positives due to lost interrupts. Version 1.1.2 (2013-08-03): Improved SMB performance in certain configurations. Faster browsing of large shares. Version 1.1.0 (2013-06-08): Support for TCP/IPv6 and UDP/IPv6 checksum offload added (can be disabled in Info.plist). Maximum size of the scatter-gather-list has been increased from 24 to 40 segments to resolve performance issues with TSO4 when offloading large packets which are highly fragmented. TSO4 can be disabled in Info.plist without rebuild. Statistics gathering has been improved to deliver more detailed information (resource shortages, transmitter resets, transmitter interrupt count). The interrupt mitigate settings has been changed to improve performance with SMB and to reduce CPU load. Configuration option added to allow for user defined interrupt mitigate settings without rebuild. Version 1.0.4 (2013-05-04): Moved setLinkStatus(kIONetworkLinkValid) from start() to enable(). Cleaned up getDescCommand(). Version 1.0.3 (2013-04-25): The issue after a reboot from Windows has been eliminated. Version 1.0.2 (2013-04-22): Added support for rx checksum offload of TCP and UDP over IPv6. Version 1.0.1 (2013-03-31): Improved behavior when rx checksum offload isn't working properly. Adds the chipset's model name to IORegistry so that it will show up in System Profiler.
There are still performance problems with regard to SMB in certain configurations. My tests indicate that Apple's Broadcom driver shows the same behavior with those configurations. Obviously it's a more general problem that is not limited to my driver. WoL does not work in certain configurations. Old systems with 3 and 4 series chipsets exhibit performance issues in recent versions of macOS because there is no optimized power management for these systems in macOS anymore as Apple dropped support for the underlying hardware a long time ago. In case you are affected, please upgrade your hardware or find an alternative solution because I have no plans for a workaround. Sorry, but I don't think that it's worth the effort.
Getting the driver
The source code can be found here: https://github.com/M...driver_for_OS_X There is also a pre-build binary for Mavericks and Yosemite: https://www.insanelymac.com/forum/files/file/88-realtekrtl8111-binary/
Building from Source
I'm using XCode 4.6.3 for development. You can get a free copy of XCode after becoming a member of the Apple developer program. The free membership is sufficient in order to get access to development tools and documentation.
I have put together this simple little guide for anybody wanting to use a Patched DSDT EFI with the same configuration as me.
This is also a thread to discuss everything Z390 Master and try and help where we can and maybe make things a little better for you.
A huge massive thank you to @glasgood @MaLd0n @larabee These three guys have helped me and talked me so much and are as helpful as you could ever get, Without them I wouldn't have a perfect working build like I do or be putting up this Guide & Discussion Thread sharing the hard work and countless hours that we have all put in to this.
This EFI and Patched DSDT have been created to work with a Gigabyte Aorus Z390 Master using bios revision F11c, 9900k with a 5700 XT but has also been tested and verified fully working with the following Hardware
8600K, 8700, 8700K, 9600K, 9700K, 9900K, 9900KS
RX 560, 570, 580, 590, Vega 56, Vega 64, Radion VII, 5700, 5700 XT
(If you have success with any different CPU or GPU's then please do let me know)
@glasgood Has kindly put together a new simple Catalina install guide so Just Follow He's Guide For a Perfect Install. (glasgood put the guide together for the Z390 Pro but the two boards are so alike that you can follow this guide with no problems at all using the Z390 Master)
• Intel I9 9900k @5.2Ghz
• Gigabyte AORUS Z390 MASTER
• Sapphire Nitro+ RX 5700 XT ( connected to monitor with DisplayPort )
• Corsair Vengeance Pro RGB 32GB @3600mhz (2 x 16GB)
• Corsair RM850x 80 Plus Gold Power Supply Unit
• EK Custom Liquid Cooling Loop
• Samsung 970 EVO 1TB NVMe SSD macOS Catalina 10.15.3
• Samsung 860 EVO 1TB SSD (2.5) Windows 10 Pro
• ABWB BCM943602CS 802.11AC WI-FI With Bluetooth 4.0 PCI-Express (PCI-E)
• Lian Li PC-O11DW Dynamic ATX Case
• Ethernet Port
• SSD Trim
• USB 3.0 & 2.0 (All ports Open Natively)
• Hardware Acceleration
• Sleep & Wake
• Sleep and Shutdown via the Power Button
• Netflix on Safari browser
• Sidecar (only works using the iMac19,1 EFI and with your igpu Enabled)
CLOVER EFI FOLDERS
please note - You must flash your Z390 MASTER bios to revision F11c to use any of these EFI's, The DSDT is not designed for any other Bios revision
mb_bios_z390-aorus-master_f11c.zip - Aorus Z390 Master Bios F11c
Use this folder with fully patched DSDT
EFI Update - 04/02/2020 - Use with Bios revision F11c Only or Replace with the older F10 DSDT if you don't want to update the bios
AG Clover Z390 Master Navi Vega EFI.zip - Vega, Navi (5700, 5700XT), Radeon VII DSDT EFI
AG Clover Z390 Master Polaris EFI.zip - RX5XX Polaris DSDT EFI
CFG Unlock (MSR) F11c BIOS Profile - The Easy Way
Highly recommended if your using a Vega 56/64, Radeon VII or Navi GPU
ADDITIONAL DSDT's & Older EFI’s (A big thanks to @MaLd0n for compiling these DSDT's)
Alternative EFI - OpenCore No DSDT and Done the way OpenCore intended it (04/02/2020)
Alternative EFI 2 - N-D-K Fork of OpenCore (04/02/2020)
To Create Your Own Patched DSDT Message @MaLd0n using the link bellow
(If you want a perfect setup then getting your own patched DSDT made would be the best thing to do, Mine will work perfectly fine but different hardware no matter how small a change it is can tend to have some sort of effect on the DSDT and your setup)
If Your Not Using File Vault Then Please Disable Hibernate
BroadcomFix.zip (Use these kexts if your Broadcom bluetooth/Wifi isn't working properly)
Native Display Brightness with MonitorControl
BIOS SETTINGS (Bios Revision F11C)
• Enter BIOS → Press Delete → Enter Setup
• Save & Exit → Load Optimized Defaults
• Boot -> Windows 8/10 Features -> Win 8/10WHQL
• Boot -> CSM Support -> Disabled (Can be set to Enabled if need be but try to have it set to Disabled first)
• Favourites -> Extreme Memory Profile (X.M.P.) -> Profile1
• Favourites -> VT-d -> Disabled (Can be set to Enabled or Disabled, Your choice)
• Settings -> IO Ports -> USB Configuration -> XHCI Hands-off -> Enabled
• Settings -> IO Ports -> Internal Display Output -> PCIe 1 Slot
• Settings -> IO Ports -> Internal Graphics -> Enabled
• Settings -> IO Ports -> DVMT Pre-Allocated -> 64M
• Settings -> IO Ports -> DVMT Total GFX0-Allocated -> 256M
• Settings -> IO Ports -> Aperture Size -> 256MB
• Settings -> IO Ports -> Wifi -> Disabled
• Settings -> IO Ports -> Audio Controller -> Enabled
• Settings -> IO Ports -> Above 4G Decoding -> Enabled
• Settings -> IO Ports -> USB Configuration -> Legacy USB Support -> Enabled
• Settings -> IO Ports -> USB Configuration -> XHCI Hand-off -> Enabled
• Settings -> Miscellaneous -> Software Guard Extensions (SGX) -> Disabled
• Settings -> Platform Power -> Platform Power Management -> Enabled
• Settings -> Platform Power -> ErP -> Enabled
• Settings -> Platform Power -> RC6(Render Standby) -> Enabled
• Save & Exit → Save & Exit Setup
Now have a Olarila app, just download app and clover folder for your Chipset! https://www.olarila.com/topic/5165-olarila-app-images-and-folders/ Install MacOS with Olarila Image, Step by Step, Install and Post Install
First... If you need DSDT edits... -Extract tables with F4 key in Clover boot screen! -Run it and send me files! RunMe.app Installation --Create a bootable copy of El Capitan / Sierra / High Sierra / Mojave https://github.com/chris1111/Create-Install-Media/releases --Install Clover in USB stick https://github.com/CloverHackyColor/CloverBootloader/releases --Replace with my Clover folder https://www.olarila.com/topic/5676-clover-folder-for-all-chipsets/ --Install EL Capitan / Sierra / High Sierra and boot into system! Post Installation --Install Clover and replace with my folder https://www.olarila.com/topic/5676-clover-folder-for-all-chipsets/ --Reboot and activate video! Bingo! Now you need a fine tune! DSDT Time! My DSDT GA P35-DS3 DSDT.MaLd0n.zip Patches -FIX ERRORS AND WARNINGS -HPET -SATA -SLPB -DARWIN -LPC -HDEF -RTC -EHCI -UHCI -IRQs -SBUS -BUS1 -MCHC -ALS0 -SHUTDOWN -LAN -EC -PNLF --Native Power Management
Use Clover, check Generate P and C States
Install .app, select the required permission and reboot. Work in F1 / F2 keys!
*in some cases .app don't work, check patches in config.plist inside Clover folder Post Install
Device HDEF + AppleAlc + Lilu
--install Lan driver by Mieze
-Atheros http://www.insanelymac.com/forum/files/file/313-atherose2200ethernet/ -Intel http://www.insanelymac.com/forum/files/file/396-intelmausiethernet/ -Realtek http://www.insanelymac.com/forum/files/file/88-realtekrtl8111-binary/ --Links -FakeSMC https://bitbucket.org/RehabMan/os-x-fakesmc-kozlek -Audio https://github.com/vit9696/AppleALC http://www.insanelymac.com/forum/topic/293863-applehda-patch-requests/ -Credits and thanks to the old and new people in the community who developed patches, kexts and bootloaders! Slice, Kabyl, usr-sse2, jadran, Blackosx, dmazar, STLVNUB, pcj, apianti, JrCs, pene, FrodoKenny, skoczy, ycr.ru, Oscar09, xsmile, SoThOr, RehabMan, Download-Fritz, Zenit432, cecekpawon, Intel, Apple, Oracle, Chameleon Team, crazybirdy, Mieze, Mirone, Oldnapalm, netkas, Elconiglio, artut-pt, ErmaC, Pavo, Toleda, Master Chief and family, bcc9, The King, PMheart, Sherlocks, Micky1979, vit9696, vandroiy2013, Voodoo Team, Pike R. Alpha, lvs1974, Austere.J, CVad and many, many, many others! We're all here to have fun and learn from each other! ENJOY!