WHC Wi-Fi Device-Side Driver

Configuration Options and Operating Modes

Linux Host:

MENU CONFIG

WPAoD

WPAoH (cfg80211 Host)

WHC SUPPLICANT OFFLOAD

Y

N

WHC DEV TCPIP KEEPALIVE

O

O

WHC WIFI API PATH

N

Y

WHC CMD PATH

Y

Y

Status

Ready

Ready

Please reference WHC Wi-Fi Configuration Options and Operating Modes for detail information.

WPAoH Device-Side Driver

  • Set up the compilation environment, and run ameba.py menuconfig to access the configuration interface

  • Select WHC_DEV.

    (Top) -> CONFIG WHC INTF -> WHC_MODE
    ----Configuration----
        ( ) WHC_IPC
        (X) WHC_DEV
        ( ) WHC_HOST
    
  • Select the desired interface.

    (Top) -> CONFIG WHC INTF -> HW INTERFACE
    ----Configuration----
        (X) WHC_INTF_SDIO
        ( ) WHC_INTF_USB
        ( ) WHC_INTF_SPI
    

    Note

    RTL8721F:

    To ensure stable USB operation, when WHC_INTF_USB is selected, the SoC defaults to 1.0V with CPU at 240MHz. If other requirements are needed, you can also configure it manually:

    (Top) -> CONFIG User Config -> Clock Configuration -> SoC Clock Config
    (X) [2] 1.0V, Audio(98.304MHz)/USB, CPU 240MHz
    ( ) [3] 1.0V, Audio(45.1584MHz)/USB, CPU 240MHz
    ( ) [5] 1.0V, RMII/USB, CPU 320MHz
    ( ) [6] 1.0V, Audio/USB, CPU 320MHz
    ( ) [7] 1.0V, Audio/RMII, CPU 333.3MHz
    
  • The following IC models should select Boot Source as follows. ICs not listed above do not need to select Boot Source:

    RTL8721F:
    (Top) -> CONFIG WHC INTF -> Boot Source
    (X) Boot From Flash
    ( ) Boot From HCI
    
  • Select modules based your mode, Please reference WHC Wi-Fi Configuration Options and Operating Modes for more informations.

    (Top) -> CONFIG WHC INTF -> WHC config
    ----Configuration----
       (X) Support WHC CMD PATH
       (X) Support WHC WIFI API PATH
       ( ) Support WHC SUPPLICANT OFFLOAD
       ( ) Support WHC DEV TCPIP KEEPALIVE
    

    Note

    • If you want to enable TCP/IP keep-alive on Device-side, please select Support WHC DEV TCPIP KEEPALIVE.

  • Select Wi-Fi NAN or Wi-Fi P2P based on your need:

    (Top) -> CONFIG WIFI
    ----Configuration----
        (X)ENABLE WIFI --->
          CONFIG WIFI MODE --->
             (X) ENABLE NAN
             ( ) ENABLE P2P
    

    Note

    • Wi-Fi NAN or Wi-Fi P2P can only operate in Linux WPAoH mode.

  • Save the menuconfig configuration.

  • Run ameba.py build to generate the firmware: boot.bin, app.bin.

  • Use the image tool to download the firmware to the development board.

WPAoD Device-Side Driver

  • Set up the compilation environment, and run ameba.py menuconfig to access the configuration interface

  • Select WHC_DEV.

    (Top) -> CONFIG WHC INTF -> WHC_MODE
    ----Configuration----
        ( ) WHC_IPC
        (X) WHC_DEV
        ( ) WHC_HOST
    
  • Select the desired interface.

    (Top) -> CONFIG WHC INTF -> HW INTERFACE
    ----Configuration----
        (X) WHC_INTF_SDIO
        ( ) WHC_INTF_USB
        ( ) WHC_INTF_SPI
    

    Note

    RTL8721F:

    To ensure stable USB operation, when WHC_INTF_USB is selected, the SoC defaults to 1.0V with CPU at 240MHz. If other requirements are needed, you can also configure it manually:

    (Top) -> CONFIG User Config -> Clock Configuration -> SoC Clock Config
    (X) [2] 1.0V, Audio(98.304MHz)/USB, CPU 240MHz
    ( ) [3] 1.0V, Audio(45.1584MHz)/USB, CPU 240MHz
    ( ) [5] 1.0V, RMII/USB, CPU 320MHz
    ( ) [6] 1.0V, Audio/USB, CPU 320MHz
    ( ) [7] 1.0V, Audio/RMII, CPU 333.3MHz
    
  • The following IC models should select Boot Source as follows. ICs not listed above do not need to select Boot Source:

    RTL8721F:
    (Top) -> CONFIG WHC INTF -> Boot Source
    (X) Boot From Flash
    ( ) Boot From HCI
    
  • Select modules based your mode, Please reference WHC Wi-Fi Configuration Options and Operating Modes for more informations.

    (Top) -> CONFIG WHC INTF -> WHC config
    ----Configuration----
        (X) Support WHC CMD PATH
        ( ) Support WHC WIFI API PATH
        (X) Support WHC SUPPLICANT OFFLOAD
        ( ) Support WHC DEV TCPIP KEEPALIVE
    

    Note

    • If you want to enable TCP/IP keep-alive on Device-side, please select Support WHC DEV TCPIP KEEPALIVE.

  • Save the menuconfig configuration.

  • Run ameba.py build to generate the firmware: boot.bin, app.bin.

  • Use the image tool to download the firmware to the development board.