PI-SG565D 单板电脑快速入门

2025-10-17

Edit this page

本章以 PI-SG565D 开发套件为基础，讲解如何快速入门 PI-SG565D 单板电脑。

点此查看PI-SG565D 开发套件的使用指南。

硬件上手

准备工作

在开始连接前，请确认以下物品已准备就绪：

全套 PI-SG565D 开发套件（按“套件清单”核对无缺失）。
额外需准备：
- 支持 5V/5A、9V/3A 或 PD 快充协议的电源适配器。
- 支持 USB-C DP 或 HDMI 的显示器（分辨率建议 1080P 及以上）。
- USB 键盘+鼠标（有线/无线均可，需接入单板电脑的 USB 口）。
- 可联网的路由器（用于单板电脑联网调试）。

硬件连接（关键步骤，按顺序操作）

⚠️ 警告
连接过程中请先断开所有电源，避免带电插拔接口导致硬件损坏！

PI-SG565D 出厂默认搭载 Debian 13 系统镜像，因此无需再次烧录镜像。仅需按照如下步骤操作即可：

显示连接：
- 方案1（高清）：将 USB-C DP 显示线一端接入单板电脑的 USB&DP 接口，另一端接入显示器的 USB-C 接口；
- 方案2（兼容）：将 HDMI 线一端接入单板电脑的 HDMI 接口，另一端接入显示器的 HDMI 接口。
外设连接：将 USB 键盘、鼠标接入单板电脑的两个 USB-A 接口上；若用无线键鼠，将接收器插入 USB 口即可。
网络连接：用网线连接单板电脑网口和路由器的 LAN 口即可。
跳线帽链接：单板电脑左上角标有AUTO_POWER_ON丝印的排针，确保已经用跳线帽短接。
供电连接：最后将 USB-A 电源线的 USB-A 端接入电源适配器，USB-C 端接入单板电脑的电源口（通常标注POWER IN）。

系统启动、登录与更新

启动系统：

⚠️ 若前面硬件连接时，没有将标有AUTO_POWER_ON丝印的排针使用跳线帽短接，则需要先长按单板电脑右侧的PWRKEY按钮，再接通电源，直到系统启动。
- 打开显示器电源，确认显示器输入源已切换到对应的接口（如 USB-C 或 HDMI）。
- 接通单板电源（插好电源线），此时单板电脑的电源灯（通常为红色）会常亮，系统灯（通常为绿色）会闪烁，表明系统正在启动。
- 等待约 1-2 分钟，显示器将显示系统登录界面。
系统登录：
- 默认的用户名为pi，密码为quecpi。
系统更新：
- 打开终端（快捷键 Ctrl+Alt+T），输入以下命令更新系统（确保网络已通）：
```
sudo apt update && sudo apt upgrade -y
```

‼️若系统无法正常启动，请重刷系统镜像

点击下载 Debian13 镜像下载

点此下载和安装 USB 驱动

使用符合要求的电源适配器给单板电脑供电

将单板电脑的 USB&DP 接口连接到电脑

镜像烧录教程

基础功能验证

启动完成后，快速验证核心配件是否正常工作：

显示验证：确认显示器能清晰显示桌面，拖动窗口无卡顿、无花屏；
网络验证：打开浏览器，输入任意网址（如 www.baidu.com），或在终端输入ping 8.8.8.8（测试通外网），若有数据包返回则网络正常；
USB外设验证：用键盘输入字符、鼠标拖动窗口，确认键鼠响应正常。

helloworld

搭建开发环境

登录到 PI-SG565D 的 Debian 系统后，打开终端窗口，输入以下命令并回车，安装必要的开发环境：

sudo apt update && sudo apt install vim gawk gcc g++ build-essential chrpath socat wget diffstat file unzip tar locales zstd debianutils iputils-ping cpio python3 python3-pip net-tools git make cmake

编译与运行 helloworld

在~/Desktop目录下创建helloworld.c文件。

复制以下代码段，粘贴在helloworld.c文件内：

#include <stdio.h>
int main(void)
{
    printf("hello world\r\n");
    return 0;
}

执行以下命令，编译代码：

cd ~/Desktop
gcc helloworld.c -o helloworld

执行以下命令，运行 helloworld 程序：
```
./helloworld
```

程序运行结果打印：

pi@QuecPi:~/Desktop$ ./helloworld
pi@QuecPi:~/Desktop$ hello world
pi@QuecPi:~/Desktop$

PI-SG565D