CDRouter 12.3

June 18, 2020

Notices

Important Installation Notes

If you are upgrading from CDRouter 11.x or earlier versions, you must meet the prerequisites listed in the CDRouter 12.0 Release Notes prior to upgrading to CDRouter 12.3. Please review that document and contact support@qacafe.com if you need any assistance.

Config Upgrades

CDRouter 12.3 includes many new features and configuration testvars. Old config files can be automatically upgraded to include all new CDRouter 12.3 testvars using the config upgrade utility.

New Features and Enhancements

Apple HomeKit

  • New HomeKit expansion for CDRouter!

    The HomeKit expansion for CDRouter provides fully automated testing of the Apple HomeKit-enabled Router Certification Test Plan. For more information, please contact sales@qacafe.com.

CDRouter

  • The Top 100 test list has been updated!

    All FTP and TFTP related test cases have been removed from the Top 100 test list in favor of more HTTP and HTTPS test cases. This change was made because FTP and TFTP are less relevant today and not as widely used as HTTP and HTTPS. In addition, three basic LAN side ARP test cases have been added.

    The table below summarizes the changes to the Top 100:

    Test Cases Removed Test Cases Added
    cdrouter_basic_1 arp_1
    cdrouter_app_2 arp_2
    cdrouter_app_3 arp_3
    cdrouter_app_10 cdrouter_http_300
    cdrouter_app_11 cdrouter_http_301
    cdrouter_app_12 cdrouter_http_250
    cdrouter_app_15 cdrouter_http_270
    cdrouter_app_16 cdrouter_http_280
    cdrouter_app_17 cdrouter_https_250
    cdrouter_app_18 cdrouter_https_300
    cdrouter_app_124 cdrouter_https_301

  • New WiFi band steering test case

    Band steering is a proprietary technique used to push, or steer, specific clients to either the 2.4 or 5 GHz frequency band. Steering is typically used for load balancing across multiple radios or to improve the overall aggregate performance of the AP by forcing older legacy clients to the 2.4 GHz band and/or newer more modern clients to the 5 GHz band.

    Band steering is not officially defined or included in any IEEE 802.11 specification. However, it is a widely supported feature in modern WiFi access points and is implemented in a variety of ways by different manufacturers. Band steering is only possible for dual-band clients and requires that the AP broadcast the same SSID and use the same security settings on all radios and bands.

    CDRouter’s new wifi_50 test case verifies the DUT’s band steering functionality. The new testvar lan80211BandSteering defines the expected band steering behavior of the DUT. If band steering is not supported or enabled, set this testvar to a value of none. If the DUT is configured to steer clients to either the 2.4 or 5 GHz band, set this testvar to a value of 2.4GHz or 5GHz, respectively. [ch3761]

Testvar Updates

Testvars added to this release:

  • The new testvar lan80211BandSteering is used in the wifi_50 test case to configure the expected WiFi band steering behavior of the DUT. [ch3761]

  • The new HomeKit expansion introduces six new testvars: supportsHomeKit, homeKitRouterName, homeKitHATHostname, homeKitHATRulesPath, homeKitRouterSetupCode, and homeKitManualEnabled.

Testvars modified or removed in this release:

  • The testvars lanChannel and wanApChannel have been updated to support twelve new 5 GHz channels: 68, 72, 76, 80, 84, 92, 96, 144, 169, 173, 177, and 181. [ch5110]

New Test Modules and Test Cases

CDRouter

  • New WiFi band steering test

    TEST: wifi_50
MODULE: wifi
DESCRIPTION: WiFi Band Steering test

Apple HomeKit

  • New expansion and test module for Apple Homekit-enabled Router Certification Test Plan

    MODULE: homekit
DESCRIPTION: Apple HomeKit Secure Router Certification Test Plan
NEW TEST CASES: 53

Notes

CDRouter

  • CDRouter’s wifi channel plan has been updated. Twelve new 5 GHz channels are now available: 68, 72, 76, 80, 84, 92, 96, 144, 169, 173, 177, and 181. These new channels are supported by CDRouter’s LAN clients and may also be used by CDRouter’s AP on the WAN.

    Note that when CDRouter is in AP mode on the WAN the list of available channels is restricted by the frequency band, regulatory settings, and capabilities of the underlying hardware and drivers. If the selected channel is not available or cannot be used, CDRouter will generate a warning and abort the test run. [ch5110]

  • The logging in tests cdrouter_dos_20, cdrouter_dos_21, cdrouter_dos_31, cdrouter_dos_33 and cdrouter_dos_34 has been updated to resolve some misleading log messages. [ch4381]

  • Updated the cdrouter_mcast_70 test case to resolve a false positive test result. [ch4921]

CDRouter Security

  • Updated the ET Open ruleset shipped with the CDRouter Security expansion to version 9477. [ch5176]

CDRouter USP

  • The Broadband Forum has changed the name of TR-469 to TP-469. All references to TR-469 within CDRouter have been updated to reflect this change. [ch5328]

  • In previous releases CDRouter’s USP controller used the msg_type field in the protobuf header to drive events. Changes in the USP 1.1 specification require a different approach. CDRouter now infers a message’s type from the decoded protobuf message instead of relying on the msg_type field. [ch5398]