Bruce's Space

如果你刚刚拿到一块 Synaptics Coral Dev Board (SL2610)，并准备开始你的边缘 AI 或硬件开发之旅，这篇基础入门指南将帮助你避开硬件连接上的常见坑，并教你如何在 Mac 电脑上顺利连接并调试这块开发板。

核心硬件与软件环境简介

强悍的 AI 核心：该开发板搭载了 Synaptics Astra™ SL2619 边缘 AI SoC，并集成了一个 1 TOPS 算力的 Coral NPU。
预装大模型：限量版主板出厂预装了 Google Gemma 3 270M 端侧大语言模型，开箱即用。
软件生态：运行基于 Yocto Linux BSP 的系统，并使用 Torq™ 工具链进行模型的优化和处理。

ℹ️ 官方详细规格：关于该开发板的详细硬件规格和官方文档，请参考 Coral Dev Board (SL2610) 官方页面。

一、硬件连接与关键注意事项

开发板由于是裸露的电路板，在连接各种外设（特别是摄像头）时需要格外小心。

1. 摄像头连接规范

认准接口：请务必将摄像头排线插入 CSI (Camera Serial Interface) 插槽中。千万不要插到 DSI（显示接口）中，这可能会因为电压和引脚定义不同而永久损坏你的摄像头或主板。
防静电保护：在接触板子之前，请先洗手或触摸接地的金属物体，以释放身上的静电。
正确的插入方式：轻轻拉开 CSI 接口上的黑色或白色卡扣，将排线的金属触点（金手指）对准插槽内的引脚插入，然后再把卡扣按下锁定。

2. 供电与数据接口选择（非常重要！）

这块开发板采用双层“三明治”结构：底层的 主板 (Main Carrier Board) 和顶层的 扩展板 (Mezzanine Expansion Board)。

请始终将 USB-C 线连接到底层主板的 USB-C 接口上（通常位于靠近 RESET 按钮的角落）。
为什么？
1. 底板包含了电源管理芯片 (PMIC)。只有先给底板提供 5V 供电，电源才能正确分配给处理器 (SoC)、内存、顶层扩展板和摄像头。
2. 只有底板的 USB 接口直接连接了处理器的 USB 控制器，这样你才能在电脑上通过串口访问 Linux 内核终端。
关于 Mac 供电的注意事项：
- 你可以使用一根标准的 USB-C 线连接 MacBook Pro 为这块开发板供电，这完全没问题（开发板工作在 Device 模式，只接受 5V 输入）。
- 绝对不可能反向通过开发板给你的 MacBook Pro 充电，因为该开发板的 Type-C 接口没有 USB PD (Power Delivery) 协商组件。

3. 高级避坑指南：引脚与电压

在进行进阶的硬件扩展时，请千万牢记以下几点硬件限制，否则极易烧毁主板或导致无法开机：

1.8V 电压限制：开发板上的 I2S 和 I3C 接口全部运行在 1.8V 电平。在连接外设时务必注意电平匹配，切勿直接接入 3.3V 或 5V 信号。
启动引脚冲突：如果你遇到了开发板无法开机的问题，请检查是否因为外接的传感器改变了 SM_SPI1_SDO 引脚的默认电平状态，这会干扰系统启动。
模拟引脚禁忌：mikroBUS 接口上包含了一个纯模拟输入引脚 SM_ADCI3，在编写代码时，永远不要尝试将其配置为数字 GPIO 引脚来使用。

二、认识板载指示灯 (LED)

当你正确插入 USB-C 给底板供电后，观察板子上的 LED 灯可以快速判断当前状态：

🟢 常亮绿灯 (Power LED)：代表主板成功接收到 5V 供电，并且电源管理芯片已经正常初始化了各个电源回路。
🔴 闪烁红灯 (Heartbeat LED)：这通常是用户指示灯（心跳灯）。如果它像心跳一样匀速闪烁，这是非常健康的信号，说明 Yocto Linux 系统内核已经加载并正在正常运行，没有死机。如果系统卡死，这个灯通常会变成常亮红色或完全熄灭。

三、在 Mac 上连接与调试开发板

想要控制开发板，我们需要通过终端连接到它的 Linux 系统。

方法 1：USB 串口连接（推荐）

这是最基础也是最可靠的方式，不需要网络配置。

用 USB-C 线将底板连接到你的 Mac。
打开 Mac 上的 终端 (Terminal)。
输入以下命令查找刚接入的虚拟串口设备：
```
ls /dev/tty.*
```
(你也可能会看到类似 /dev/cu.usbserial* 的设备)
在输出列表中找到类似 tty.usbserial-XXXX 或 tty.usbmodemXXXX 的设备节点。
使用 screen 命令以 115200 波特率连接到该串口：
```
screen /dev/tty.usbserial-XXXX 115200
```
(把 XXXX 替换为你的实际设备名。连接后按下回车键，你应该就能看到登录提示符。一般默认的用户名是 root 或 mendel)

方法 2：通过网络 SSH 连接

如果你的板子已经连上了 Wi-Fi 或插上了网线：

在路由器后台找到开发板的 IP 地址。
在终端输入 SSH 命令连接：
```
ssh root@<开发板的IP地址>
```

四、基础测试：验证摄像头

当你成功登录到开发板的 Linux 终端后，可以运行一些基础命令来测试硬件。

1. 检查摄像头是否被识别

ls /dev/video*

如果成功识别，你应该能看到 /dev/video0（这通常代表你的 CSI 摄像头）。

你可以用以下命令查看更详细的设备信息：

v4l2-ctl --list-devices

2. 拍摄一张测试照片 你可以使用 GStreamer 框架来捕获一张图片并保存为 test.jpg：

gst-launch-1.0 v4l2src device=/dev/video0 num-buffers=1 ! jpegenc ! filesink location=test.jpg

(如果报错，可能是摄像头输出的是 RAW 格式，可以尝试加入格式转换参数，具体参考开发板官方文档)

五、附录：常用命令速查表

为了方便后续开发，这里将文中提到及一些常用的调试命令整理成了速查表：

一切就绪后，你就可以开始尝试在开发板上运行 OpenCV 或者加载 Gemma 等 AI 模型进行本地推理了！祝你开发顺利！

核心硬件与软件环境简介

一、 硬件连接与关键注意事项