The ConnectCore MP25 is manufactured with a United States of America regulatory domain in accordance with Federal Communications Commission (FCC) regulations. By default, 802.11d protocol and "Additional regulatory domains" support is disabled.

Host product manufacturers using the ConnectCore MP25 on their own designs, and customers using the ConnectCore MP25 Development Kit outside of the United States can either use the default US regulatory domain when allowed by their own country regulations, or set a different regulatory domain region.

Set regulatory domain

If you plan to use the module in a different region, you need to override the wireless and Bluetooth binaries to be loaded using kernel command line parameters. You can define them in U-Boot environment variable extra_bootargs.

For the wireless driver:

=> setenv extra_bootargs brcmfmac.regdmn=World
=> saveenv

The brcmfmac.regdmn parameter can be:

  • US, for USA (default)

  • World, for worldwide

For the Bluetooth driver:

=> setenv extra_bootargs btbcm.regdmn=JRL
=> saveenv

The btbcm.regdmn parameter can be:

  • FCC, for USA (default)

  • CE, for Europe

  • JRL, for Japan

For each regulatory domain, Digi provides four variant CLM (Country Locale Matrix) binary files. Each file applies a different set of power and frequency limitations considering its intended mode of operation (Client/Station or Access Point) and location (indoor or outdoor).

That way, Digi Embedded Yocto includes eight different binary files:

  • U.S. CLM files:

    • cyfmac55500-sdio_US.STAIndoor.clm_blob: Station mode and indoor location (default)

    • cyfmac55500-sdio_US.STAOutdoor.clm_blob: Station mode and outdoor location

    • cyfmac55500-sdio_US.APIndoor.clm_blob: AP mode and indoor location

    • cyfmac55500-sdio_US.APOutdoor.clm_blob: AP mode and outdoor location

  • World CLM files:

    • cyfmac55500-sdio_World.STAIndoor.clm_blob: Station mode and indoor location (default)

    • cyfmac55500-sdio_World.STAOutdoor.clm_blob: Station mode and outdoor location

    • cyfmac55500-sdio_World.APIndoor.clm_blob: AP mode and indoor location

    • cyfmac55500-sdio_World.APOutdoor.clm_blob: AP mode and outdoor location

Driver loads by default the generic cyfmac55500-sdio_US.clm_blob, which is a symlink that points by default to the Station/Indoor US CLM blob file. To select a different mode of operation or location, modify the symlink to point to the desired binary file using the following command and reboot:

# ln -sf __<target-clm-blob-file>__ cyfmac55500-sdio_US.clm_blob

If the World regdmn is selected, driver loads the cyfmac55500-sdio_World.clm_blob symlink instead. This symlink points by default to the Station/Indoor World CLM blob file. Modify the World symlink to point to the desired binary file to select a different mode of operation or location.

When using the US regulatory domain in Japan, and according to current Japanese regulations, channels from 149 to 165, both inclusive, should not be used.

Configuration modes

Digi Embedded Yocto provides the Wi-Fi interface functionality to use different network types:

  • Client infrastructure mode: Digi Embedded Yocto reads the certification region and configures the wireless interface for the specified region. When in worldwide mode, the wireless interface is initially configured in a highly restrictive world regulatory domain. It then listens for access point beacons with country identification elements. Once it connects to an access point with country identification, the wireless interface queries the wireless firmware, which scans the CLM (Country Locale Matrix) file database to return the country’s regulatory limitations.

  • Access point mode: Digi Embedded Yocto uses the hostapd user space daemon to manage access point mode. To work in worldwide regulatory domain, configure the country with the wl command. For instance, to configure for Spain (country code ES):

    # wl country ES

    After configuring the country, bring up the SoftAP wireless interface:

    # ifup wlan1
    Change the country code to match your regulatory domain according to ISO/IEC 3166-1.