Connect to WiFi

FLYOS-FAST System Wi-Fi Connection Guide

System Startup

• To ensure stable device operation, please always use a power adapter of no less than 5V 2A during first startup and subsequent use
• The USB ports on some computers may not meet this standard

Preparation

Ensure your Wi-Fi module is properly installed on the host computer and the router is working normally.

Connection Steps

Step 1: Launch the Network Management Tool

1. Connect to your host computer running the FAST system 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

Configuration Page Operation Instructions

• Please ensure the keyboard input method is in half-width mode, i.e., English mode
• The up arrow key ↑ and down arrow 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 menu items or enter submenus
• 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
   • Frequency 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 * mark will be displayed before the connected Wi-Fi:

  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 obtain the 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 wlan0 or a similar interface is your Wi-Fi IP address

Step 8: Access the Web Console

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

2. Enter the IP address obtained in Step 7 in the address bar (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 upper right corner of the Web Console

2. The system will automatically switch to the other interface without requiring you to log in again:

   Switch to Mainsail:

   Loading...

   Switch to Fluidd:

   Loading...

Connection Success Tips

• First connection: It is recommended to use a wired connection for initial configuration, then switch to Wi-Fi
• Save configuration: Successfully connected Wi-Fi configurations are automatically saved and will auto-connect after restart
• Multi-network environment: If both wired and Wi-Fi are connected simultaneously, the system will prioritize the wired network

Troubleshooting

Common Issues

Issue	Possible Cause	Solution
Cannot see Wi-Fi list	1. Module not properly connected 2. Router too far away 3. Driver incompatible	1. Check module connection 2. Move closer to router 3. Try another compatible module
Connection failed	1. Incorrect password 2. Router restrictions 3. Band mismatch	1. Confirm password is correct 2. Check router MAC filtering 3. Try 2.4G band
Cannot obtain IP	1. DHCP service abnormal 2. Signal too weak	1. Restart router 2. Use static IP configuration

Unable to activate connection

• The error below indicates that during system startup, insufficient power supply caused the file system expansion to fail
• You need to reflash the system and ensure the power adapter can provide at least 5V-2A

Loading...

Supported Wireless Module List

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

Module Type	Series/Model	Supported Band	Antenna Interface	Notes
FLY Official Modules	FLY-M2WE	2.4G/5G Dual Band	IPEX-1	Recommended, stable performance, best compatibility
	FLY-2.4GWiFi	2.4G Band	IPEX-1	Suitable for environments that only require 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 system, plug and play
	MTK (MediaTek) Series MT7601U / MT76X0U / MT76X2U / MT7663U	Depends on specific model	Depends on specific model	Drivers pre-installed in 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 system, plug and play

Usage Recommendations

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

Static IP Configuration (Optional)

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