Ruff Lite 起步走
前提条件
- Ruff Lite 硬件准备就绪
- 驱动和 Flash 工具已安装成功
- Ruff SDK 已安装成功
如果没有准备好,请参考 准备开发环境
第一步:创建 Ruff 应用
- 创建一个新的目录,例如
hello-ruff-lite
- 进入
hello-ruff-lite
目录,执行以下命令创建 Ruff 应用
- TM4C1294
rap init --board tm4c1294-v1 |
- ESP32
rap init --board esp32-air-v40 |
- 根据提示填写应用名称等内容(括号内表示默认值,如果和预期一致,可以直接回车确认)
第二步:添加并激活 session
这一步的目的是创建和开发板的连接通道(一个开发板对应一个连接通道),同一应用目录下可以保存多个连接通道,但处于激活状态下的连接通道只能有一个。
连接通道:描述 PC 如何连接开发板,比如指定端口号/IP 等信息。有了连接通道,所有的交互命令都不需要额外指定这些信息。
- TM4C1294
rap session add --name tm4c --paramters serial=0F0036A7 |
TM4C1294 开发板的 serial 在不同操作系统下都是唯一的,但查询方式不同,在 Mac 上通过
ls /dev/cu.*
查看,Linux 上通过dmesg
查看日志获得
如果开发时只连一个 tm4c1294 开发板,可以略过这个步骤
- ESP32
rap session add --name esp32 --parameters port=/dev/cu.SLAB_USBtoUART |
不同操作系统中,ESP32 开发板对应的设备路径(port)不同,在 MacOS 中是 /dev/cu.SLAB*,在 Linux 中是 /dev/ttyUSBx, 在 Windows 中是 COMx (具体查询的方式不在这里展开)
第三步:下载并安装固件
- 到 Ruff Lite 固件 下载页面 下载所需要的固件
- 刷写固件到开发板
- TM4C1294
rap system upgrade /path/to/ruff-lite-xxx-tm4c1294-v1.bin |
- ESP32
rap system upgrade /path/to/ruff-lite-xxx-esp32.zip |
- 一定要在 Ruff 应用目录中执行以上命令
- 若开发机系统为 Linux,需要在 rap 命令前加
sudo
第三步:部署应用
- TM4C1294
rap deploy |
创建的应用中 src/index.js
的主要逻辑是点亮板载绿色 LED 灯$('#led-1').turnOn();
对于 TM4C1294,#led-1
设备对应板载绿色 LED 灯(关于 LED 位置,请参考 TM4C1294 板载资源 )
- ESP32
rap deploy |
创建的应用中 src/index.js
的主要逻辑是点亮板载蓝色 LED 灯$('#led').turnOn();
对于 ESP32,#led
设备对应板载蓝色 LED 灯(关于 LED 位置,请参考 ESP32 板载资源)
由于 ESP32 自带 WiFi 模块,可以进行联网操作,关于 WiFi 配置,请参考 ESP32 WiFi 配置
如果一切顺利,在应用启动成功后稍等片刻,就可以看到板载 LED 被点亮了。
恭喜,你的第一个 Ruff 应用已经成功地运行了起来。
下一步
添加外设是实际硬件应用开发的重要一环,到 这里 继续 Ruff 起步之旅。