Adding Ethernet to WaveShare RP2040-LCD-1.28 with a WIZnet W5500 Adapter Board
A compact breakout and Ethernet adapter board for the WaveShare RP2040-LCD-1.28, adding W5500-based wired network capability with familiar CircuitPython code.
Adding Wired Ethernet to the RP2040-LCD-1.28
(Project by Akihiro “akkiesoft” Suzuki (Japan))
This project introduces a custom Ethernet expansion board for the WaveShare RP2040-LCD-1.28, designed by Japanese maker and open-source creator Akihiro “akkiesoft” Suzuki.
Akkiesoft is well known in the Japanese maker community for his RP2040, CircuitPython, and PCB-design projects, frequently exhibiting at OSC Tokyo/Hokkaido, Maker Faire Tokyo, and Raspberry JAM Tokyo.
His work is regularly featured across blogs, Mastodon, GitHub, and even MagPi Monday, making him one of the more recognizable independent PCB designers in the RP2040 ecosystem.
Background
The WaveShare RP2040-LCD-1.28 is a compact, round-display board ideal for small UI-centric projects.
However, the lack of onboard networking—and the use of a 1.27 mm dual-row GPIO connector—limits practical applications.
To overcome this, the creator designed two custom expansion boards specifically for the RP2040-LCD-1.28.
https://www.waveshare.com/wiki/RP2040-LCD-1.28
Two Custom Expansion Boards
The project includes two boards:
1) A 1.27 mm → 2.54 mm breakout board, making the RP2040-LCD-1.28’s unusual connector easy to use with standard headers
2) A dedicated Ethernet expansion board for WIZnet W5500-based SPI Ethernet modules
These additions allow the RP2040-LCD-1.28 to gain stable wired LAN capability and greatly improve prototyping convenience.
Build Process and Debugging
During assembly and testing—where the SPI lines were wired to GP16–20 and CircuitPython code was used for quick validation—the creator discovered an issue:
The 1.27 mm connector had been soldered rotated 180 degrees, causing the pinout to be mirrored.
Fortunately, the power rails remained safe and only the GPIO mapping needed correction.
By removing one misaligned pin and adjusting the GPIO assignments in software, the board successfully connected to the WIZnet Ethernet module and obtained an IP address.
This restored reliable network functionality to the RP2040-LCD-1.28.
Hardware Integration
The completed setup is simple and compact:
The WIZnet module is soldered onto the expansion PCB, then mounted beneath the RP2040-LCD-1.28 via the fine-pitch connector.
The design keeps the overall hardware minimal while extending the board’s usability significantly.
Open Resources and Additional Links
All PCB designs—including the initial “mistake” revision—are fully published on GitHub.
Anyone looking to add Ethernet connectivity to the RP2040-LCD-1.28, or to design their own companion boards, can reuse or adapt these files freely.
GitHub Repository
https://github.com/Akkiesoft/ws_lcd128_bo
Creator’s Blog
https://akkiesoft.hatenablog.jp/
Creator’s GitHub
https://github.com/Akkiesoft
Creator’s Mastodon
https://mstdn.maud.io/@akkiesoft
Related appearances
OSC Tokyo / Maker Faire Tokyo / Raspberry JAM Tokyo
RP2040-LCD-1.28 보드에 유선 이더넷을 더하는 확장 보드 제작기
Maker : Akihiro “akkiesoft” Suzuki (Japan)
이번 프로젝트는 일본의 오픈소스 메이커로 활발히 활동 중인 Akihiro “akkiesoft” Suzuki 님이 설계하신 RP2040-LCD-1.28 전용 Ethernet 확장 보드를 소개합니다.
akkiesoft 님은 오픈소스 컨퍼런스(OSC Tokyo / Hokkaido), Maker Faire Tokyo, Raspberry JAM Tokyo 등 다양한 행사에서 꾸준히 작품을 발표해 온 제작자로, RP2040 기반 프로젝트와 KiCad PCB 설계로 잘 알려져 있습니다.
MagPi Monday, 일본 메이커 커뮤니티, Mastodon, GitHub 등에서도 활발한 활동을 이어가며 매년 개인 PCB 제작 기록을 공유하는 등 영향력 있는 제작자 중 한 분입니다.
프로젝트 배경
WaveShare RP2040-LCD-1.28 보드는 원형 디스플레이가 결합된 독특한 RP2040 플랫폼으로, UI 중심의 소형 프로젝트를 만들기엔 충분히 재미있는 보드입니다.
https://www.waveshare.com/wiki/RP2040-LCD-1.28
하지만 네트워크 기능이 빠져 있어 활용도가 제한적이라는 점은 많은 사용자들이 공감하는 부분이었습니다.
akkiesoft 님 역시 이 보드를 몇 년 동안 “언젠가 써야지” 하며 보관해두다가, 결국 직접 확장 보드를 설계해 문제를 해결하기로 하셨습니다.
두 가지 확장 보드 설계
작성자분이 설계한 보드는 두 가지입니다.
첫 번째는 1.27 mm 듀얼 소켓을 일반 2.54 mm 핀으로 변환하는 브레이크아웃 보드,
두 번째는 WIZnet의 SPI Ethernet 모듈(W5500 계열)을 바로 장착할 수 있도록 만든 전용 Ethernet 확장 보드입니다.
RP2040-LCD-1.28의 독특한 커넥터 구조를 표준화하고, 동시에 유선 네트워크 기능까지 더하려는 목적에서 출발한 설계입니다.
조립 과정과 문제 해결 경험
Ethernet 확장 보드 조립 후 SPI 라인을 GP16~20으로 배선하고 CircuitPython 기반 코드를 적용해 테스트하는 과정에서,
1.27 mm 커넥터가 180도 회전된 상태로 실장된 오류가 발생했습니다.
그러나 전원 라인은 큰 문제가 없었고, GPIO 매핑만 변경하면 되는 수준의 문제였기 때문에 한 핀을 제거하고 코드에서 핀 번호만 조정해 해결하셨습니다.
이후 정상적으로 WIZnet 모듈을 통한 IP 획득이 이루어졌고, RP2040-LCD-1.28에서도 안정적인 이더넷 연결이 확인되었습니다
확장 보드 장착 모습
확장 보드 위에 Ethernet 모듈을 납땜한 뒤 뒤집어 장착하는 구조로, 전체 구성은 단순하지만 미세 피치 핀을 다루는 만큼 세심한 작업이 필요합니다.
결과적으로 네트워크 기능이 없던 RP2040-LCD-1.28 보드를 다시 실용적인 프로젝트 플랫폼으로 확장할 수 있는 형태가 완성되었습니다.
공개된 자료와 활용성
akkiesoft 님은 수정 전 버전과 완성된 버전을 모두 포함해 GitHub에 PCB 설계 파일을 공개하셨습니다.
RP2040-LCD-1.28 환경에서 유선 네트워크 기능을 활용해보고 싶은 분들에게 매우 유용한 참고 자료이며,
이 보드를 기반으로 새로운 응용 프로젝트를 만들기에도 적합합니다.
- GitHub Repository : https://github.com/Akkiesoft/ws_lcd128_bo
- 작성자 개인 블로그 : https://akkiesoft.hatenablog.jp/
- 작성자 GitHub : https://github.com/Akkiesoft
- 작성자 Mastodon : https://mstdn.maud.io/@akkiesoft
- 관련 기술 이벤트 : OSC Tokyo / Maker Faire Tokyo / Raspberry JAM Tokyo 등에서 다수의 RP2040·Ethernet 프로젝트 발표



