跳转到内容
YuzukiNeko

快速开始

本文带你用最短路径让板子跑起来。两条路线任选其一，都需要先能让板子进入 FEL 下载模式。

你需要准备

Section titled “你需要准备”
  • 一块 YuzukiNeko，一根 USB 数据线（不是纯充电线）。板子只有一个 USB-C 口，它既供电，也是 FEL 下载口和 USB 设备/主机口。
  • 一个 USB 转串口适配器（3.3 V 电平），用来看控制台输出。串口默认 115200 8N1，无流控。
  • 一台 Windows / Linux / macOS 主机。
  • 下载工具 xfel 或 rfel，见 FEL 下载模式与工具。

认清你的板子版本

Section titled “认清你的板子版本”

丝印和 PCB 上写着版本号。版本不同，引脚标号和部分元件不同，开始前先看一眼：

版本要点
V1.3PD 脚丝印错误（PD10 起比真实 GPIO 少 2），按勘误表换算；microSD 检测下拉偏大
V1.4丝印已更正；microSD 检测下拉 R11 仍是 10 kΩ，换成 1 kΩ 即可
V1.5增加 PSRAM 专用 LDO，支持 32 MiB PSRAM；R11 已改为 1 kΩ

详见勘误与版本差异。

路线 A：刷入 RustSBI + Asterinas，进入 BusyBox shell

Section titled “路线 A：刷入 RustSBI + Asterinas，进入 BusyBox shell”

适合想直接看到一个能交互的系统。镜像已经放在仓库的 02_Firmware/RustSBI-Asterinas/ 中。

  1. 按住 FEL 键，接上 USB 线，松开按键。
  2. 检查 FEL 连接：
    终端窗口
    xfel version
    xfel spinor
    应识别出 F101（chip ID 0x00193700）和 16 MiB Flash。
  3. （强烈建议）先备份原有 Flash：
    终端窗口
    xfel spinor read 0x0 0x1000000 neko-backup.bin
  4. 写入并回读校验：
    终端窗口
    xfel spinor write 0x0 yuzukineko-rustsbi-asterinas.img
    xfel spinor read 0x0 0x6d0000 readback.img
    sha256sum yuzukineko-rustsbi-asterinas.img readback.img
    镜像大小 7,143,424 字节，正好是 0x6d0000，所以读回的范围与镜像等长，两个摘要应一致，并与 SHA256SUMS 中的记录相同。细节见固件页。
  5. 松开 FEL 键，复位：
    终端窗口
    xfel reset
  6. 串口终端 115200 8N1 打开，进入 BusyBox shell。

完整说明与单独替换各组件的方法见 RustSBI + Asterinas。

路线 B：用 Zephyr 开发

Section titled “路线 B：用 Zephyr 开发”

适合需要完整 RTOS、驱动和多媒体功能的用户。Zephyr 的 yuzukineko 板级支持在 F101 工作区内，见 Zephyr。

下一步

Section titled “下一步”