Selecting Domain (Optional)

Wireless communications and channels are tightly regulated in every country on Earth, and this applies to Wi-Fi networks as well. Not every one of all existing predefined channels is allowed to be used in every country. It is your responsibility to set the correct "domain" for your Wi-Fi device. This is done through the wln.domain property. The domains supported by the GA1000 and WA2000 are US (FCC), EU, and JAPAN.

The WM2000 and WS1102 support a vastly larger amount of regulatory domains. For a complete list, see Wi-Fi Regulatory Domains.

In addition, both of these devices support the Companion App, which makes the configuration of Wi-Fi parameters, including the regulatory domain, far more straightforward and convenient.

The selection you make restricts available channels for wln.activescan and wln.associate methods. These are the methods that cause the GA1000, WA2000 to transmit data. The wln.scan method is not restricted by the selected domain in any way, because it only listens for incoming Wi-Fi signals, without actually transmitting anything.

One side effect of the above is that you may be able to discover a network with wln.scan, yet be unable to associate with it because this network is operating on a channel that is disallowed in a currently selected domain!

The wln.domain property can't be changed while the Wi-Fi hardware is operational (wln.enabled = 1 — YES).