Quectel Pi H1单板电脑快速入门

Quectel Pi
1

一、概要

本教程以 Quectel Pi H1开发套件 为核心平台，旨在帮助开发者快速上手并掌握 Pi H1 单板电脑 的基础开发与使用，讲解如何快速入门Pi H1单板电脑。

点击查看Pi H1 开发套件的使用指南。

二、硬件上手

2.1、准备工作

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

  • 全套 Pi H1 开发套件（按“套件清单”核对无缺失）。

  • 额外需准备：

    • 支持 5V/5A、9V/3A 或 PD 快充协议的电源适配器。

    • 支持 USB-C DP 或 HDMI 的显示器（分辨率建议 1080P 及以上）。

    • USB 键盘+鼠标（有线/无线均可，需接入单板电脑的 USB 口）。

    • 可联网的路由器（用于单板电脑联网调试）。

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

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

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

  1. 显示连接：

  • 方案1（高清）：将 USB-C DP 显示线一端接入单板电脑的 USB&DP 接口，另一端接入显示器的 USB-C 接口；

  • 方案2（兼容）：将 HDMI 线一端接入单板电脑的 HDMI 接口，另一端接入显示器的 HDMI 接口。

11.jpg|autoxauto

  1. 外设连接：将 USB 键盘、鼠标接入单板电脑的两个 USB-A 接口上；若用无线键鼠，将接收器插入 USB 口即可。

connect_keyboard_and_mouse.jpg|autoxauto

  1. 网络连接：用网线连接单板电脑网口和路由器的 LAN 口即可。

connect_net_cable.jpg|autoxauto

  1. 跳线帽链接：单板电脑左上角标有AUTO_POWER_ON丝印的排针，确保已经用跳线帽短接。

connect_jumper_cap.jpg|autoxauto

  1. 供电连接：最后将 USB-A 电源线的 USB-A 端接入电源适配器，USB-C 端接入单板电脑的电源口（通常标注POWER IN）。

connect_power_cable.jpg|autoxauto

2.3、系统启动、登录与更新

  1. 启动系统：

:warning: 若前面硬件连接时，没有将标有AUTO_POWER_ON丝印的排针使用跳线帽短接，则需要先长按单板电脑右侧的PWRKEY按钮，再接通电源，直到系统启动。

power_key.jpg|autoxauto

  • 打开显示器电源，确认显示器输入源已切换到对应的接口（如 USB-C 或 HDMI）。

  • 接通单板电源（插好电源线），此时单板电脑的电源灯（通常为红色）会常亮，系统灯（通常为绿色）会闪烁，表明系统正在启动。

  • 等待约 1-2 分钟，显示器将显示系统登录界面。

  1. 系统登录：
  • 默认的用户名为pi，密码为quecpi。

system_work.jpg|autoxauto

  1. 系统更新：
  • 打开终端（快捷键 Ctrl+Alt+T），输入以下命令更新系统（确保网络已通）：
sudo apt update && sudo apt upgrade -y

:double_exclamation_mark:若系统无法正常启动，请重刷系统镜像

2.4、基础功能验证

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

  • 显示验证：确认显示器能清晰显示桌面，拖动窗口无卡顿、无花屏；

  • 网络验证：打开浏览器，输入任意网址（如 www.baidu.com），或在终端输入ping 8.8.8.8（测试通外网），若有数据包返回则网络正常；

  • USB外设验证：用键盘输入字符、鼠标拖动窗口，确认键鼠响应正常。

三、helloworld

3.1、搭建开发环境

登录到 Pi H1 的 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

3.2、编译与运行 helloworld

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

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

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

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

    cd ~/Desktop
gcc helloworld.c -o helloworld

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

    ./helloworld

  5. 程序运行结果打印：

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

四、更多功能

点此查看 Quectel Pi H1 单板电脑更多功能体验。