Connect to WiFi

List of Supported Wireless Modules

The following are the wireless network modules officially tested and supported by the FLYOS-FAST system:

Module Type	Series/Model	Supported Bands	Antenna Interface	Notes
Official FLY Modules	FLY-M2WE	2.4G/5G Dual Band	IPEX-1	Recommended for use, stable performance, best compatibility
	FLY-2.4GWiFi	2.4G Band	IPEX-1	Suitable for environments requiring only 2.4G connection
Third-party USB Wi-Fi Modules	AIC Series AIC8800DL / DC / D40 / D80 / D80x2	Depends on specific model	Depends on specific model	Drivers pre-installed in the system, plug and play
	MTK (MediaTek) Series MT7601U / MT76X0U / MT76X2U / MT7663U	Depends on specific model	Depends on specific model	Drivers pre-installed in the system, plug and play
	Realtek Series RT61 / RT73 / RT2XX series RTL81XX / 87XX / 88XX series RTW88 / 89 series RTL815X series	Depends on specific model	Depends on specific model	Drivers pre-installed in the system, plug and play

Usage Suggestions

1. It is recommended to prioritize using official FLY modules to ensure optimal compatibility and stability.
2. The system has drivers for the above chipsets pre-installed, no additional configuration is needed.
3. 5G Wi-Fi support depends on the module's hardware capabilities; please refer to the specific product specifications.
4. Antenna Connection: Official FLY modules use the IPEX-1 interface; please ensure you use a matching antenna.

FLYOS-FAST System Wi-Fi Connection Guide

Preparation

Ensure your Wi-Fi module is correctly installed on the host computer and that your router is functioning properly.

Connection Steps

Step 1: Launch the Network Management Tool

1. Connect to your FAST system host via SSH.

2. Enter the following command in the terminal and press Enter:

   nmtui

3. The system will display the network management tool interface:

   Loading...
   Loading...

Step 2: Select Connection Operation

Operation Instructions for the WiFi Configuration Page

• Please ensure that the keyboard input method is in half-width mode, i.e., English mode.
• The up key ↑ and down key ↓ on the keyboard are used to move the cursor up and down to select menu items.
• The confirm key Enter is used to check the menu or enter a sub-menu.
• The exit key ESC is used to return to the previous menu.

1. Use the keyboard arrow keys to select "Activate a connection".

2. Press Enter to proceed to the next step:

   Loading...

Step 3: View Available Networks

Enter the connection management interface:

Loading...

Step 4: Select Wi-Fi Network

1. The system will automatically scan and list available Wi-Fi networks.

2. Use the arrow keys to select the network you want to connect to:

   Loading...
   Important Notes

   • Chinese SSID Not Supported: Please ensure your Wi-Fi name (SSID) does not contain Chinese characters.
   • Band Support:
     • All modules support 2.4G Wi-Fi.
     • 5G Wi-Fi support depends on the module model (FLY-M2WE supports 5G).
   • Signal Strength: The number of * symbols after the Wi-Fi name indicates signal strength (more * means stronger signal).

Step 5: Enter Wi-Fi Password

1. Press Enter to select the target network.

2. In the pop-up password input box, accurately enter your Wi-Fi password:

   Loading...

3. Press Enter to confirm the connection:

   Loading...

Step 6: Confirm Connection Status

After a successful connection, the system will return to the network list interface:

• A connected Wi-Fi network will be marked with a *:

  Loading...

• Press Esc twice to return to the main menu:

  Loading...

Step 7: Obtain Device IP Address

1. After returning to the terminal, enter the following command to get network configuration:

   ip a | grep inet

2. Look for an IP address similar to 192.168.x.x or 10.x.x.x:

   Loading...
   Quick Identification

   Usually, the inet address under the wlan0 or similar interface is your Wi-Fi IP address.

Step 8: Access Web Console

1. Open a browser (Chrome, Edge, Firefox, etc.).

2. In the address bar, enter the IP address obtained in Step 7 (e.g., http://192.168.1.179).

3. Press Enter to access the FLYOS-FAST Web Console:

   Loading...

Advanced Features

Web Interface Switching

FLYOS-FAST supports seamless switching between Mainsail and Fluidd:

1. Click the Mainsail/Fluidd icon in the top-right corner of the Web Console.

2. The system will automatically switch to the other interface without requiring re-login:

   Switch to Mainsail:

   Loading...

   Switch to Fluidd:

   Loading...

Connection Success Tips

• First-time connection: It is recommended to use an Ethernet cable for initial configuration, then switch to Wi-Fi.
• Save configuration: Successfully connected Wi-Fi configurations are automatically saved and will reconnect after a reboot.
• Multi-network environment: If both Ethernet and Wi-Fi are connected, the system will prioritize the wired network.

Troubleshooting

Common Issues

Issue	Possible Causes	Solutions
Cannot see Wi-Fi list	1. Module not connected properly 2. Router is too far away 3. Driver incompatibility	1. Check module connection 2. Move closer to the router 3. Try other compatible modules
Connection failure	1. Incorrect password 2. Router restrictions 3. Band mismatch	1. Confirm password is correct 2. Check router MAC filtering 3. Try the 2.4G band
Cannot obtain IP	1. DHCP service issue 2. Signal too weak	1. Restart the router 2. Use static IP configuration

Static IP Configuration (Optional)

• If you need to configure a static IP, you can select "Edit a connection" in nmtui for advanced settings.
• Reference is provided below.
  Loading...