网络配置

Ruff 提供了三种无线网络配方法：

• 网络广播：开发板无需和电脑连接即可配置无线网络。
• 局域网配置：开发板需要已经和电脑接入同一网络，也可以通过开发板架设无线 AP 完成配置。
• USB 串口配置：电脑需要安装 USB 转串口驱动（Windows, OS X），并且与设备通过 USB 连接。

初次配置

将 Ruff 开发板上的 micro USB 接口与 USB 电源线连接，Ruff 开发板将随即启动。如果是一块全新的开发板，启动完成后会看到红色 LED 闪烁，表示正在等待网络配置。

网络广播

1. 现在使用 rap wifi 命令为开发板配置 WiFi：

   rap wifi

2. 填写好 SSID 和密码后，rap 将会广播 SSID 及密码（如果当前）。此时开发板会通过 LED 指示网络连接情况：

   • 蓝色 LED 闪烁：开发板已经收到配置，正在尝试连接。
   • 蓝色 LED 常亮：连接成功！
   • 蓝色 LED 闪烁变为红色 LED 闪烁：开发板连接网络失败或超时，需要重新配置。

   开发板与电脑需要在同一网段内。开发板目前仅支持 2.4G 频段，所以请配置支持 2.4G 的热点。部分双频路由 2.4G 与 5G 频段互通，电脑仍然可以连接 5G 热点。

常见问题

• 设备始终是红色 LED 闪烁，无法接收到无线配置信息。

  • 路由器对网络广播有限制，如必须已有两个或以上无线设备连接才能进行。
  • 无线网络状况较差，请再次尝试或改善无线网络状况。

• rap wifi 命令显示设备已连接，但当前设备依然在等待配置或者正在连接的状态。

  • 附近可能有多台 Ruff 设备处于等待配置的状态，可能其他设备在当且设备连接成功前已经向电脑发出了连接成功的回应。

AP 模式（局域网）

1. 按下并释放开发板上的 FUNC 键，稍等片刻红色 LED 由慢闪变为快闪，此时开发板便进入了 AP 模式。
2. 用电脑连接 Ruff 开发板架设的热点（名为 Ruff_[SN], 部分老设备为 Ruff_[MAC]）。

3. 执行命令 rap wifi --lan ap 为开发板配置无线连接：

   rap wifi --lan ap

USB 串口模式

1. 安装系统对应的 USB 转串口驱动（Windows，OS X）。

2. 用 USB 数据线将开发板与电脑连接，并确认被识别为串口设备：

   • Windows 下可进入设备管理器，确认有 “端口 (COM & LPT)” > “Prolific USB-to-Serial Comm Port (COMx)” 设备。

   • OS X 下可执行命令 ls /dev/tty.usbserial* 查看相关串口设备：

     ls /dev/tty.usbserial*

3. 执行命令 rap wifi --serial 为开发板配置无线连接（如果存在多个 USB 串口设备，会提示用户选择）：

   rap wifi --serial

常见问题

• 配置过程中提示无法打开串口。
  • 可能是因为已经有程序占用了串口，比如 plink 或 screen。请关闭相关程序后重试（OS X 需要断开设备后重新连接）。

更改配置

Ruff 不支持通过网络广播的方式更改网络配置，所以如果需要修改已经配置好的 WiFi 信息，需要使用另外两种方式或重置开发板。

局域网模式

局域网模式需要开发板和电脑已经接入同一网络，且开发板 IP 地址已知，如：

rap wifi --lan 192.168.31.233

USB 串口模式

与初次配置相同，请参考上方步骤。

重置WiFi

按 RESET 按钮 3 ~ 10 秒，开发版将重置WiFi。

重置开发板

长按 RESET 按钮 10 秒以上，开发板将恢复出厂配置。这样，就可以按照初次配置的方式，重新进行设置。