CleanAir

Location in GUI: Design » Feature Templates » Wireless » CleanAir Configuration

Diagram

Classes

wireless (catalyst_center.feature_templates)

Name	Type	Constraint	Mandatory	Default Value
cleanair	List	[cleanair]	No

cleanair (catalyst_center.feature_templates.wireless)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
description	String		No
radio_band	Choice	2.4GHz, 5GHz, 6GHz	Yes
enable	Boolean	true, false	No	false
device_reporting	Boolean	true, false	No	false
persistent_device_propagation	Boolean	true, false	No	false
interferers	Class	[interferers]	No

interferers (catalyst_center.feature_templates.wireless.cleanair)

Name	Type	Constraint	Mandatory	Default Value
ble_beacon	Boolean	true, false	No
bluetooth_paging_inquiry	Boolean	true, false	No
bluetooth_sco_acl	Boolean	true, false	No
continuous_transmitter	Boolean	true, false	No
generic_dect	Boolean	true, false	No
generic_tdd	Boolean	true, false	No
jammer	Boolean	true, false	No
microwave_oven	Boolean	true, false	No
motorola_canopy	Boolean	true, false	No
si_fhss	Boolean	true, false	No
spectrum_80211_fh	Boolean	true, false	No
spectrum_80211_non_standard_channel	Boolean	true, false	No
spectrum_802154	Boolean	true, false	No
spectrum_inverted	Boolean	true, false	No
super_ag	Boolean	true, false	No
video_camera	Boolean	true, false	No
wimax_fixed	Boolean	true, false	No
wimax_mobile	Boolean	true, false	No
xbox	Boolean	true, false	No

CleanAir feature templates define spectrum-intelligence settings on a per radio band basis (2.4 GHz, 5 GHz, or 6 GHz). They detect and classify RF interferers such as microwave ovens, jammers, and Bluetooth devices, and can be attached to Wireless Network Profiles via their feature_templates list.

Examples

Example-1: Basic 2.4 GHz CleanAir template with reporting and persistent device propagation enabled, detecting the most common interferers found in office environments:

catalyst_center:
  feature_templates:
    wireless:
      cleanair:
        - name: CLEANAIR_2_4GHZ_OFFICE
          description: CleanAir detection for 2.4 GHz office deployments
          radio_band: "2.4GHz"
          enable: true
          device_reporting: true
          persistent_device_propagation: true
          interferers:
            bluetooth_paging_inquiry: true
            bluetooth_sco_acl: true
            microwave_oven: true
            jammer: true
            continuous_transmitter: true

Example-2: 5 GHz CleanAir template tuned for enterprise environments, detecting wide-band and continuous interferers relevant to the 5 GHz spectrum:

catalyst_center:
  feature_templates:
    wireless:
      cleanair:
        - name: CLEANAIR_5GHZ_ENTERPRISE
          description: CleanAir detection for 5 GHz enterprise deployments
          radio_band: "5GHz"
          enable: true
          device_reporting: true
          persistent_device_propagation: false
          interferers:
            continuous_transmitter: true
            generic_dect: true
            generic_tdd: true
            jammer: true
            si_fhss: true
            super_ag: true
            video_camera: true
            wimax_fixed: true
            wimax_mobile: true

Example-3: Comprehensive 2.4 GHz CleanAir template enabling detection of all supported interferer classes for maximum spectrum visibility:

catalyst_center:
  feature_templates:
    wireless:
      cleanair:
        - name: CLEANAIR_2_4GHZ_FULL
          description: Full interferer detection for 2.4 GHz
          radio_band: "2.4GHz"
          enable: true
          device_reporting: true
          persistent_device_propagation: true
          interferers:
            ble_beacon: true
            bluetooth_paging_inquiry: true
            bluetooth_sco_acl: true
            continuous_transmitter: true
            generic_dect: true
            generic_tdd: true
            jammer: true
            microwave_oven: true
            motorola_canopy: true
            si_fhss: true
            spectrum_80211_fh: true
            spectrum_80211_non_standard_channel: true
            spectrum_802154: true
            spectrum_inverted: true
            super_ag: true
            video_camera: true
            wimax_fixed: true
            wimax_mobile: true
            xbox: true

Attaching to a Wireless Network Profile

A CleanAir template only takes effect once it is attached to a Wireless Network Profile. Reference the template by its name in the profile’s feature_templates list:

catalyst_center:
  feature_templates:
    wireless:
      cleanair:
        - name: CLEANAIR_2_4GHZ_OFFICE
          description: CleanAir detection for 2.4 GHz office deployments
          radio_band: "2.4GHz"
          enable: true
          device_reporting: true
          persistent_device_propagation: true
          interferers:
            microwave_oven: true
            jammer: true

  network_profiles:
    wireless:
      - name: CAMPUS_WIRELESS_PROFILE
        feature_templates:
          - CLEANAIR_2_4GHZ_OFFICE

Note: The enable field is the master switch for the CleanAir configuration — it must be set to true for the feature (including any configured interferers) to take effect. When enable is false, the template is provisioned but CleanAir remains disabled and the interferer detection settings have no effect.

Note: Interferer keys under interferers are radio-band-specific. Only configure interferers that apply to the template’s radio_band:

Interferer	2.4GHz	5GHz	6GHz
ble_beacon, bluetooth_paging_inquiry, bluetooth_sco_acl, microwave_oven, spectrum_80211_fh, spectrum_802154, xbox	✓
generic_dect, generic_tdd, jammer, motorola_canopy, si_fhss, spectrum_80211_non_standard_channel, spectrum_inverted, super_ag, video_camera, wimax_fixed, wimax_mobile	✓	✓
continuous_transmitter	✓	✓	✓

CleanAir templates are referenced from wireless network profiles by adding the template name to the profile’s feature_templates list.