Skip to main content

Connect to WIFI

FLYOS-FAST System Wi-Fi Connection Guide

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

Preparation

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

Connection Steps

Step 1: Launch Network Management Tool

  1. Connect via SSH to your upper computer running the FAST system

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

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

    Loading...
    Loading...

Step 2: Select Connection Operation

Configuration Page Operation Instructions
  • Ensure the keyboard input method is in half-width mode, i.e., English mode
  • Use the and arrow keys to move the cursor up and down to select menu items
  • Press the Enter key to confirm a menu selection or enter a submenu
  • Press the ESC key to return to the previous menu
  1. Use the direction keys to select "Activate a connection"

  2. Press the Enter key 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 direction keys to select the network you want to connect to:

    Loading...
    Important Notes
    • Chinese SSID Not Supported: 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 the Enter key to select the target network

  2. In the password input box that appears, accurately enter your Wi-Fi password:

    Loading...
  3. Press the Enter key to confirm the connection:

    Loading...

Step 6: Confirm Connection Status

After successful connection, the system returns to the network list interface:

  • A * mark will appear before the connected Wi-Fi:

    Loading...
  • Press the Esc key 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 like 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 Web Console

  1. Open your 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 a new login:

    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 reconnect on reboot
  • Multi-Network Environment: If both wired and Wi-Fi connections are active, the system will prioritize the wired network

Troubleshooting

Common Issues

IssuePossible CauseSolution
Wi-Fi list not visible1. Module not connected correctly
2. Router too far away
3. Driver incompatibility
1. Check module connection
2. Move closer to the router
3. Try another compatible module
Connection fails1. Incorrect password
2. Router restrictions
3. Frequency band mismatch
1. Verify password is correct
2. Check router MAC filtering
3. Try the 2.4G band
Cannot obtain IP1. DHCP service malfunction
2. Signal too weak
1. Restart the router
2. Use a static IP configuration

Cannot Activate Connection

  • The following error indicates that during system startup, the power supply was insufficient, causing 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 are wireless network modules officially tested and supported by the FLYOS-FAST system:

Module TypeSeries/ModelSupported BandsAntenna InterfaceNotes
FLY Official ModulesFLY-M2WE2.4G/5G Dual BandIPEX-1Recommended, stable performance, best compatibility
FLY-2.4GWiFi2.4G BandIPEX-1Suitable for environments requiring only 2.4G connection
Third-party
USB Wi-Fi Modules
AIC Series
AIC8800DL / DC / D40 / D80 / D80x2
Depends on specific modelDepends on specific modelSystem has pre-installed drivers, plug and play
MTK Series
MT7601U / MT76X0U / MT76X2U / MT7663U
Depends on specific modelDepends on specific modelSystem has pre-installed drivers, plug and play
Realtek Series
RT61 / RT73 / RT2XX Series
RTL81XX / 87XX / 88XX Series
RTW88 / 89 Series
RTL815X Series
Depends on specific modelDepends on specific modelSystem has pre-installed drivers, plug and play
Usage Recommendations
  1. It is recommended to prioritize using FLY official modules for the best compatibility and stability
  2. Drivers for the aforementioned chips are pre-installed in the system, no additional configuration needed
  3. 5G Wi-Fi support depends on the module hardware capabilities, please refer to the specific product specifications
  4. Antenna Connection: FLY official modules use the IPEX-1 interface, ensure you use matching antennas

Static IP Configuration (Optional)

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