Labs / MicroPython tutorials

Introduction to the EVB-Pico-GraftPort Expansion Board

Author: Li Zisheng · Source: FreakStudio open documentation, v1.1.0 · License: CC BY 4.0

Contents
Introduction to the EVB-Pico-GraftPort Expansion Board
Introduction to the EVB-Pico-GraftPort Expansion Board
Introduction to the EVB-Pico-GraftPort Expansion Board

GraftPort - Raspberry Pi Pico-ETH Expansion Board is a functional expansion board designed for the Raspberry Pi Pico. Built around the WIZnet-EVB-Pico (2)(which integrates a WIZnet Ethernet controller), it can quickly extend networking capabilities and support for multiple types of peripherals for the Pico, making it ideal for IoT and embedded control projects.

Its core features include:

I. Pin Mapping

Note: All pin number descriptions in this document follow the arrangement of the Pico (2) series. If some pin numbers on your development board are different, please refer to the pinout diagram of W5500-EVB-Pico we provided for verification.

1.1 Fixed Hardware Pin Mapping

Introduction to the EVB-Pico-GraftPort Expansion Board
W5500-EVB-Pico Pinout

This part refers to the fixed (non-modifiable) connection between the expansion board and the Raspberry Pi Pico (or other development boards compatible with Pico pins), covering the core on-board hardware functions:(for development boards that are compatible with Pico but have different pin numbers, please refer to the above figure for comparison on your own)

I/OPin NameDescription
IGPIO24VBUS detection pin: high when VBUS is present, otherwise low
OGPIO25Connected to the onboard user LED
IGPIO29Samples the VSYS/3 voltage in ADC mode (ADC3)
IGPIO26Connected to the onboard user button
OGPIO22Connected to WATCHDOG_WDI (watchdog feed pin)

Of course, the development board itself may also have fixed pins. Here, we take the W5500-EVB-Pico as an example.

I/OPin NameDescription
IGPIO16Connected to the MISO pin of the W5500
OGPIO17Connected to the CSn pin of the W5500
OGPIO18Connected to the SCLK pin of the W5500
OGPIO19Connected to the MOSI pin of the W5500
OGPIO20Connected to the RSTn pin of the W5500
IGPIO21Connected to the INTn pin of the W5500

However, this is not strongly related to the expansion board itself. Please refer to the documentation of your own development board.

Here, we can use the RUN DIP switch to select whether the reset signal comes from the on-board button or the watchdog module externally connected to the EXWDG header.

Introduction to the EVB-Pico-GraftPort Expansion Board

1.2 SD Card SPI Interface Configuration

Introduction to the EVB-Pico-GraftPort Expansion Board

The onboard MicroSD card communicates via the SPI protocol, and the pin configuration and circuit information are as follows:

Configuration itemValue / PinNotes
SPI_ID1SPI controller number used
SCLKGP10SD card SPI clock pin, with a 10kΩ pull-up resistor to +3V3
MOSIGP11SD card SPI master output pin, with a 10kΩ pull-up resistor to +3V3
MISOGP12SD card SPI master input pin, with a 10kΩ pull-up resistor to +3V3
CSGP13SD card SPI chip select pin (active low), with a 10kΩ pull-up resistor to +3V3

1.3 Peripheral Interface Pin Mapping

The interfaces in this part are extensible peripheral interfaces, which support the connection of external devices such as sensors and modules, and are classified by interface type as follows.

1.3.1 I2C Interface

It supports 2-channel I2C interfaces, which can be used to connect peripherals compliant with the I2C protocol (such as temperature and humidity sensors, OLED displays, etc.).

I2C ID

SDA pin

SCL pin

Remarks

I2C0

4

5

Channel 1 I2C interface

I2C1

2

3

I2C Interface, Channel 2

Introduction to the EVB-Pico-GraftPort Expansion Board

1.3.2 UART Interface

It supports 1-channel UART interface, which can be used for serial communication (e. g. connecting GPS modules, Bluetooth modules, etc.).

UART Number

TX pin

RX pin

Remarks

UART1

8

9

Channel 1 UART Communication Interface

Introduction to the EVB-Pico-GraftPort Expansion Board

1.3.3 Digital Input/Output (DIO) Interface

Supports 2 sets of digital IO interfaces for digital signal input/output (e. g., relay control, key reading):

Digital interface labelDIO pin 1DIO pin 2Interface numberNotes
DIO0GP6GP7CN3Silkscreen label "DIO0", includes GND and +5V power pins
DIO1GP14GP15CN6Silkscreen label "DIO1", includes GND and +5V power pins

1.3.4 ADC Interface

Supports 1 analog interface for collecting analog signals such as voltage and illuminance:

Interface labelPin combinationNotes
AIN1(GP27, GP28)Includes ADC1_PIN (GP27) and ADC2_PIN (GP28)

None

III. Relevant Software and Hardware Tutorials

3.1 MicroPython Environment Configuration and Firmware Flashing

Here only the W5500-EVB-Pico firmware is provided as an example. For other development boards, please refer to their respective documentation on your own.

W5500_EVB_PICO-20251209-v1.27.0.uf2 1.0 MB

View:

01 Introduction to MicroPython Language — Draft Document Tutorial

02 Setting up the MicroPython Development Environment — Draft Document Tutorial

Introduction to the EVB-Pico-GraftPort Expansion Board

3.2 MicroPython Driver Development and Code Writing

View: Getting Started with MicroPython: Product Introduction to Raspberry Pi Pico Microcontroller / Fengya No. 1 Board (MicroPython Teaching Development Board)

Introduction to the EVB-Pico-GraftPort Expansion Board

3.3 Usage of Various Electronic Modules

View: GraftSense Sensor Module Documentation (Open Version)

Introduction to the EVB-Pico-GraftPort Expansion Board

3.4 View Relevant Teaching Cases

View: https://f1829ryac0m.feishu.cn/drive/folder/NzISfP3xMlPdGfdPzjEcEfjAntb? from= from_copylink

Introduction to the EVB-Pico-GraftPort Expansion Board
Introduction to the EVB-Pico-GraftPort Expansion Board

View: 13 ETH Ethernet - Document Tutorial Draft

IV. Circuit Source Engineering

To obtain the source project of the circuit, please follow the official account [Freak Embedded]

SCH_GraftPort-Raspberry Pi Pico-ETH Expansion Board_v1.1_2025-12-29.pdf 832 KB

5. Driver Code

The following is the code for quickly testing the functions of the expansion board:

5.1 Environment Preparation

pip install mpy-cross mpremote

5.2 Description of Code Package Contents

Here, you only need to extract the following folder:

01 Driver Code.rar 22 KB

Use PyCharm to open the following folder:

Introduction to the EVB-Pico-GraftPort Expansion Board

The folder contains the following core files:

File NameFunction description
pico_mpy_uploader.pyCompile + upload tool: automatically compiles Python files other than main.py to mpy format (saves Pico storage space) and uploads all files to the Pico
main.pyExpansion board test main program: verifies SD card read/write, UART serial send/receive, and onboard LED control
sd_block_dev.py/sdcard.pySD card dependency class: provides low-level support for SD card block device operations, file system mounting, and read/write
AbstractBlockDevInterface.pyBlock device interface abstract class: provides a unified operation interface template for SD card block devices

5.3 Procedure

Here, you first need to SD card into the SDCARD slot on the expansion board, then connect the Raspberry Pi Pico to your computer via USB, open the extracted folder, and run pico_mpy_uploader.py — the script will automatically complete the following steps:

Introduction to the EVB-Pico-GraftPort Expansion Board

After running, the terminal displays the following:

Introduction to the EVB-Pico-GraftPort Expansion Board

We can see that there are additional compiled mpy files in the folder:

Introduction to the EVB-Pico-GraftPort Expansion Board

Next, reset the microcontroller unit, open the terminal, and connect to the Raspberry Pi Pico via mpremote:

Introduction to the EVB-Pico-GraftPort Expansion Board

Next, use a MiniUSB cable to connect the UART interface on the expansion board to a computer, open XCOM to verify whether its serial communication works properly:

Introduction to the EVB-Pico-GraftPort Expansion Board

Then connect the SD card to the computer via a card reader, and you can see that the CSV file has been written successfully:

Introduction to the EVB-Pico-GraftPort Expansion Board
Introduction to the EVB-Pico-GraftPort Expansion Board

VI. Revision History

Document Version

Date of Revision

Modifier

Modify Content

v1.0.0

2025-09-11

Li Zisheng

Draft the document.

v1.0.1

2026-01-04

Li Zisheng

Modify document title

v1.1.0

2026-01-04

Li Zisheng

Created based on internal version v1.0.1.

VII. Relevant Materials

W5500-EVB-Pico_V100.zip 3.4 MB

W5500-EVB-Pico_PL_V100.pdf 49 KB

W5500-EVB-Pico_GB_V100_Single.zip 527 KB

W5500-EVB-Pico_SCH_V100.pdf 871 KB

W5500_EVB_PICO-20251209-v1.27.0.uf2 1.0 MB

7.2 PCB Special Silk Screen Printing

Introduction to the EVB-Pico-GraftPort Expansion Board