# 旭日X3派新手入门教程：从开箱到运行AI Demo 本教程将带您完整体验旭日X3派（2GB RAM版本）的初次使用流程，包括开箱检查、系统烧写、常见问题解决、以及通过手机摄像头远程运行目标检测Demo的实战技巧。内容基于地平线算法工程师的亲身实测，旨在帮助新手快速上手并避开常见坑点。 --- ## 一、开箱与硬件概览

收到快递后，您会看到一个标志性的蓝色包装盒，这是地平线经典配色。

盒内包含：

• 旭日X3派开发板本体（本批次为2GB RAM版本）
• USB串口线（用于调试）
• 散热片（建议安装，避免高温降频）

拆开防静电袋后，可以看到板子做工扎实，整体大小与树莓派接近。

--- ## 二、系统烧写与首次启动

在收到板子前，建议先阅读官方文档：
https://developer.horizon.ai/api/v1/fileData/documents_pi/index.html

2.1 烧写步骤

1. 准备一张TF卡（建议容量≥16GB，且优先选择A1或A2速度等级）。
2. 使用烧写工具（如Rufus或balenaEtcher）将系统镜像写入TF卡。
3. 将TF卡插入板子，连接电源和串口线（可选），上电启动。

2.2 常见问题：无法启动（TF卡兼容性）

重要提示： 并非所有TF卡都能与旭日X3派兼容。笔者初次使用之前树莓派上正常使用的8G卡，无论烧写Server版还是Desktop版镜像，均无法启动。通过串口线查看uboot输出，提示无法识别TF文件系统。

解决方案： 更换一张新TF卡（笔者更换为64G卡后一次成功）。建议优先选用知名品牌的TF卡，并参考官方社区推荐的兼容列表。

2.3 选择系统版本

官方提供两种镜像：Server版（无桌面，适合服务器/远程使用）和Desktop版（带轻量桌面）。需要注意：

• 旭日X3派不带GPU，桌面渲染由CPU完成，因此桌面操作时鼠标会有明显拖影，性能较低。
• 板子的CPU主频不高，强项在于BPU（神经网络处理器）的AI推理计算。
• WiFi仅支持2.4GHz（802.11 b/g/n），不支持5GHz（802.11ac），传输速率有限。

--- ## 三、安装并运行AI Demo

系统启动后，下一步是体验BPU的AI性能。官方提供了丰富的示例代码（分类、检测、分割），相关代码说明详细，可直接运行。

3.1 准备摄像头

官方Demo支持USB摄像头和MIPI摄像头。笔者从同事处借来一个MIPI摄像头，但遇到兼容性问题：

• 连接后，I2C总线能识别到设备，但运行针对MIPI的目标检测示例时提示“摄像头无法打开”。
• 说明并非所有型号的MIPI摄像头都受支持，建议优先使用官方推荐的摄像头型号。

3.2 巧用手机摄像头（RTSP推流方案）

手中无USB摄像头？别急，可以用手机摄像头替代。方法：

1. 在手机上安装RTSP推流软件（推荐VXG，Google Play可下载）。

2. 打开软件，点击齿轮图标进入设置：
• Network Server Type 选择 RTSP
• 分辨率建议设置为 1920x1080
• 选择目标摄像头

3. 点击R按钮开始推流，界面上会显示RTSP地址（例如 rtsp://192.168.10.98:8554/...）。

4. 确保手机和旭日X3派处于同一局域网。

3.3 修改Demo代码读取RTSP流

以官方示例 usb_camera_fcos.py 为例，修改方法非常简单：

1. 打开文件，找到第252行左右（原代码使用OpenCV读取USB摄像头）。
2. 将 cv2.VideoCapture(0) 替换为 cv2.VideoCapture("rtsp://你的手机IP:端口/...")。
3. OpenCV默认支持RTSP协议，无需额外安装库。

修改后保存，运行脚本：

python3 usb_camera_fcos.py

如果一切正常，您将看到实时目标检测结果！

--- ## 四、小提示与常见问题

小提示

• 首次上电建议连接串口线观察uboot输出，便于排查TF卡兼容性问题。
• 如果使用桌面版系统，建议通过SSH远程操作，避免桌面卡顿影响体验。
• RTSP推流时，手机和板子尽量靠近路由器，减少网络延迟。
• 官方文档中的示例代码注释清晰，建议认真阅读后再修改。

常见问题（Q&A）

1. 问：为什么我的TF卡无法启动？
   答：可能是兼容性问题。请更换一张不同品牌/型号的TF卡，建议使用主流品牌（如闪迪、金士顿等）的A1/A2等级卡。也可参考官方社区公布的兼容列表。
2. 问：MIPI摄像头无法打开怎么办？
   答：目前MIPI摄像头支持列表有限。建议优先使用官方测试过的型号，或者改用USB摄像头。如果必须使用MIPI，可联系官方技术支持确认兼容性。
3. 问：我没有USB摄像头，也没有MIPI摄像头，怎么办？
   答：可以按文中方法使用手机摄像头通过RTSP推流。安卓手机安装VXG软件，设置好RTSP推流后，在Demo代码中将cv2.VideoCapture(0)替换为RTSP地址即可。
4. 问：桌面版系统鼠标拖影严重，是否正常？
   答：正常。旭日X3派没有GPU，桌面由CPU软件渲染，性能有限。建议首选Server版通过SSH操作，或只使用桌面进行简单配置。
5. 问：WiFi速度慢怎么办？
   答：板子仅支持2.4GHz WiFi，理论速率约150Mbps。如果对网络带宽有较高要求（如高清视频流），建议使用有线以太网接口。

--- ## 五、下集预告

下一期将探索：旭日X3派 + Intel NCS2 计算棒 = ？ 敬请期待！

本文转自地平线开发者社区

原作者：yjcn

原链接：https://developer.horizon.ai/forumDetail/98129467158916313