Set Up the Wi-SUN PHY Mode Switch Configuration#

Mode Switch Configuration with the Radio Configurator#

Once a new RAILtest project is created, the Radio Configurator opens automatically. You can then select the Wi-SUN FAN 1.1 Profile. The Radio Configurator provides a set of Wi-SUN FSK and OFDM PHYs as part of the Wi-SUN FAN 1.1 profile. The applicable Wi-SUN Regulatory Domain (for example NA, JP, EU, or BZ) according to Wi-SUN FAN 1.1 should be also selected.

To get a Mode Switch configuration between Wi-SUN PHYs, a channel-based multi-PHY configuration is required. More details on channel-based multi-PHY can be found in https://community.silabs.com/s/article/rail-tutorial-multi-phy-usecases-and-examples?language=en_US.

In the Radio Configurator, follow the steps below for an example for NA:

1. In the Protocol, select the Wi-SUN FAN 1.1 Profile and the Wi-SUN Regulatory Domain. In the following figure, the Wi-SUN NA Regulatory Domain is selected.

   

2. Update the default channel configuration. To get a Mode Switch configuration, you can add the PhyModeID as the MSByte of the channel number, which is on 2 bytes. This way, RAIL can associate each PhyModeID with a different channel number, which will be useful in Rx.

   For example, a PhyModeID = 2 (2FSK mode 1b 50 kbps mi=1) provides a channel number of 0x0200=512, as shown.

   

   Note: The Wi-SUN Channel Plan ID list proposed depends on the Wi-SUN Regulatory Domain and on the selected Wi-SUN PHY Mode ID. The Wi-SUN Channel Plan ID selected supports automatically getting the base frequency and the channel spacing according to the Wi-SUN FAN 1.1 specification.

3. Add additional channel configurations for other PhyModeID using Create new channel:

   

4. Enter a Channel group name and the parameters as shown in the following example.

   

5. Add other channels and configure them as previously described for Mode Switch configuration. Use the following tables to compute the base channel number.

Notes:

• By default, the Mode Switch PPDU is always from an FSK to an FSK or an OFDM PhyModeID. Therefore, after a switch to an OFDM PhyModeID, the application should use the setchannel RAILtest CLI command on both the Tx and Rx side to go back on an FSK PhyModeID. Alternatively, the RAILtest command ModeSwitchLife 1 could be used (see The trigModeSwitchTx RAILtest CLI Command).

• Changing OFDM MCS within the same option does not require Mode Switch PPDU but only to set the MCS using set802154phr.

• The OFDM PHY in the .radioconf file for Mode Switch only requires selecting the lowest MCS of the OFDM option available in the selected Wi-SUN Regulatory Domain as described below for the NA Regulatory Domain. Nevertheless, the MSByte of the channel number could use MCS0 PhyModeID.

The set802154phr selects the MCS to be used and the PHYmodeID parameter in the trigModeSwitchTx selects the OFDM option, as described in Script Example.

Mode Switch radio_settings.radioconf Example for NA, JP, EU#

NA, JP, and EU Mode Switch radio_settings.radioconf file is provided as an example with this document. This section provides details on the radio configuration settings.

NA Wi-SUN Regulatory d=Domain#

For example, this Radio Configurator snapshot shows the Mode Switch Multi-PHY-based channel configuration for NA with Channel Plan ID 1, 2, 3, 4, and 5.

The Mode Switch configuration for the NA Regulatory Domain on configindex 0 is summarized in the following table.

Mode switch can be enabled across all PHYs specified in the PhyModeID column.

JP Wi-SUN Regulatory Domain#

This Radio Configurator snapshot shows the Mode Switch Multi-PHY-based channel configuration for JP with Channel Plan ID 21, 22, 23, and 24.

The Mode Switch configuration for the JP Regulatory Domain on configindex 1 is summarized in the following table.

Mode switch can be enabled across all PHYs specified in the PhyModeID column.

Note: In Japan, a channel mask applies and forbids the use of the lower channels. The First Channel number (not masked) column indicates the first valid channel that can be used.

EU Wi-SUN Regulatory Domain Case 1#

This Radio Configurator snapshot shows the Mode Switch Multi-PHY-based channel configuration for EU1. In this example, EU 1 includes both 863-870 MHz and 863-876 MHz bands, resulting in Channel Plan IDs 32, 33, 36, and 37, as shown.

Note the ChanPlanID32 and 36 have the same configuration except that ChanPlanID36 uses the maximum number of channels. The same is true for ChanPlanID33 and 37.

The mode switch configuration for the EU Regulatory Domain on configindex 2 is summarized in the following table.

Mode switch can be enabled across all PHYs specified in the PhyModeID column.

Note: In EU, a channel mask applies and forbids the use of some available channels in the middle and at the end of the RF band. The channel masking in the middle of the RF band is taken into account for Mode Switch thanks to a RAIL callback provided by the stack (see RAIL_lib API Usage for Mode Switch PPDU).

EU Wi-SUN Regulatory Domain Case 2#

This Radio Configurator snapshot shows the Mode Switch Multi-PHY-based channel configuration for EU2 (870-876 MHz) with Channel Plan ID 34 and 35.

The Mode Switch configuration for the EU Regulatory Domain on configindex 3 is summarized in the following table.

Mode switch can be enabled across all PHYs specified in the PhyModeID column.

Note: In EU, a channel mask applies and forbids the use of some available channels in the middle and at the end of the RF band. The channel masking in the middle of the RF band is taken into account for Mode Switch thanks to a RAIL callback provided by the stack (see RAIL_lib API Usage for Mode Switch PPDU).