Connect to WIFI

Install the Antenna on Gemini

• The red arrow indicates the WIFI antenna interface
• The WIFI antenna port is ipex1
• Install the antenna on Gemini, otherwise poor signal may prevent network connectivity
• If you don't have an M2WE or 2.4G_WiFi module, you'll need to connect an Ethernet cable to search for an IP address

Loading...

List of Supported Wireless Modules

The following wireless network modules have been officially tested and are 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	Varies by specific model	Varies by specific model	Drivers pre-installed in system, plug and play
	MTK (MediaTek) Series MT7601U / MT76X0U / MT76X2U / MT7663U	Varies by specific model	Varies by 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	Varies by specific model	Varies by specific model	Drivers pre-installed in system, plug and play

Usage Recommendations

1. It is recommended to prioritize using official FLY modules to ensure optimal compatibility and stability.
2. Drivers for the above chipsets are pre-installed in the system, no additional configuration is required.
3. 5G Wi-Fi support depends on the module's hardware capability; 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

Preparations

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

Connection Steps

Step 1: Start the Network Management Tool

1. Connect to your FAST system host via SSH.

2. In the terminal, enter the following command 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 the 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 upper 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
No Wi-Fi list visible	1. Module not connected properly 2. Router 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
Unable to 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 image below:
  Loading...