Skip to content

laobamac/SimpleRTK5

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SimpleRTK5

Realtek RTL8126 5GbE Driver for macOS

Platform Chipset Speed Language License Build Status

SimpleRTK5 is a high-performance open-source kernel extension (kext) enabling support for the Realtek RTL8126 5GbE Ethernet controller on macOS.
Designed for Hackintosh builds and real Macs using PCIe adapters.

中文 (Chinese)


 English

✨ Features

  • Full 5GbE Support: Native support for 5000Mbps link speeds, with auto-negotiation down to 2.5Gbps, 1Gbps, 100Mbps, and 10Mbps.
  • Hardware Offloading: Supports TCP Segmentation Offload (TSO4/TSO6) and Checksum Offload (CSO6) for reduced CPU usage.
  • Energy Efficient: Implements Energy Efficient Ethernet (EEE) support (configurable).
  • Native Integration: Fully integrates with macOS IONetworkingFamily, supporting Network Preference Pane, jumbo frames, and multicast.
  • System Stability: Optimized interrupt handling and memory management to prevent kernel panics.

🚀 Installation

For OpenCore Users (Recommended)

  1. Download the latest release of SimpleRTK5.kext.
  2. Copy the kext to your EFI partition: EFI/OC/Kexts/.
  3. Add the kext to your config.plist (Snapshot your folder using ProperTree or add manually).
  4. Requirements:
    • macOS Catalina (10.15) or newer (Tested on Sequoia).
    • IOPCIFamily and IONetworkingFamily (Standard in macOS).

Boot Arguments & Properties

You can customize the driver behavior by adding entries to DeviceProperties in your config.plist for the PCI path of your Ethernet card.

Key Type Default Description
disableASPM Boolean true Disables Active State Power Management. Keep true for stability.
enableEEE Boolean true Enables Energy Efficient Ethernet. Set false if you experience lag.
enableTSO4 Boolean true IPv4 TCP Segmentation Offload.
enableTSO6 Boolean true IPv6 TCP Segmentation Offload.
enableCSO6 Boolean true IPv6 Checksum Offload.
µsPollInt2500 Number 110 Polling interval tuning for high load.

🛠 Building from Source

# Clone the repository
git clone https://github.com/laobamac/SimpleRTK5.git
cd SimpleRTK5

# Build using Xcode
xcodebuild -project SimpleRTK5.xcodeproj -configuration Release

About

macOS's RTL8126 5G Ethernet card driver

Resources

License

Stars

Watchers

Forks

Packages

No packages published