RuyiSDK 外设示例
可直接在开发板上进行编译和运行的示例，适合初学者快速上手。
安装依赖包
sudo apt update; sudo apt install -y wget tar zstd xz-utils git build-essential
安装 ruyi 包管理器
wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/tags/0.47.0/ruyi-0.47.0.riscv64
chmod +x ruyi-0.47.0.riscv64
sudo cp -v ruyi-0.47.0.riscv64 /usr/local/bin/ruyi
安装工具链
ruyi update
ruyi install gnu-plct llvm-plct
I2C
本文介绍如何使用 RuyiSDK 在 Milk-V Duo S 开发板上快速部署编译环境，并构建 SSD1306 I2C OLED 屏幕测试程序，验证屏幕显示功能。
1. 准备工作
-
开发板：Milk-V Duo S (512M, SG2000)
-
传感器：0.96寸 OLED 屏幕（SSD1306，I2C接口）
-
其他：microSD 卡、USB Type-C 数据线、杜邦线 4 根（母对母）
操作系统安装与启动验证
确保您的开发板已准备好系统。
参考文档：https://github.com/DuoQilai/riscv-board-custom-dev/blob/main/Duo_S/boot_DuoS.md
2. 硬件连接
请参考以下引脚对照表及图片将模块连接至 Duo S。
| 连接名称 | VCC | GND | SCL | SDA |
|---|---|---|---|---|
| 连接引脚 | 3.3V | GND | PIN7 | PIN11 |
| OLED模块 | 信号 | Milk-V Duo S |
|---|---|---|
| VCC | 3.3V供电 | J3头部 1脚（3.3V） |
| GND | 地 | J3头部 6脚（GND） |
| SCL | I2C时钟 | J3头部 7脚（B18） |
| SDA | I2C数据 | J3头部 11脚（B11） |
3. 获取源码
克隆源码
ruyi extract milkv-duo-examples
mv milkv-duo-examples-* duo-examples
cd duo-examples
4. 编译应用与验证
创建虚拟环境
ruyi venv -t toolchain/gnu-plct manual venv-gnu-plct
. ~/duo-examples/venv-gnu-plct/bin/ruyi-activate
验证工具链版本
riscv64-plct-linux-gnu-gcc -v
编译 I2C 程序
cd i2c/ssd1306_i2c
riscv64-plct-linux-gnu-gcc -o ssd1306_i2c ssd1306_i2c.c -I/home/pingguo/duo-examples/include/system -L/home/pingguo/duo-examples/libs/system/musl_riscv64 -lwiringx
验证结果
检查生成的二进制文件：
file ssd1306_i2c
5.传输并运行
默认用户名：root，默认密码：milkv
# 传输到开发板
scp ssd1306_i2c root@192.168.42.1:/root/
# SSH 登录开发板
ssh root@192.168.42.1
# 配置引脚功能
duo-pinmux -w B18/IIC1_SCL
duo-pinmux -w B11/IIC1_SDA
# 运行测试
./ssd1306_i2c
运行后 OLED 屏幕应显示文字内容：
Hello MilkV Duo!
Hello MilkV Duo!