GPIO / I2C / SPI / UART

说明低速接口、设备节点、Pin 映射和测试命令。

GPIO

GPIO 可以通过 Linux 标准 GPIO 接口控制。简单输出测试如下：

echo <gpio-number> | sudo tee /sys/class/gpio/export  
echo out | sudo tee /sys/class/gpio/gpio<gpio-number>/direction  
echo 1 | sudo tee /sys/class/gpio/gpio<gpio-number>/value  
echo 0 | sudo tee /sys/class/gpio/gpio<gpio-number>/value

其中 <gpio-number> 替换为实际 Pin 对应的 GPIO 编号。

LED

Neardi Pi 3 板上有电源灯、4G 灯、系统灯和状态灯。电源灯和 4G 灯通常由硬件或模块状态控制；可由用户控制的 LED 节点，不同固件版本可能略有差异。

建议先查看当前系统导出的 LED 节点：

ls /sys/class/leds/

常见用户 LED 节点如下：

# 绿灯
echo 1 | sudo tee /sys/class/leds/work/brightness  
echo 0 | sudo tee /sys/class/leds/work/brightness  
  
# 红灯
echo 1 | sudo tee /sys/class/leds/work1/brightness  
echo 0 | sudo tee /sys/class/leds/work1/brightness

部分固件也可能导出 work2，用于 STA LED。

按键

可以通过输入事件查看板载按键：

cat /proc/bus/input/devices  
sudo evtest

如果系统没有 evtest：

sudo apt install evtest

UART 和 Debug 串口

Type-C Debug 口使用板载 CH340 USB 转串口芯片，串口波特率为 1500000。

使用时先给板卡上电，再把 Type-C Debug 口接到电脑。

按键和 Debug 局部参考图：

Neardi Pi 3 按键和 Debug 局部原理图

常用串口参数：

波特率   : 1500000  
数据位   : 8  
停止位   : 1  
校验位   : None  
流控     : None

普通 UART 测试可以使用 stty、cat 和 echo：

stty -F /dev/ttySx ispeed 115200 ospeed 115200 cs8 -cstopb -parenb  
cat /dev/ttySx  
echo "test" > /dev/ttySx

RTC

Neardi Pi 3 使用 HYM8563 作为 RTC 时钟，设备节点为 /dev/rtc0。

查看当前时间：

# 查看当前系统时间
date  
  
# 读取 RTC 时间
sudo hwclock -r

手动设置时间时，建议先关闭 NTP，再设置系统时间，最后把系统时间写入 RTC：

# 关闭 NTP，避免刚设置的时间马上被网络时间覆盖
sudo timedatectl set-ntp false  
  
# 设置系统时间
sudo timedatectl set-time '2025-11-11 12:00:00'  
  
# 将系统时间写入 RTC
sudo hwclock --systohc  
  
# 查看 RTC 时间
sudo hwclock -r

如果需要开机时从 RTC 恢复系统时间，使用：

sudo hwclock --hctosys

项目确实需要时，可以把这条命令加到较早执行的启动脚本里，比如 /etc/init.d/rockchip.sh。普通联网系统一般会在启动后由 NTP 自动校准时间。

GPIO​

LED​

按键​

UART 和 Debug 串口​

RTC​

GPIO

LED

按键

UART 和 Debug 串口

RTC