WYRMALITH™ DOCUMENTATION

Setup & Configuration Wiki

Official English documentation for WYRMALITH Tier 1 architecture, dual-machine configuration, network card identification, software setup, performance tuning, troubleshooting, and FAQ.

Before You Begin

Preparation Notes

Make sure the host machine and secondary machine are connected to the same router or switch. Use a stable wired network whenever possible. If your setup requires firewall, BIOS, or driver-related changes, follow the instructions carefully and restore your preferred security settings after the installation process when applicable.

Tier 1 Architecture

What Is WYRMALITH Tier 1?

WYRMALITH Tier 1 is a network-based direct-memory-access transport architecture designed for authorized research, development, compatibility testing, and controlled dual-machine environments.

Traditional dual-machine memory-access setups commonly use a dedicated FPGA-based PCIe card, sometimes referred to as a DMA card, to transfer data between the main PC and the secondary PC. Tier 1 replaces that dedicated transport device with a supported network adapter on the main PC.

01 Main PC Supported network adapter
02 Local Network Router or network switch
03 Secondary PC Authorized client software

No Dedicated FPGA Card Required

When the main PC already contains a supported network adapter, Tier 1 does not require a separate FPGA card or traditional DMA card. The supported network adapter becomes the transport interface used by the Tier 1 environment.

Hardware Requirement

A dedicated FPGA card is not required. The main PC must instead have a network adapter supported by the current Tier 1 release.

Onboard and External Network Adapters

Users may use a supported onboard network adapter when one is already available in the main PC. If the onboard adapter is not supported, a compatible external PCIe network adapter can be installed instead.

An external adapter can also provide a dedicated interface for the Tier 1 connection, making the setup easier to isolate, replace, and troubleshoot without changing the main system's other network interfaces.

Option 01

Supported Onboard NIC

No additional transport hardware is required when the main PC already contains a supported adapter.

Option 02

External PCIe NIC

Install a supported external network adapter when the onboard adapter is unsupported or when a dedicated interface is preferred.

Local Network Requirements

The main PC and secondary PC must be connected to the same local network. Both machines should be connected through the same router, network switch, or combined router-and-switch environment.

  • The main PC must use its supported Tier 1 network adapter.
  • The secondary PC may connect to the router through Ethernet or Wi-Fi.
  • Both machines must remain reachable within the same LAN.
  • A stable wired network is recommended whenever possible.

Ethernet vs Wi-Fi on the Secondary PC

The secondary PC can connect to the shared router using either an Ethernet cable or Wi-Fi. Both connection methods can operate within the Tier 1 architecture as long as both machines are on the same LAN.

Ethernet Recommended

Generally provides higher throughput, lower latency, and more consistent read/write performance.

Wi-Fi Supported

Useful when a cable connection is unavailable, but performance may vary depending on signal quality, interference, and router capability.

Expected Performance

Tier 1 performance depends on the complete network path rather than only one component. The network adapter, router, switch, cable quality, Wi-Fi signal, driver configuration, and secondary-PC network interface can all affect the final result.

  • Use a stable wired connection for the secondary PC when possible.
  • Use appropriate Cat5e, Cat6, or better network cabling.
  • Confirm that all relevant ports negotiate at the intended link speed.
  • Avoid congested or unstable Wi-Fi connections during performance testing.
  • Review the Performance Tuning section when results are below expectations.

Software Integration

Tier 1 works with all DMA softwares that support replacing a custom leechcore.dll transport library. In these softwares, the Tier 1 secondary-side files can usually be placed into the application's required directory by following the relevant configuration guide.

Applications that use a fixed or internally bundled leechcore.dll may require a small developer-side integration. The application developer must expose a supported transport interface or add Tier 1's library to their whitelist.

Compatibility Note

Compatibility depends on how each application loads its transport components. Support for replacing leechcore.dll generally provides the simplest integration path.

Tier 1 Summary

FPGA Card Not required when a supported NIC is available
Main PC Requires a currently supported built-in or external network adapter
Secondary PC May connect through Ethernet or Wi-Fi
Network Both machines must be on the same LAN
Best Performance Wired secondary-PC connection is recommended
Software Integration Best with applications supporting a replaceable leechcore.dll
Software Config

Software Configuration

Different software requires different adaptation methods. Please choose the configuration guide that matches the software you are using.

PUP Secondary-side DLL replacement and configuration file setup PUP Config EVO Rename and place the required LeechCore file EVO Config AtomicDMA AppData override configuration method AtomicDMA Config

PUP Software Configuration

01

Replace the Secondary-Side DLL Files

Open the WYRMALITH secondary-side folder and copy the two .dll files into the pup folder. Replace the existing files if prompted.

02

Configure aw_config.ini

Find or create aw_config.ini in the following directory: 

C:\Users\Administrator\AppData\Local\Temp\aw

Right-click aw_config.ini and choose Edit. Then copy the contents of Leechcore.ini from the WYRMALITH secondary-side folder and paste them into aw_config.ini. Save the file after editing.

03

Create the no_leechcore File

Inside the C:\pup folder, create a file named: 

no_leechcore

This file must have no extension. Make sure Windows does not save it as no_leechcore.txt.

EVO Software Configuration

Rename the WYRMALITH secondary-side file leechcore.dll to: 

winusb.dll

Place the renamed winusb.dll into the EVO software directory, then restart the software and try launching again.

AtomicDMA Software Configuration

01

Open the AtomicDMA AppData Folder

On the secondary machine, open the following directory: 

%appdata%\AtomicDMA

You can paste this path directly into the Windows File Explorer address bar.

02

Create the Override File

Inside the AtomicDMA folder, create a new text file named: 

OVERRIDE_LEECHCORE

Make sure the file name is exactly OVERRIDE_LEECHCORE. If Windows adds .txt automatically, rename the file and remove the extension.

03

Replace the LeechCore File

Place your custom leechcore.dll into the same %appdata%\AtomicDMA folder.

If Windows asks whether you want to replace the existing file, choose Replace the file in the destination.

Result

After the override file and custom leechcore.dll are placed correctly, restart AtomicDMA and launch it again.

Network Card Identification

Choose the Correct Network Card Guide

If you are not sure what network card your host machine uses, check the hardware ID first. The hardware ID is the fastest way to confirm whether your system uses Realtek RTL8125, Intel I225, Intel I226, or another network adapter.

RTL8125 Realtek RTL8125 series VEN_10EC&DEV_8125 Intel I225 I225-V / I225-LM DEV_15F3 / DEV_15F2 Intel I226 I226-V / I226-LM DEV_125C / DEV_125B
Realtek RTL8125 VEN_10EC&DEV_8125
Intel I225-V VEN_8086&DEV_15F3
Intel I225-LM VEN_8086&DEV_15F2
Intel I226-V VEN_8086&DEV_125C
Intel I226-LM VEN_8086&DEV_125B
RTL8125 Check

How to Check for a Realtek RTL8125 Network Card

Fast Method: PowerShell

  1. Right-click the Windows Start menu.
  2. Open Windows PowerShell or Terminal as administrator.
  3. Run the command below.
Get-PnpDevice -Class Net | Select FriendlyName,InstanceId

Check the output for DEV_8125. If you see VEN_10EC&DEV_8125, the machine is using a Realtek RTL8125 series adapter.

Manual Method: Device Manager

  1. Press Win + X and open Device Manager.
  2. Expand Network adapters.
  3. Find the wired network adapter, such as Realtek Gaming 2.5GbE Family Controller.
  4. Right-click the adapter and open Properties.
  5. Go to Details.
  6. Select Hardware Ids from the property dropdown.
  7. Look for VEN_10EC&DEV_8125.
Result

If you see DEV_8125, it is an RTL8125 series adapter. If not, check whether the machine uses Intel I225, Intel I226, Wi-Fi, Bluetooth, or another network adapter.

Intel I225 Check

How to Check for an Intel I225 Network Card

Quick Result

  • VEN_8086&DEV_15F3 usually means Intel I225-V.
  • VEN_8086&DEV_15F2 usually means Intel I225-LM.
  • DEV_8125 means RTL8125, not I225.
  • If none of these appear, it may be I226, Wi-Fi, Bluetooth, or another adapter.

VEN_8086 represents Intel. DEV_15F3 and DEV_15F2 identify specific I225 models.

Fast Method: PowerShell

  1. Right-click the Windows Start menu.
  2. Open Windows PowerShell or Terminal as administrator.
  3. Run the command below.
Get-PnpDevice -Class Net | Select FriendlyName,InstanceId

Look for DEV_15F3 or DEV_15F2. You can ignore Wi-Fi, Bluetooth, and WAN Miniport entries during this check.

Manual Method: Device Manager

  1. Press Win + X and open Device Manager.
  2. Expand Network adapters.
  3. Find the wired network adapter, such as Intel(R) Ethernet Controller I225-V.
  4. Right-click the adapter and open Properties.
  5. Go to Details.
  6. Select Hardware Ids.
  7. Check for VEN_8086&DEV_15F3 or VEN_8086&DEV_15F2.
Final Judgment

VEN_8086&DEV_15F3 usually indicates Intel I225-V. VEN_8086&DEV_15F2 usually indicates Intel I225-LM. If you see Intel hardware IDs but not these device IDs, it may be a different Intel adapter.

Intel I226 Check

How to Check for an Intel I226 Network Card

Quick Result

  • VEN_8086&DEV_125C usually means Intel I226-V.
  • VEN_8086&DEV_125B usually means Intel I226-LM.
  • DEV_8125 means RTL8125, not I226.
  • DEV_15F3 or DEV_15F2 means I225, not I226.
  • If none of these appear, it may be Wi-Fi, Bluetooth, or another adapter.

VEN_8086 represents Intel. DEV_125C and DEV_125B identify specific I226 models.

Fast Method: PowerShell

  1. Right-click the Windows Start menu.
  2. Open Windows PowerShell or Terminal as administrator.
  3. Run the command below.
Get-PnpDevice -Class Net | Select FriendlyName,InstanceId

Look for DEV_125C or DEV_125B. Wi-Fi, Bluetooth, and WAN Miniport entries can be ignored for this check.

Manual Method: Device Manager

  1. Press Win + X and open Device Manager.
  2. Expand Network adapters.
  3. Find the wired network adapter, such as Intel(R) Ethernet Controller I226-V.
  4. Right-click the adapter and open Properties.
  5. Go to Details.
  6. Select Hardware Ids.
  7. Check for VEN_8086&DEV_125C or VEN_8086&DEV_125B.
Final Judgment

VEN_8086&DEV_125C usually indicates Intel I226-V. VEN_8086&DEV_125B usually indicates Intel I226-LM. If you see Intel hardware IDs but not these device IDs, it may be a different Intel adapter.

Performance Tuning

How to Improve Slow WYRMALITH Speed Test Results

If your WYRMALITH speed test result is much slower than expected, check the network adapter advanced settings in Windows Device Manager. As a general reference, a normal 1G setup may test around 7000, while a normal 2.5G setup may test around 10000, depending on the adapter, cable, router, switch, and overall network stability.

Important

Adapter setting names may be slightly different depending on the driver version, adapter model, and Windows language. Before changing values, write down your original settings so you can restore them if needed.

Open Adapter Advanced Settings

  1. Right-click the Windows Start menu.
  2. Open Device Manager.
  3. Expand Network adapters.
  4. Find the network adapter used for the WYRMALITH connection.
  5. Right-click the adapter and choose Properties.
  6. Open the Advanced tab.
  7. Apply the recommended values below.

Recommended Advanced Adapter Settings

Speed & Duplex Auto Negotiation
Jumbo Packet / Jumbo Frame 9014 Bytes / 9KB
Flow Control Rx & Tx Enabled
Receive Buffers Maximum available value
Transmit Buffers Maximum available value
Receive Side Scaling / RSS Enabled
Interrupt Moderation Enabled
Energy Efficient Ethernet Disabled
Green Ethernet Disabled
DMA Coalescing Disabled
IPv4 Checksum Offload Enabled
TCP Checksum Offload IPv4 Enabled
TCP Checksum Offload IPv6 Enabled
UDP Checksum Offload IPv4 Enabled
UDP Checksum Offload IPv6 Enabled
Large Send Offload V2 IPv4 Enabled
Large Send Offload V2 IPv6 Enabled
ARP Offload Optional: try Disabled while troubleshooting
NS Offload Optional: try Disabled while troubleshooting

After Changing Settings

  1. Click OK to save the adapter settings.
  2. Disconnect and reconnect the network cable, or disable and re-enable the adapter.
  3. Restart the secondary-side software if it is already running.
  4. Run the WYRMALITH speed test again.
  5. If the result becomes unstable, restore the previous adapter settings and test again.
Troubleshooting

Troubleshooting Checklist

If installation, speed testing, or software startup behaves abnormally, check the items below in order.

01. Network Environment

  • Confirm the host machine and secondary machine are on the same router or switch.
  • Confirm the network cable, router, and switch are working properly.
  • Use a stable wired connection whenever possible.

02. Host Machine Settings

  • Confirm required BIOS settings were handled correctly for your setup.
  • Confirm Fast Boot is not interfering with driver initialization.
  • After installing the driver, perform a full shutdown and power-on instead of only restarting.

03. Network Card

  • Confirm whether the host machine uses an RTL8125, Intel I225, or Intel I226 series adapter.
  • If the onboard adapter is not compatible, try a supported external adapter.
  • If you are unsure, use the network card identification section above.

04. Driver

  • Confirm the driver was installed by right-clicking the .inf file.
  • After installation, wait around 5-10 seconds for the network connection to return.
  • If the network does not return, re-check the adapter and network connection.

05. Secondary Machine Config

  • Confirm Npcap is installed on the secondary machine.
  • Confirm the secondary-side files are copied into the software root directory.
  • Confirm Leechcore.ini contains the correct host MAC address if manual configuration is needed.

06. Speed Test

  • Speed test results depend on the secondary machine network adapter.
  • Router and switch performance can affect test results.
  • Network cable quality and total link stability also matter.
  • If the speed test is much slower than expected, check the Performance Tuning section above.

07. Software Notes

  • For PUP, follow the PUP configuration guide under Software Config.
  • For EVO, rename leechcore.dll to winusb.dll and place it in the software directory.
  • For AtomicDMA, create OVERRIDE_LEECHCORE inside %appdata%\AtomicDMA and place your custom leechcore.dll in the same folder.
FAQ

Frequently Asked Questions

Does Tier 1 require an FPGA or traditional DMA card?

No. Tier 1 uses a supported network adapter on the main PC as its transport interface. When the main PC already has a supported adapter, no separate FPGA card is required. If the onboard adapter is unsupported, a compatible external PCIe network adapter may be installed.

Do I have to use an RTL8125 network card?

RTL8125 series adapters are recommended. Intel I225 is also recommended. Some onboard adapters may not be compatible. If installation or testing behaves abnormally, check the hardware ID first and confirm whether your adapter is supported.

Do the host and secondary machine need to be on the same network?

Yes. The host machine and secondary machine should be connected to the same router or switch. A more stable network link usually produces more stable test results.

Why does the network not return after driver installation?

First check whether the adapter is connected to the correct network, whether your required setup settings were applied correctly, and whether the driver was installed through the .inf file. Wait around 5-10 seconds after installation. If it still does not return, fully shut down the machine and power it on again.

Does Leechcore.ini require a MAC address?

Not always. The software may attempt automatic host discovery. If automatic discovery fails, or if multiple host machines are on the same network, enter the host MAC address manually.

What should I do if DMATest speed is not ideal?

Speed test results are usually related to the network environment. Check the secondary machine network adapter, router, switch, cable quality, and overall link stability. If the result is much slower than expected, review the Performance Tuning section and adjust the adapter advanced settings.

What should I do if EVO cannot start properly?

Rename leechcore.dll to winusb.dll and place it in the EVO software directory. Then restart the software and try launching again.

What should I do if AtomicDMA does not load the correct file?

Go to %appdata%\AtomicDMA, create a file named OVERRIDE_LEECHCORE, and place your custom leechcore.dll into the same folder. Restart AtomicDMA after making the changes.