企业官网建设流程全解析

1. 项目概述：从冲动下单到点亮屏幕

2022年6月14日，地平线发布了他们的新一代机器人开发板——旭日X3派。那天晚上，我几乎是追着发布会的直播看完了全程，当看到官方演示的AI推理性能和丰富的生态支持时，作为一个常年混迹在嵌入式圈子的老玩家，那种“手痒”的感觉又上来了。几乎没有犹豫，发布会一结束，我就立刻打开了淘宝，找到了官方店铺，拍下了这块当时还热乎着的开发板。付款成功时，看了眼时间，已经是6月15号的凌晨两点。这种为了一块新板子熬夜下单的经历，相信很多嵌入式开发者都懂，那是一种对新技术的纯粹好奇和迫不及待想要上手把玩的冲动。

几天后，快递到了。我手里这块旭日X3派，可以说是国内第一批到达用户手中的板子之一。它被定位为一款面向机器人、AIoT和边缘计算的高性能AI开发板，核心是地平线自研的“旭日®3”芯片。对于嵌入式开发来说，一块板子的“开箱”和“上电”是两个极具仪式感的环节，前者是初见，后者是验明正身。这篇文章，我就以一个一线开发者的视角，带你完整走一遍我从开箱、烧录系统、串口调试到跑通第一个AI视觉例程的全过程。过程中遇到的坑、总结的技巧，我都会毫无保留地分享出来。无论你是刚接触嵌入式的新手，还是想评估这块板子性能的同行，相信这篇详实的记录都能给你提供直接的参考。

2. 开箱与核心硬件初探

2.1 开箱实拍与第一印象

拆开快递的牛皮纸盒，里面是地平线标志性的橙色包装。盒子不大，但设计得很精致。打开后，开发板被稳妥地嵌在防静电泡棉中。第一眼看到旭日X3派本体，它的设计语言非常“工整”和“硬核”。板子采用黑色沉金工艺的PCB，元器件布局紧凑而有序，给人一种扎实可靠的感觉。

板载资源一目了然：正中央是覆盖着散热片的旭日3芯片，四周分布着各种接口。最引人注目的是那个40Pin的扩展接口，其引脚定义与树莓派兼容，这意味着海量的树莓派生态硬件（如传感器HAT、屏幕等）理论上可以即插即用，极大地降低了外围设备开发的难度和成本，这是地平线非常聪明且务实的一步棋。此外，板子上还集成了千兆以太网口、USB 3.0和USB 2.0接口、HDMI输出、MIPI CSI摄像头接口以及一个用于调试的Micro USB串口。作为一款AI开发板，它没有集成Wi-Fi和蓝牙模块，这可能是出于产品定位和稳定性的考虑，需要无线功能的话得通过USB接口外接无线网卡。

整体来看，旭日X3派的硬件配置完全对得起其“AI边缘计算开发板”的称号。接口丰富，扩展性强，特别是那个MIPI CSI接口，直接为视觉应用铺平了道路。做工方面，焊点饱满，器件选型看起来也都是大厂品牌，初步印象分很高。

2.2 开发前的物料清点与准备

在激动地给板子通电之前，充分的准备工作能避免后续很多不必要的麻烦。根据我的经验，玩转一块新的开发板，就像做一个项目，物料清单必须清晰。以下是我为这次旭日X3派体验准备的所有东西，你可以对照检查：

• 核心板卡：地平线旭日X3派开发板，这是毋庸置疑的主角。
• 电源适配器：官方推荐使用5V/3A的电源。这里有个关键点：一定要选择输出稳定、质量可靠的电源。边缘计算任务运行时芯片功耗会攀升，劣质电源可能导致电压不稳，轻则系统重启，重则损坏板卡。我直接用了手头一个口碑不错的品牌5V3A电源，并确保其接口（Type-C）与板子匹配。
• Micro SD卡（TF卡）：这是系统的“硬盘”。我选择了一张16GB容量、Class10或UHS-I以上速度的知名品牌卡。经验之谈：SD卡的速度和稳定性直接影响系统运行体验，特别是涉及大量数据读写（如AI模型加载、日志记录）时，一张烂卡会让你怀疑人生。不建议用旧卡或杂牌卡。
• 读卡器：用于将系统镜像烧录到SD卡中，USB接口的即可。
• 摄像头模组：为了体验其AI视觉能力，我准备了一个兼容的MIPI CSI接口摄像头。旭日X3派对摄像头有一定的兼容性要求，最好使用官方推荐列表中的型号。
• 串口调试模块：这是嵌入式开发的“瑞士军刀”，用于查看系统启动信息、进行命令行操作。我使用了一个常见的USB转TTL模块（如CH340、CP2102芯片的）。
• 显示设备：为了直观看到桌面或AI推理结果，我准备了一台带HDMI接口的显示器以及一根HDMI线。
• 网络环境：由于板子没有Wi-Fi，调试阶段我通过网线将其连接到路由器，以获得网络访问能力，方便后续安装软件和更新。
• 可乐一瓶：这不是玩笑。在后续的AI识别例程中，它将成为我的第一个“测试物体”，让冷冰冰的技术多了一丝生活的趣味。

清点完毕，确保所有物料在手边，我们就可以进入下一个核心环节——给这块板子“注入灵魂”，也就是烧录操作系统。

3. 系统烧录：从镜像下载到上电启动

3.1 镜像选择：桌面版还是服务版？

在地平线开发者社区的“资源中心”，我们可以找到为旭日X3派定制的Ubuntu系统镜像。这里你会面临第一个选择：Ubuntu Desktop（桌面版）还是Ubuntu Server（服务版/服务器版）？

官方的文档给出了明确的提示：由于旭日3芯片不支持GPU硬件加速，因此在使用带图形界面的Desktop版时，所有的桌面渲染工作都将由CPU软解完成。这会导致两个问题：一是系统界面操作可能会感到卡顿；二是CPU资源被图形桌面大量占用，留给AI计算等核心任务的算力就少了。

所以，我的选择建议非常明确：除非你极度需要在板子上直接进行图形化的桌面操作（比如演示、教育场景），否则一律推荐使用Ubuntu Server版本。服务器版没有图形桌面，完全通过命令行操作，系统负载极低，能将宝贵的CPU和内存资源全部用于你的应用程序和AI推理任务。对于真正的嵌入式开发和部署而言，这才是更专业和高效的方式。我本次也选择了Server镜像进行烧录。

下载得到的通常是一个压缩包，解压后获得最终的镜像文件，例如system_sd_card.img。这个.img文件就是包含了完整分区和系统的磁盘映像。

3.2 烧录工具实战：以BalenaEtcher为例

将镜像写入SD卡，我们称之为“烧录”。Windows平台下有很多工具，如Rufus、Win32 Disk Imager等。地平线官方推荐了BalenaEtcher，这款工具界面简洁，跨平台（Windows/macOS/Linux），且能自动校验烧录结果，对新手非常友好。

操作步骤堪称“傻瓜式”：

1. 插入SD卡：将你的Micro SD卡通过读卡器插入电脑USB口。
2. 打开Etcher：运行BalenaEtcher，它的界面通常分为清晰的三个步骤。
3. 选择镜像：点击第一个按钮，找到并选中你刚才解压出来的system_sd_card.img文件。
4. 选择目标磁盘：Etcher通常会自动识别出插入的SD卡。请务必再三确认你选择的是SD卡，而不是电脑自身的硬盘！选错磁盘会导致数据丢失。你可以根据磁盘容量和盘符来辨别。
5. 开始烧录：点击 “Flash!” 按钮。接下来就是等待，过程中工具会先写入，然后进行自动校验。整个流程大概需要5-15分钟，取决于你的SD卡速度和镜像大小。

重要提示：烧录过程会完全格式化SD卡，并清空其上所有数据。请确保SD卡内没有重要文件。

烧录成功后，你会看到提示。此时不要急着拔卡！在Windows系统下，你可能会看到弹窗提示需要格式化SD卡，这是因为Etcher烧录的Linux系统分区Windows无法识别。请务必点击“取消”，千万不要格式化！直接安全弹出SD卡即可。

3.3 上电与首次启动

将烧录好的SD卡插入旭日X3派背面的卡槽，连接好HDMI线到显示器，接上网线。最后，将5V3A的电源适配器插入板子的Type-C电源口。

上电瞬间，你会看到板子上的电源指示灯（通常为红色或绿色）亮起，系统开始启动。显示器上会滚动大量的Linux内核启动信息。第一次启动由于需要扩展文件系统、进行初始配置，时间会稍长一些，大约1-2分钟。最终，你会看到Ubuntu Server的命令行登录提示符：

Ubuntu 20.04.4 LTS sunrise ttyS0 sunrise login:

恭喜你，旭日X3派的基础系统已经成功跑起来了！默认用户名是sunrise，密码也是sunrise。输入密码登录（Linux下输入密码时光标不会移动，这是正常现象），你就进入了这块板子的操作系统内部。然而，对于嵌入式开发，仅仅通过HDMI连接显示器键盘来操作是远远不够的，我们更需要一种更灵活、更常用的调试方式——串口终端。

4. 串口调试环境搭建：开发者的控制台

4.1 硬件连接与驱动安装

串口调试是嵌入式开发的基石。它不依赖网络和图形界面，能稳定地输出系统最底层的启动信息，是排查问题的利器。

首先进行硬件连接。你需要一个USB转TTL串口模块，常见的有基于CH340、CP2102、FT232等芯片的。连接时注意电平匹配，旭日X3派的调试串口是3.3V TTL电平，确保你的模块也支持3.3V输出。

连接三根线：

• 模块的TX->板子的RX(接收端)
• 模块的RX->板子的TX(发送端)
• 模块的GND->板子的GND(地线)

板子上通常会有一个三针或四针的排针，标有UART、DEBUG或TX/RX/GND。请查阅官方板卡资料确认位置。切勿接错线，也切勿将VCC（电源）接到板子上，以免损坏设备。

将USB转TTL模块插入电脑的USB口。如果是Windows系统，可能需要安装对应的串口驱动（CH340驱动非常普遍）。你可以在设备管理器中查看是否识别出一个新的COM口（例如COM3、COM7）。

4.2 终端软件配置与连接

电脑端我们需要一个串口终端软件。Putty、SecureCRT、MobaXterm等都是优秀的选择。我个人偏爱MobaXterm，因为它功能强大，集成了终端、SFTP文件传输、X11转发等，一个软件解决很多问题。

在MobaXterm中建立串口会话：

1. 点击左上角 “Session”。
2. 在弹出的窗口中选择 “Serial”。
3. 在 “Serial port” 下拉菜单中选择你的模块对应的COM口（如COM7）。
4. 设置波特率（Speed）为921600。这是旭日X3派调试串口的默认高速波特率，能保证启动信息流畅输出不丢帧。
5. 其他参数通常保持默认：数据位 8，停止位 1，校验位 None，流控 None。
6. 点击 “OK”。

现在，确保串口线连接正确，然后给旭日X3派重新上电。你会在MobaXterm的终端窗口里，看到如瀑布般滚动的系统启动日志，从U-Boot引导程序到Linux内核加载，再到系统服务启动，一切尽收眼底。当出现sunrise login:提示时，说明系统已启动完成。

通过串口终端登录（用户名/密码均为sunrise），你就获得了一个完全独立于显示器的命令行控制台。以后绝大部分的开发、调试和配置工作，都可以在这个终端里完成。你可以拔掉HDMI线，仅通过一根串口线和一根网线来操作板子，这才是嵌入式开发的常态。

5. 第一个AI应用：运行视觉识别样例

5.1 连接摄像头与运行脚本

系统跑通了，调试环境也有了，是时候体验一下旭日X3派的核心能力——AI推理了。地平线在出厂镜像中预置了丰富的AI样例程序，位于/app/ai_inference/目录下，我们可以直接调用。

首先，连接摄像头硬件：

1. 找到板子上的MIPI CSI接口（一个薄薄的排线插座）。
2. 取出摄像头模组的FPC排线。这里有一个关键细节：注意排线金属触点的朝向和板子上接口的锁扣方向。通常，排线蓝色或黑色标记的一面应朝上（背对PCB板）。轻轻抬起接口的黑色锁扣，将排线插入到底，然后压下锁扣固定。操作要轻柔，避免损坏脆弱的排线。
3. 将摄像头模组固定到合适的位置。

硬件连接好后，通过串口终端登录系统。我们运行一个最简单的MIPI摄像头样例：

# 切换到摄像头样例目录 cd /app/ai_inference/03_mipi_camera_sample/ # 使用sudo权限运行Python脚本 sudo python3 ./mipi_camera.py

这个脚本会做以下几件事：初始化MIPI摄像头、捕获实时视频流、调用板载的AI处理单元（BPU）运行一个预置的图像分类模型（通常是MobileNet等轻量级网络），并将推理结果（物体类别和置信度）以文本形式叠加显示在画面上，最后通过HDMI输出到显示器。

5.2 结果分析与模型初探

运行命令后，如果你的显示器还接着，应该会立刻弹出一个视频窗口，显示摄像头捕捉到的实时画面。我第一时间把准备好的可乐瓶子放到了摄像头前。很快，屏幕上就出现了绿色的识别框和文字，准确地识别为 “bottle” 或 “water bottle”，置信度很高。

但有趣的事情发生了。当我将两个机器人玩具放到画面里时，程序并没有识别出它们是“robot”或“toy”。其中一个甚至被识别成了 “parking meter”（停车计时器）。我仔细看了看那个机器人的造型，圆柱形的身体加个方脑袋，别说，还真有几分神似。

这个现象非常生动地揭示了AI模型的一个基本特性：它只能识别它“认识”的东西。这个预置的模型是在一个大型通用图像数据集（如ImageNet）上训练的，里面包含了“瓶子”、“停车计时器”这些类别，但很可能没有“机器人玩具”这个特定类别。因此，模型会尝试在它已知的类别中，找到一个视觉特征最相似的进行匹配。

这非但不是板子的问题，反而是一个绝佳的起点。它说明了：

1. 旭日X3派的软硬件流水线是通的：从摄像头采集、数据预处理、模型加载到BPU推理、结果渲染输出，整个链路工作正常。
2. 开发的核心将在于模型：要让它识别你的特定物体（零件、缺陷、人脸、手势等），你需要使用自己的数据集，去训练或微调一个专用的模型，然后利用地平线提供的工具链，将这个模型转换成能在旭日BPU上高效运行的格式（.bin文件）。这才是发挥其AI能力的正道。

这个“Hello World”样例虽然简单，但它成功验证了从传感器到AI输出的完整流程，给了开发者巨大的信心。

6. 开发避坑指南与实战经验

6.1 TF卡的选择与处理陷阱

开篇我提到“路边的坑，千万不要踩”。在最初的几次尝试中，我就遇到了一个非常典型的问题：系统无法启动，或者启动后极不稳定，频繁出错。

排查了电源、镜像文件、烧录过程都没问题后，问题指向了TF卡。我最初为了图方便，用的是一张闲置的、品牌不明的旧TF卡。重新换用一张全新的、高速的品牌卡后，所有问题迎刃而解。

经验总结：

• 避坑一：切勿使用劣质或老旧TF卡。嵌入式系统在运行时会有大量的日志写入、临时文件交换等I/O操作。低速、不稳定的存储介质会导致读写错误，引发系统卡顿、崩溃甚至文件系统损坏。建议选择知名品牌的Class10/UHS-I及以上规格的卡，容量16GB或32GB足矣。
• 避坑二：彻底清理旧卡。如果你使用的是一张曾经做过其他系统启动盘（如树莓派）的卡，即使格式化后，也可能残留一些特殊的分区信息，干扰新系统的引导。最稳妥的做法是使用磁盘管理工具（如Windows的diskpart命令）或SD卡格式化工具（如SD Card Formatter），将卡完全清空并恢复为单一分区，然后再进行烧录。
• 操作技巧：在Windows下，可以按Win+R，输入diskpart并回车，依次输入以下命令（请谨慎操作，务必选对磁盘）：

  list disk # 列出所有磁盘，根据大小找到你的SD卡编号（例如 Disk 1） select disk 1 # 选择你的SD卡磁盘 clean # 清除该磁盘所有分区信息 create partition primary # 创建一个主分区 format fs=fat32 quick # 快速格式化为FAT32（可选，因为Etcher烧录时会重新格式化）

  执行clean命令后，这张卡在Windows资源管理器里就“消失”了，直到你用Etcher重新烧录系统。

6.2 电源与散热：稳定运行的基石

旭日X3派在运行AI推理时，BPU和CPU的功耗会显著上升。官方推荐5V3A（15W）电源是有道理的。

• 电源不足的征兆：系统无故重启、USB设备识别不稳定、性能下降。特别是在连接了摄像头、USB外设等高功耗设备时，风险更大。
• 建议：使用足额、质量可靠的开关电源。可以准备一个带电压电流显示的USB测试仪，直观监测板子运行时的实际功耗，做到心中有数。

关于散热，旭日3芯片上已经覆盖了散热片，在常温室内进行一般性开发和测试是足够的。但如果进行长时间的满负荷AI推理压力测试，或者环境温度较高，芯片温度会上升。你可以通过命令cat /sys/class/thermal/thermal_zone0/temp来读取核心温度（数值除以1000单位为摄氏度）。如果温度持续过高（例如超过80°C），可以考虑增加一个低噪音的USB小风扇对着吹，或者使用带风扇的散热外壳，以确保芯片不会因过热而降频。

6.3 网络配置与软件更新

板载的千兆以太网口是主要网络通道。连接网线后，系统通常会自动通过DHCP获取IP地址。你可以用ifconfig或ip addr show eth0命令来查看IP。

获取IP后，第一件事就是更新软件源并升级系统，这能修复一些初始镜像可能存在的已知问题：

sudo apt update sudo apt upgrade -y

升级过程可能需要一些时间，取决于网络速度。

如果需要Wi-Fi，可以插上兼容的USB无线网卡（如常见的使用RTL8812AU芯片的网卡），然后使用nmcli或编辑/etc/netplan/下的配置文件进行连接。社区里通常有整理好的兼容设备列表和驱动安装教程。

6.4 模型部署流程简介

跑通官方样例只是第一步。真正的开发工作是将你自己的AI模型部署到旭日X3派上。地平线提供了一套完整的工具链，大致流程如下：

1. 模型训练：在PC上，使用TensorFlow、PyTorch等框架，训练你的目标检测、分类或分割模型。
2. 模型转换：使用地平线提供的“天工开物” (Horizon Open Explorer, HOE)工具链。这是一个核心步骤，将你训练好的浮点模型（如.onnx）进行量化、优化、编译，最终生成能在旭日BPU上运行的定点模型文件（.bin）。
3. 应用开发：在旭日X3派的Ubuntu系统上，使用地平线的AI推理框架（如hobot_dnn等）编写C++或Python应用程序。你的代码需要调用API来加载.bin模型文件，处理输入数据（如图片），并执行推理，最后解析输出结果。
4. 性能调优：工具链会提供模型分析报告，你可以根据报告调整模型结构、量化策略，以在精度和速度之间取得最佳平衡。

这个过程涉及较多的专业工具和概念，建议从地平线官方文档和社区论坛开始学习，他们提供了详细的教程和案例。

7. 总结与进阶展望

经过从开箱、烧录、调试到运行AI样例的完整流程，这块地平线旭日X3派给我的整体印象是：硬件设计扎实，软件生态开箱即用，AI能力展示直接，为开发者提供了一个非常不错的起点。特别是其与树莓派兼容的40Pin GPIO，极大地丰富了其作为“开发板”的玩法和可能性，不再局限于纯AI计算，而是可以轻松接入各种传感器和执行器，构建真正的机器人或智能设备原型。

对于初学者，我建议的路径是：先严格按照本文步骤，复现从系统安装到跑通摄像头样例的全过程。这个过程能帮你熟悉硬件、掌握基础的系统操作和调试方法。之后，可以尝试用Python控制一下GPIO口，点亮一个LED灯，再尝试用OpenCV（需自行安装）做一些简单的图像处理，最后再挑战将自己的模型部署上去。

对于有经验的开发者，旭日X3派的价值在于提供了一个国产的、算力可观（典型功耗下可达5TOPS INT8算力）的AI边缘计算平台。你可以深入钻研其工具链，将复杂的视觉、语音模型部署到这块小小的板卡上，评估其在真实场景下的性能、功耗和稳定性，为产品化选型做准备。

最后分享一个实用小技巧：你可以将串口终端（如MobaXterm）的会话保存起来，并配置自动登录脚本。这样每次打开软件，一键就能连接上板子，无需重复配置串口参数和输入密码，能节省大量重复操作的时间。嵌入式开发，效率往往就藏在这些细节的优化里。

这块“旭日”已经在地平线上升起，剩下的，就是看你如何用它来照亮你自己的项目了。开发之旅，现在才刚刚开始。