Ruff Lite 起步走

前提条件

  1. Ruff Lite 硬件准备就绪
  2. 驱动和 Flash 工具已安装成功
  3. Ruff SDK 已安装成功

如果没有准备好,请参考 准备开发环境

第一步:创建 Ruff 应用

  1. 创建一个新的目录,例如 hello-ruff-lite
  2. 进入 hello-ruff-lite 目录,执行以下命令创建 Ruff 应用
  • TM4C1294
rap init --board tm4c1294-v1
  • ESP32
rap init --board esp32-air-v40
  1. 根据提示填写应用名称等内容(括号内表示默认值,如果和预期一致,可以直接回车确认)

第二步:添加并激活 session

这一步的目的是创建和开发板的连接通道(一个开发板对应一个连接通道),同一应用目录下可以保存多个连接通道,但处于激活状态下的连接通道只能有一个。

连接通道:描述 PC 如何连接开发板,比如指定端口号/IP 等信息。有了连接通道,所有的交互命令都不需要额外指定这些信息。

  • TM4C1294
rap session add --name tm4c --paramters serial=0F0036A7
rap session activate tm4c

TM4C1294 开发板的 serial 在不同操作系统下都是唯一的,但查询方式不同,在 Mac 上通过 ls /dev/cu.* 查看,Linux 上通过 dmesg 查看日志获得

如果开发时只连一个 tm4c1294 开发板,可以略过这个步骤

  • ESP32
rap session add --name esp32 --parameters port=/dev/cu.SLAB_USBtoUART
rap session activate esp32

不同操作系统中,ESP32 开发板对应的设备路径(port)不同,在 MacOS 中是 /dev/cu.SLAB*,在 Linux 中是 /dev/ttyUSBx, 在 Windows 中是 COMx (具体查询的方式不在这里展开)

第三步:下载并安装固件

  1. 到 Ruff Lite 固件 下载页面 下载所需要的固件
  2. 刷写固件到开发板
  • TM4C1294
rap system upgrade /path/to/ruff-lite-xxx-tm4c1294-v1.bin
  • ESP32
rap system upgrade /path/to/ruff-lite-xxx-esp32.zip
  1. 一定要在 Ruff 应用目录中执行以上命令
  2. 若开发机系统为 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 起步之旅。