FAQ

关于 Ruff

Ruff 是什么?

Ruff 是一个支持 JavaScript 开发应用的物联网操作系统。

我不懂硬件,也可以用 Ruff 吗?

只要你有过软件开发经验,就可以用 Ruff 开发硬件,毕竟 JavaScript 不是一门复杂的语言。入门之后,再来了解硬件知识不迟。

Ruff 可以用来做什么?

用 Ruff 做什么完全取决于你的想象力,这里有一些小例子,你可以参考一下。

在更实际的场景中,我们已经在很多领域开始了探索:

  • 工业(生产数据采集、降低能耗等)
  • 商业(收集环境信息、降低功耗等)
  • 办公室(门禁、设施共享等)
  • 智能小区(门禁、安防等)
  • ……

使用 Ruff 我还需要编译吗?

不需要,Ruff 开发不需要交叉编译。

使用 Ruff 我还需要写驱动吗?

不需要,你只需要专注应用开发,用到的驱动可以通过软件仓库下载。

Ruff 的开发过程是什么样的?

请到我们的起步走,那里有一段精彩的演示视频等着你。

Ruff 目前支持哪些硬件平台?

从结构上说,Ruff 是跨平台的,可以支持各种硬件。目前,Ruff 开发套件是基于 MIPS 架构,而树莓派版本属于 ARM 架构,后续我们会不断推出适配各种硬件平台的版本。

Ruff 能支持多少种外设?

除了开发套件自带的外设之外,你还可以到我们的软件仓库 搜索。如果你是一个外设厂商,你还可以将自己的设备添加到我们的仓库里。

除了开发板, Ruff 能否用于生产环境?

可以。稍后,我们会提供进一步的解决方案,让 Ruff 应用更容易成为一个用于生产环境的产品。


疑难杂症

启动相关

开发板电源怎么接?

开发板使用 Mini USB 供电,插上 Mini USB 充电线就可以通电了。

开发板上电后多久可以开始使用?

开发板上电后需要一段启动时间,启动期间板载灯会不定时点亮和闪烁,当扩展板上红色灯闪烁时表示系统启动成功,正在等待用户配置WiFi信息。更多指示灯的含义请参考这里

网络配置

开发板支持的无线网络类型:

开发板目前支持的无线加密方式为 WPA-PSK/WPA2-PSK。同时支持无密码验证的开放网络,但是当前不支持二次验证。

为什么开发板连不上5GHz 的 WiFi?

开发板目前仅支持2.4GHz 的频段,所以请使用2.4GHz 连接。

更改了 WiFi 环境后如何重新配置开发板?

再次使用 rap wifi 配置 SSID 和密码就可以了。 如果还是没有配置成功请长按黑色 RESET 键10秒以上恢复出厂设置。

rap scan 搜索不到设备?

请确保你已使用 rap wifi 命令并配置了正确的 SSID 和密钥信息。如果还是搜不到你想要的设备,可以使用 rap scan -t <秒数> 来延长搜索时间,比如 rap scan -t 15

使用 rap wifi 的时候需要将电脑和开发板用网线连接起来吗?

不需要,rap wifi 是使用广播的方式,把开发板放在电脑旁边,输入正确配置信息然后等待,看到 device connected 就可以了。需要注意是输入 SSID 时需要填当前电脑接入的 WiFi 的 SSID,即保证电脑和开发板在同一个网络下。

我的 WiFi 配置总是不成功,还有别的办法配置吗?

请参考这里,找到更多的配置方式。

硬件配置

开发板上的按钮和串口如何使用?

具体使用说明请参照 这里

如何将外部设备和开发板串联起来?

开发套件附送了一些杜邦线,具体接插哪个接口可以在添加过设备(rap device add)后通过 rap layout --visual命令来获得具体接线信息图。

我可以添加开发套件以外的设备吗?

可以,你需要按照开发手册,开发相应的驱动并提交到软件仓库上,之后就可以添加这台设备。

为什么我的传感器不工作或是不够灵敏?

有的传感器是可以设置精度的,通常可以看到一个十字螺丝旋钮,旋转该旋钮就可以调整灵敏度。

我如何得知设备需要的电压?

软件仓库上输入设备型号如 flame-01,搜索到设备后查看信息中的工作电压部分,如显示3.3V-5V,说明3.3V和5V电压都支持。

板子上哪一个按钮是 Reset?

Ruff 开发板子上有2个复位键,红色的复位键按下去后就会重启系统,最右边黑色的 RESET 键长按10秒后再松手,即恢复出厂设置。

开发过程

rap log 看不到信息?

请确保当前目录是在你的应用目录下,看到 Connected to device 就说明连接上了。

rap deploy 卡住了没反应?

通常是网络问题,使用 Ctrl + C 强退后重试一次就会好。

rap device add 告诉我搜索不到设备?

填写型号(model)的时候,请确保你所填的型号(model)在软件仓库上是存在的。

rap device add 后面添加的设备ID可以由我自己定义吗?

是的,本来就是由你定义的,这个ID 是你在程序中用来操作外设的,请注意,它和型号(model)是两个不同的东西。型号(model)是用来在软件仓库搜索设备的。

rap start 后不能正常工作?

请使用 rap log 查看是否有报错,并检验你的代码。

如何更新设备的驱动?

使用 rap device update <设备名> 就可以了。

固件更新

Ruff 的固件怎么更新?

请到 固件升级 了解固件更新的细节。

Ruff 刷新完固件并重启后连不上了?

固件刷新后,需要重新配置板卡网络,具体请参考:交互通道。如果无法搜索到开发板的 AP 无线热点,重启几次板卡后仍然无果,请参考:Ruff 自救指南 ,或者联系客服技术支持。