给你的路由器编程

This guide will show you how to use the FRC® Radio Configuration Utility software to configure your robot’s wireless bridge for use outside of FRC events.

在开始使用此软件之前:

  1. Disable all other network adapters

  2. Plug directly from your computer into the wireless bridge ethernet port closest to the power jack and make sure no other devices are connected to your computer via ethernet.

警告

OM5P-AN 和 AC 使用与 D-Link DAP1522 相同的电源插头,但是它们是 12V 路由器。将路由器连接到 VRM 上的 12V 2A 端口 (中心引脚正极) 。

先行准备

FRC 路由器配置工具需要管理员权限才能配置您电脑上的网络设置。该程序会自动请求必要的权限 (如果您使用非管理员帐户登录计算机,则可能需要密码) 。如果遇到问题,尝试用管理员帐户运行。

从以下链接下载最新的 FRC 路由器配置工具安装程序:

注解

There are no changes to this tool for the 2021 season so the 20.0.0 version is still the latest available.

FRC 路由器配置 20.0.0

`FRC 路由器配置 20.0.0 以色列版本<https://firstfrc.blob.core.windows.net/frc2020/Radio/FRC_Radio_Configuration_20_0_0_IL.zip>`_

注解

此 _IL 版本适用于以色列团队。为了使软件能在以色列使用,其包含一个有受限信道的 OM5PAC 固件版本。

应用须知

By default, the Radio Configuration Utility will program the radio to enforce the 4Mbps bandwidth limit on traffic exiting the radio over the wireless interface. In the home configuration (AP mode) this is a total, not a per client limit. This means that streaming video to multiple clients is not recommended.

The Utility has been tested on Windows 7, 8 and 10. It may work on other operating systems, but has not been tested.

程控配置

Lists the names of each of the status lights on the two legal radios.

运行时,“路由器配置工具” 会通过内置程序将一些配置直接设定到路由器中。这适用于所有模式下的路由器 (包括在比赛时) 。这些配置包括:

  • Set a static IP of 10.TE.AM.1

  • Set an alternate IP on the wired side of 192.168.1.1 for future programming

  • 桥接有线端口,以便端口互换使用

  • The LED configuration noted in the graphic above.

  • 4Mb/s bandwidth limit on the outbound side of the wireless interface (may be disabled for home use)

  • QoS rules for internal packet prioritization (affects internal buffer and which packets to discard if bandwidth limit is reached). These rules are:

    • Robot Control and Status (UDP 1110, 1115, 1150)

    • Robot TCP & NetworkTables (TCP 1735, 1740)

    • Bulk (All other traffic). (disabled if BW limit is disabled)

  • DHCP server enabled. Serves out:

    • 10.TE.AM.11 - 10.TE.AM.111 on the wired side

    • 10.TE.AM.138 - 10.TE.AM.237 on the wireless side

    • Subnet mask of 255.255.255.0

    • Broadcast address 10.TE.AM.255

  • DNS server enabled. DNS server IP and domain suffix (.lan) are served as part of the DHCP.

At home only:

  • SSID may have a “Robot Name” appended to the team number to distinguish multiple networks.

  • Firewall option may be enabled to mimic the field firewall rules (open ports may be found in the Game Manual)

警告

It is not possible to modify the configuration manually.

安装此软件

The radio configuration installer .exe file in windows explorer.

Double click on FRC_Radio_Configuration_VERSION.exe to launch the installer. Follow the prompts to complete the installation.

Part of the installation prompts will include installing Npcap if it is not already present. The Npcap installer contains a number of checkboxes to configure the install. You should leave the options as the defaults.

启动软件

The FRC Radio Configuration Utility in the start menu.

使用 “开始” 菜单或桌面快捷方式启动程序。

注解

If you need to locate the program, it is installed to C:\Program Files (x86)\FRC Radio Configuration Utility. For 32-bit machines the path is C:\Program Files\FRC Radio Configuration Utility

如果出现弹窗提示,请允许程序对系统进行更改

User Account Control dialog that pops up when running the config utility.

If your computer is running Windows, a prompt may appear about allowing the configuration utility to make changes to the computer. Click Yes if the prompt appears.

Select the network interface

Each of the Parts of the Network Interfaces selection pop up.

Use the pop-up window to select the which ethernet interface the configuration utility will use to communicate with the wireless bridge. On Windows machines, ethernet interfaces are typically named “Local Area Connection”. The configuration utility can not program a bridge over a wireless connection.

  1. If no ethernet interfaces are listed, click Refresh to re-scan for available interfaces.

  2. Select the interface you want to use from the drop-down list.

  3. Click OK.

Open Mesh Firmware Note

For the FRC Radio Configuration Utility to program the OM5P-AN and OM5P-AC radio, the radio must be running an FRC specific build of the OpenWRT firmware. OM5P-AC radios in the 2019 KoP should not need an update.

If you do not need to update or re-load the firmware, skip the next step.

警告

Radios used in 2019 do not need to be updated before configuring, the 2020 tool uses the same 2019 firmware.

Loading FRC Firmware to Open Mesh Radio

Highlighting the radio dropdown and the Load Firmware button on the main configuration utility screen.

If you need to load the FRC firmware (or reset the radio), you can do so using the FRC Radio Configuration Utility.

  1. Follow the instructions above to install the software, launch the program and select the Ethernet interface.

  2. Make sure the Open Mesh radio is selected in the Radio dropdown.

  3. Make sure the radio is connected to the PC via Ethernet.

  4. Unplug the power from the radio. (If using a PoE cable, this will also be unplugging the Ethernet to the PC, this is fine)

  5. Press the Load Firmware button

  6. When prompted, plug in the radio power. The software should detect the radio, load the firmware and prompt you when complete.

警告

If you see an error about NPF name, try disabling all adapters other than the one being used to program the radio. If only one adapter is found, the tool should attempt to use that one. See the steps in Disabling Network Adapters for more info.

Teams may also see this error with foreign language Operating Systems. If you experience issues loading firmware or programming on a foreign language OS, try using an English OS, such as on the KOP provided PC or setting the Locale setting to “en_us” as described on this page.

Select Radio and Operating Mode

Highlights the Radio and Mode dropdown boxes.
  1. Select which radio you are configuring using the drop-down list.

  2. Select which operating mode you want to configure. For most cases, the default selection of 2.4GHz Access Point will be sufficient. If your computers support it, the 5GHz AP mode is recommended, as 5GHz is less congested in many environments.

选择选项

Setting the robot name will change the SSID.  The checkboxes make the radio more similar to competition operation.

The default values of the options have been selected to match the use case of most teams, however, you may wish to customize these options to your specific scenario:

  1. Robot Name: This is a string that gets appended to the SSID used by the radio. This allows you to have multiple networks with the same team number and still be able to distinguish them.

  2. Firewall: If this box is checked, the radio firewall will be configured to attempt to mimic the port blocking behavior of the firewall present on the FRC field. For a list of open ports, please see the FRC Game Manual.

  3. BW Limit: If this box is checked, the radio enforces a 4 Mbps bandwidth limit like it does when programmed at events. Note that in AP mode, this is a total limit, not per client, so streaming video to multiple clients simultaneously may cause undesired behavior.

注解

Firewall and BW Limit only apply to the Open Mesh radios. These options have no effect on D-Link radios.

警告

The “Firewall” option configures the radio to emulate the field firewall. This means that you will not be able to deploy code wirelessly with this option enabled. This is useful for simulating blocked ports that may exist at competitions.

Starting the Configuration Process

At the bottom of the screen is instructions for completing the configuration process.

Follow the on-screen instructions for preparing your wireless bridge, entering the settings the bridge will be configured with, and starting the configuration process. These on-screen instructions update to match the bridge model and operating mode chosen.

Configuration Progress

The progress bar dialog while the configuration is working.

Throughout the configuration process, the window will indicate:

  1. The step currently being executed.

  2. The overall progress of the configuration process.

  3. All steps executed so far.

Configuration Completed

A pop up dialog indicating the programming was successful.

Once the configuration is complete:

  1. Press OK on the dialog window.

  2. Press OK on the main window to return to the settings screen.

Configuration Errors

A error dialog pop up.

If an error occurs during the configuration process, follow the instructions in the error message to correct the problem.

故障排除

  • Disable all other network adapters.

  • Make sure you wait long enough that the power light has stayed solid for 10 seconds.

  • Make sure you have the correct network interface, and only one interface is listed in the drop-down.

  • Plug directly from your computer into the wireless bridge and make sure no other devices are connected to your computer via ethernet.

  • Ensure the ethernet is plugged into the port closest to the power jack on the wireless bridge.

  • If using a foreign language Operating System, try using an English OS, such as on the KOP provided PC or setting the Locale setting to “en_us” as described on this page.