June 18, 2020
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 email@example.com if you need any assistance.
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
New HomeKit add-on for CDRouter!
The HomeKit add-on for CDRouter provides fully automated testing of the Apple HomeKit-enabled Router Certification Test Plan. For more information, please contact firstname.lastname@example.org.
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
5GHz, respectively. [ch3761]
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 add-on 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
New WiFi band steering test
TEST: wifi_50 MODULE: wifi DESCRIPTION: WiFi Band Steering test
New add-on 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
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]
- Updated the ET Open ruleset shipped with the CDRouter Security add-on to version 9477. [ch5176]
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_typefield 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