Nerd Eth interposer support- #724 #724 Merged shufps merged 2 commits into shufps:develop from BitMa
This PR integrates WIZnet's W5500 Ethernet controller into open-source Bitcoin miners, providing CPU-offloaded, ultra-low-latency wired connectivity.
0
Project description
1. Technical Value of this IoT PR
* **Solution Scalability (Wi-Fi → Ethernet):** Existing Bitcoin solo miner devices (such as NerdMiner or ESP-Miner) primarily operated via Wi-Fi (based on the ESP32 series). This PR introduces an Ethernet interposer layout along with the necessary drivers and configurations, enabling stable communication with Bitcoin nodes and pools over wired networks.
* **Open Source Community Contribution:** Authored by BitMaker—a key contributor to the Bitcoin home mining community—this PR represents a significant commit that officially integrates a wired Ethernet layer into open-source firmware standards.
2. Value for WIZnet
* **Entry and Standardization in the Bitcoin Hardware Ecosystem:** This demonstrates the adoption of WIZnet chipsets as the standard wired Ethernet solution within the rapidly growing open-source Bitcoin solo mining ecosystem (including projects like NerdMiner and Axe-Miner).
* **Reliability-Focused B2C/B2B Marketing Point:** In the Bitcoin mining sector, where 24/7 continuous operation is critical, WIZnet chipsets gain brand value as "high-reliability network solutions" that resolve Wi-Fi issues such as packet loss and latency.
* **Expansion of the Developer Community:** Through open-source IoT projects, WIZnet can simultaneously boost product awareness and adoption rates among global hardware developers and the Bitcoin community. 3. Key Role of the W5500 Chip in the Project
* Hardware TCP/IP Offloading (TCP/IP Offloading Engine):
* The W5500 handles the L3/L4 TCP/IP stack directly on-chip.
* It relieves the MCU (ESP32) of the burden of processing complex network protocols, allowing the CPU to focus entirely on mining computations (hash rate) without wasting resources.
* Stable, Ultra-Low-Latency Communication:
* In Bitcoin mining, the speed (latency) of receiving blocks or new jobs and submitting hash results to the pool is directly linked to profitability (preventing "stale shares").
* The W5500 instantly transmits wired Ethernet packets via SPI communication, ensuring significantly lower latency and higher communication reliability compared to Wi-Fi.
* Low Power / Simple SPI Interface:
* It connects easily to the ESP32 using only a few SPI pins (SCLK, MOSI, MISO, CS, etc.), simplifying the design and reducing the cost of the interposer board.
3. system architecture


4. Q&A
Q1. What is the main purpose of this Pull Request (PR 724)?
> A. To add support for a wired Ethernet interposer board and the corresponding driver configuration to the Bitcoin solo mining project (`ESP-Miner-NerdQAxePlus`). We have expanded the project to officially support W5500-based wired networking, moving beyond the existing Wi-Fi-centric connection method.
Q2. What are the advantages of using wired Ethernet (W5500) instead of the existing Wi-Fi connection? > A. There are two main advantages:
> 1. Reduced Latency: In Bitcoin mining, the speed at which mining results are transmitted to the pool is critical; wired communication significantly reduces the occurrence of "stale shares" (hashes that are rendered invalid due to delayed delivery).
> 2. Connection Reliability: Since mining rigs must operate continuously—24 hours a day, 365 days a year—wired connections offer far greater stability than Wi-Fi, which is susceptible to signal interference or wireless disconnections.
Q3. What are the advantages for the MCU (CPU) when using the W5500 in an ESP32 mining rig?
> A. The W5500 features a hardware TCP/IP offloading engine. This means the W5500 chip independently handles complex network protocol processing, allowing the main controller (ESP32) to reduce its network communication workload and dedicate more CPU resources to hash calculations (the actual mining process).
5. Two representative projects from the WIZnet Maker Portal that are similar in nature to the aforementioned PR (#724)
a. Comparison Project: ESP-Miner-LAN (Bitaxe/ESP32-S3-based Bitcoin miner with integrated Ethernet)
b. Integrating W5500 with ESP32 Using Core 3 (Implementation of W5500 native Ethernet and SSL/TLS in the ESP32 environment)
Comparison Item | [PR #724] Nerd Eth Interposer (Current Article) | [Project 1] ESP-Miner-LAN | [Project 2] W5500 with ESP32 Core 3 |
|---|---|---|---|
Application Domain | Bitcoin Solo Mining (NerdQAxePlus) | Bitcoin ASIC Mining (Bitaxe series) | General IoT (Smart Home, Industrial Sensors, etc.) |
Primary Goal | Adding hardware interposer layout & firmware support | Building a dual-network setup with LAN priority & Wi-Fi Fallback | Implementing secure (SSL/TLS) wired communication on ESP32 Core 3 |
W5500 Role | Providing wired connectivity for miner interfaces (ultra-low latency) | Acting as the primary high-speed line while backing up Wi-Fi against drops | Delivering stable HTTPS/IoT network connectivity with SSL certificates |
Software Architecture | PR-based firmware parameters & hardware pin mapping additions | Abstracting W5500 via ESP-IDF's | Utilizing Native Ethernet libraries provided in Arduino/ESP32 Core 3 |
Key Highlight | Focus on Hardware Compatibility & Board Integration | Focus on Network Redundancy (Failover) | Focus on Secure General-Purpose IoT Communication |

=====
1. 이 IoT 글(PR)의 기술적 가치
* 솔루션의 확장성 (Wi-Fi → Ethernet): 기존 비트코인 솔로 마이너(NerdMiner/ESP-Miner) 계열 기기들은 주로 Wi-Fi(ESP32 계열) 기반으로 동작했습니다. 이 PR은 이더넷 인터포저(Interposer) 레이아웃 및 드라이버/설정을 추가함으로써 유선 네트워크 환경에서도 안정적으로 비트코인 노드/풀과 통신할 수 있게 확장했습니다.
* 오픈소스 커뮤니티 기여: 비트코인 홈 마이닝 커뮤니티의 주요 기여자인 BitMaker가 작성한 코드/하드웨어 인터페이스 변경 사항으로, 오픈소스 펌웨어 표준에 유선 이더넷 레이어를 공식적으로 통합하는 유의미한 커밋입니다.
2. 위즈네트(WIZnet) 차원에서의 가치
* 비트코인 하드웨어 생태계 진입 및 표준화: 최근 활발하게 성장 중인 오픈소스 비트코인 솔로 마이닝(NerdMiner, Axe-Miner 등) 및 하드웨어 생태계에서 위즈네트 칩셋이 유선 이더넷의 표준 솔루션으로 적용되고 있음을 입증합니다.
* 신뢰성 중심의 B2C/B2B 마케팅 포인트: 24/7 continuous 오퍼레이션이 핵심인 비트코인 채굴기 분야에서, Wi-Fi의 패킷 손실 및 지연(Latency) 문제를 해결해 주는 '고신뢰성 네트워크 솔루션'으로서 위즈네트 칩셋의 브랜딩 가치가 커집니다.
* 개발자 커뮤니티 확장: 오픈소스 IoT 프로젝트를 통해 글로벌 하드웨어 개발자 및 비트코인 커뮤니티 내에서 WIZnet 제품에 대한 인지도와 채택률을 동시에 올릴 수 있습니다.
3. 프로젝트 내 W5500 칩의 핵심 역할
* 하드웨어 TCP/IP 오프로딩 (TCP/IP Offloading Engine):
* W5500은 L3/L4 TCP/IP 스택을 칩 내부 온칩(On-chip)으로 직접 처리합니다.
* MCU(ESP32)가 복잡한 네트워크 프로토콜을 처리하느라 CPU 자원을 낭비하지 않고, 채굴 연산(Hash Rate) 처리에만 집중할 수 있도록 부담을 완전히 덜어줍니다.
* 안정적인 초저지연(Low-Latency) 통신:
* 비트코인 채굴에서는 블록/새로운 작업(Job)을 전달받고 해시 결과를 풀에 제출하는 속도(Latency)가 수익성(Stale share 방지)과 직결됩니다.
* W5500은 SPI 통신을 통해 유선 이더넷 패킷을 즉시 전달하여 Wi-Fi 대비 훨씬 낮은 지연 시간과 높은 통신 신뢰성을 보장합니다.
* Low-power / 간편한 SPI 인터페이스:
* ESP32와 소수의 SPI 핀(SCLK, MOSI, MISO, CS 등)만으로 손쉽게 연결되어 인터포저 보드 단가 및 설계를 단순화합니다.

4. Q&A
Q1. 이 Pull Request(PR 724)의 주요 목적은 무엇인가요?
> A. 비트코인 솔로 채굴기 프로젝트(`ESP-Miner-NerdQAxePlus`)에 유선 이더넷 인터포저(Interposer) 보드 지원 및 드라이버 설정을 추가하는 것입니다. 기존 Wi-Fi 중심의 연결 방식에서 벗어나 W5500 기반의 유선 네트워크를 공식 지원하도록 확장했습니다.
Q2. 기존의 Wi-Fi 연결 대신 유선 이더넷(W5500)을 사용하면 어떤 장점이 있나요?
> A. 크게 두 가지 장점이 있습니다.
> 1. 통신 지연(Latency) 감소: 비트코인 채굴에서는 채굴 결과를 풀(Pool)에 전송하는 속도가 직결되는데, 유선 통신은 Stale Share(늦게 전달되어 무효 처리되는 해시) 발생을 대폭 줄여줍니다.
> 2. 연결 신뢰성: 24시간 365일 중단 없이 작동해야 하는 채굴기 특성상, 신호 간섭이나 무선 끊김 현상이 있는 Wi-Fi보다 유선 연결이 훨씬 안정적입니다.
Q3. ESP32 채굴기에 W5500을 적용했을 때 MCU(CPU) 측면에서의 이점은 무엇인가요?
> A. W5500은 하드웨어 TCP/IP 오프로딩 엔진(Offloading Engine)을 탑재하고 있습니다. 즉, 복잡한 네트워크 프로토콜 처리를 W5500 칩이 자체적으로 전담하므로, 메인 컨트롤러인 ESP32는 네트워크 통신 부담을 줄이고 해시 연산(채굴 작업)에 CPU 자원을 더 집중할 수 있습니다.
5. 언급하신 PR(#724)과 성격이 유사한 위즈네트 메이커 포털의 대표적인 프로젝트 2가지
a. 비교 대상 프로젝트ESP-Miner-LAN (Bitaxe/ESP32-S3 기반 비트코인 마이너 이더넷 통합)
b. Integrating W5500 with ESP32 Using Core 3 (ESP32 환경의 W5500 Native 이더넷 및 SSL/TLS 구현)
비교 항목 | [PR #724] Nerd Eth Interposer (질문하신 글) | [프로젝트 1] ESP-Miner-LAN | [프로젝트 2] W5500 with ESP32 Core 3 |
|---|---|---|---|
적용 분야 | 비트코인 솔로 채굴 (NerdQAxePlus) | 비트코인 ASIC 채굴기 (Bitaxe 계열) | 일반 IoT (스마트홈, 산업용 센서 등) |
주요 목적 | 하드웨어 인터포저(Interposer) 레이아웃 및 펌웨어 지원 확장 | 기존 Wi-Fi 채굴기에 LAN 우선/Wi-Fi 폴백(Fallback) 듀얼 네트워크 구축 | ESP32 코어 3 환경에서 보안(SSL/TLS) 유선 통신 구현 |
W5500 역할 | 채굴기 인터페이스의 유선화 (저지연 통신) | Wi-Fi 끊김 시 채굴 중단을 막는 백업 및 기본 고속 라인 | 보안 인증서 기반의 안정적인 HTTPS/IoT 네트워크 연결 |
소프트웨어 구조 | PR 기반 펌웨어 파라미터 및 하드웨어 매핑 추가 | ESP-IDF의 | Arduino/ESP32 Core 3의 Native Ethernet 라이브러리를 활용 |
주요 특징 | 하드웨어 호환성 및 보드 통합 중심 | 네트워크 이중화(Failover) 중심 | 보안 범용 IoT 통신 중심 |
6. Maker Site 내 Bitcoin 채굴기 프로젝트
| 번호 | 프로젝트 / 게시일 | 유형·대상 | 주요 특징과 WIZnet 제품 역할 | WIZnet 측면의 가치 |
|---|---|---|---|---|
| 1 | Open Source Bitcoin ASIC miner — 2× BM1387 2023-08-02 | 초기 오픈소스 ASIC 채굴 개발 | Rust 펌웨어·ASIC 제어 개발 논의. W5500 및 W5500-EVB-Pico 활용 가능성을 소개하며, 완성된 채택 사례로 단정하기는 어려움. | 개발자 발굴·교육 가치. Rust 기반 채굴 컨트롤러에 WIZnet 제품을 적용할 접점. (WIZnet Makers) |
| 2 | Solar₿it 2025-09-23 | 태양광 기반 비트코인 채굴 | 재생에너지와 채굴을 결합한 프로젝트. 게시물은 v1.4.3에서 W5500 Ethernet 지원을 추가했다고 설명. | 응용시장 확장 가치. 태양광·장시간 운용 장비에서 유선 연결의 필요성을 보여주는 사례. |
| 3 | ESP-Miner-LAN 2025-11-13 | Bitaxe 계열 LAN 펌웨어 | ESP32-S3 채굴기에 W5500을 SPI로 연결. LAN 우선 사용과 Wi-Fi 대체 경로를 제공하며 기존 AxeOS를 유지. | 재사용 가능한 설계 자산. 기존 Wi-Fi 채굴기를 W5500으로 확장하는 코드·배선 레퍼런스. (WIZnet Makers) |
| 4 | NerdQaxe LAN Adapter 2025-11-19 | GoBrrr 판매용 LAN 어댑터 | NerdQaxe·NerdQaxe++에 유선 LAN을 추가하는 W5500 모듈 기반 확장 제품. | 직접적인 부품 수요 가치. 기존 채굴기를 업그레이드하는 액세서리 시장과 판매 파트너 접점. (WIZnet Makers) |
| 5 | “Just for Fun” Ethernet shield for NearQaxe 2026-01-07 | 커뮤니티 DIY 개조 | Reddit의 채굴기 Ethernet 개조 사례를 소개. ESP32-S3에 W5500 모듈을 추가하는 방식. | 커뮤니티 확산 가치. 사용자가 자발적으로 W5500을 선택하고 개조 경험을 공유하는 사례. (maker.wiznet.io) |
| 6 | Bitaxe Gamma – LAN Ready 2026-04-13 | GoBrrr 채굴기 완제품 | Bitaxe Gamma 601에 LAN 어댑터·스탠드·LAN 펌웨어를 미리 설치한 제품. ESP-Miner-LAN 관련 상품. | 상용화 가치. 개발 프로젝트가 구매 가능한 LAN 채굴기 제품으로 이어진 사례. (WIZnet Makers) |
| 7 | NerdQAxePlus V3.4 — TNA Edition 2026-04-17 | NerdQAxe 계열 운용 펌웨어 | W5500 LAN, Wi-Fi 장애 전환, ASIC 주파수·전압 설정 및 모니터링 기능을 소개. | 파생 플랫폼 확산 가치. 여러 채굴 보드에 W5500 연결을 적용할 수 있는 펌웨어 기반. (TNA Edition LAN and OVERCLOCKING READY) |
| 8 | nerdqaxeplus2-lan-480x320 2026-08-02 | 대형 화면 지원 펌웨어 | NerdQAxe 계열에 480×320 화면과 선택적 W5500 LAN 지원. 현재 원본 저장소는 nerdqaxeplus2-ethernet으로 변경됨. | 후속 설계 확산 가치. 화면·보드 변형에서도 W5500 지원이 유지되고 실기 검증까지 이어짐. (WIZnet Makers) |
| 9 | Nerd Eth interposer support — PR #724 2026-10-08 | 본가 펌웨어 기여 | NerdAxeGaia용 W5500 HAT 지원. 보드별 SPI 핀 설정·자동 감지·리셋 처리를 개선했으며, 원본 develop에 병합됨. | 생태계 확산 가치가 특히 큼. 개별 포크를 넘어 본가에 지원이 반영돼 후속 보드의 도입 부담을 낮춤. (GitHub) |
| 10 | Avalon 10xx Control Board series 2022-09-23 | 상용 채굴기 제어보드 | Avalon 1026·1041·1045·1046·1047용 교체 제어보드 소개. | 잠재 고객 조사 가치. 채굴기 유지보수 시장의 접점이지만 WIZnet 채택 실적으로 집계할 근거는 부족. (maker.wiznet.io) |
| 11 | Avalon 1xx6 Control Board series 2022-09-23 | 상용 채굴기 제어보드 | Avalon 1246·1126·1166·1066 계열 교체 보드 소개. | 잠재 고객 조사 가치. 제어보드 공급업체와 적용 가능성을 확인할 후보. (maker.wiznet.io) |
| 12 | Avalon 1066 Control Board 2022-09-23 | 상용 채굴기 제어보드 | “Mining gateway”로 등록된 단품 소개. 11번과 제품 범위가 일부 겹치며 | 판매채널 탐색 가치. 추가 사양 확인이 필요하며 독립적인 신규 채택 사례로 보기 어려움. (maker.wiznet.io) |
위의 12개 IoT 글의 가장 뚜렷한 공통점은 “기존 비트코인 채굴기에 W5500 유선 Ethernet을 추가한다”는 것입니다.
특히 ESP32-S3 + W5500 + Bitaxe/NerdQAxe 계열 펌웨어 조합이 반복해서 등장합니다.
대체로 대형 상용 비트코인 채굴기는 Ethernet이 표준이고, 소형 가정용·메이커 채굴기에서는 Wi-Fi가 많이 쓰입니다. 두 시장을 나눠 보셔야 합니다.
| 구분 | 주로 사용하는 연결 | 선택 이유 |
|---|---|---|
| 채굴장용 대형 ASIC 채굴기 | 유선 Ethernet | 많은 장비를 24시간 운용하므로 연결 안정성과 일괄 관리가 중요 |
| Bitaxe 같은 소형 홈 채굴기 | Wi-Fi가 흔함 | 집에서 설치하기 편하고, ESP32-S3의 내장 Wi-Fi를 이용해 부품·비용을 줄일 수 있음 |
| 소형 채굴기의 LAN 확장형 | Ethernet + Wi-Fi | 기본 Wi-Fi 구조에 유선 연결을 추가해 사용자가 선택하도록 함 |
