跳到主要内容

快速开始

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

你需要准备​

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

所有外部接口都按 3.3 V 逻辑设计，5V 脚只是电源，不要把 5 V 信号接到 GPIO 上。

认清你的板子版本​

丝印和 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​

适合想直接看到一个能交互的系统。镜像已经放在仓库的 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。

提示

想要改动能保留（可写根文件系统，重启后仍在），或者需要 RV64I 版本，可以改用预编译镜像里的 Linux 镜像。流程一样，但那个镜像覆盖整片 16 MiB，写入时会一并覆盖板上持久化的数据。

路线 B：用 Zephyr 开发​

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

下一步​