Wi-SUN Regional Regulation API#
Wi-SUN Regional Regulation API.
This API provides the parameters for regional regulation compliance. It allows to set the duty cycle budget, thresholds for warnings and alerts, and other parameters related to the regional regulation. The Wi-SUN stack provides predefined parameter sets for the following regulations:
ARIB (Japan)
WPC (India)
ETSI (Europe)
The regional regulation is configured with sl_wisun_set_regulation_parameters(). Predefined parameter sets can be used for common regulatory requirements, they can be selected with sl_wisun_set_regulation().
Special attention must be taken with frame length when ARIB regulation is used in Japan. The maximum length of a radio frame is indirectly constrained by the channel bandwidth. This is because the regulation imposes a maximum transmission duration per frame, which varies depending on the bandwidth used:
with a 200 kHz bandwidth, frame duration must be less than 400 ms
with a 400 kHz bandwidth, frame duration must be less than 200 ms
with 600 and 800 kHz bandwidths, frame duration must be less than 100 ms
The Wi-SUN stack doesn't currently enforce these constraints, and defers the responsibility to the application. Depending on the selected PHY, the application must ensure that the transmission duration complies with the ARIB regulation by:
reducing the frame length
adjusting the 6LoWPAN MTU leading to fragmentation for larger packets