1 # Copyright (c) 2012 The Chromium Authors. All rights reserved. 2 # Use of this source code is governed by a BSD-style license that can be 3 # found in the LICENSE file. 4 5 """Base class for NetgearWNDR dual band routers.""" 6 7 import urlparse 8 import dynamic_ap_configurator 9 import ap_spec 10 11 from selenium.common.exceptions import TimeoutException as \ 12 SeleniumTimeoutException 13 14 15 class NetgearDualBandAPConfigurator( 16 dynamic_ap_configurator.DynamicAPConfigurator): 17 """Base class for NetgearWNDR dual band routers.""" 18 19 20 def _alert_handler(self, alert): 21 """Checks for any modal dialogs which popup to alert the user and 22 either raises a RuntimeError or ignores the alert. 23 24 Args: 25 alert: The modal dialog's contents. 26 """ 27 text = alert.text 28 if 'WPA-PSK [TKIP] ONLY operates at \"Up to 54Mbps\"' in text: 29 alert.accept() 30 raise RuntimeError('Wrong mode selected. %s' % text) 31 elif '2.4G and 5G have the same SSID' in text: 32 alert.accept() 33 raise RuntimeError('%s. Please change the SSID of one band' % text) 34 elif 'do not want any wireless security on your network?' in text: 35 alert.accept() 36 elif 'recommends that you set the router to a high channel' in text: 37 alert.accept() 38 elif 'security authentication cannot work with WPS' in text: 39 alert.accept() 40 elif 'WPS requires SSID broadcasting in order to work' in text: 41 alert.accept() 42 else: 43 raise RuntimeError('We have an unhandled alert on AP %s: %s' % 44 (self.host_name, text)) 45 46 47 def get_number_of_pages(self): 48 return 1 49 50 51 def is_update_interval_supported(self): 52 """Returns True if setting the PSK refresh interval is supported. 53 54 @return True is supported; False otherwise 55 """ 56 return False 57 58 59 def get_supported_bands(self): 60 return [{'band': ap_spec.BAND_2GHZ, 61 'channels': ['Auto', 1, 2, 3, 4, 5, 6, 7, 8, 9 , 10, 11]}, 62 {'band': ap_spec.BAND_5GHZ, 63 'channels': ['Auto', 36, 40, 44, 48, 149, 153, 64 157, 161, 165]}] 65 66 67 def get_supported_modes(self): 68 return [{'band': ap_spec.BAND_2GHZ, 69 'modes': [ap_spec.MODE_G, ap_spec.MODE_N]}, 70 {'band': ap_spec.BAND_5GHZ, 71 'modes': [ap_spec.MODE_A, ap_spec.MODE_N]}] 72 73 74 def is_security_mode_supported(self, security_mode): 75 """Returns if the supported security modes. 76 77 @param security_mode: the security mode to check against 78 79 """ 80 return security_mode in (ap_spec.SECURITY_TYPE_DISABLED, 81 ap_spec.SECURITY_TYPE_WPAPSK, 82 ap_spec.SECURITY_TYPE_WPA2PSK, 83 ap_spec.SECURITY_TYPE_WEP) 84 85 86 def navigate_to_page(self, page_number): 87 """Navigates to the given page. 88 89 @param page_number: page number to open as an iteger 90 91 """ 92 if page_number != 1: 93 raise RuntimeError('Invalid page number passed. Number of pages ' 94 '%d, page value sent was %d' % 95 (self.get_number_of_pages(), page_number)) 96 page_url = urlparse.urljoin(self.admin_interface_url, 97 'WLG_wireless_dual_band.htm') 98 try: 99 for i in range(5): 100 self.get_url(page_url, page_title='NETGEAR Router') 101 if 'NETGEAR Router' in self.driver.title: 102 break 103 except SeleniumTimeoutException, e: 104 xpath = '//button[@name="yes" and @class="purpleBtn"]' 105 for i in range(5): 106 element = self.wait_for_object_by_xpath(xpath) 107 if element and element.is_displayed(): 108 self.click_button_by_xpath(xpath) 109 break 110 else: 111 self.driver.refresh() 112 self.wait_for_object_by_xpath('//input[@name="ssid" and @type="text"]') 113 114 115 def save_page(self, page_number): 116 """Saves all settings. 117 118 @param page_number: the page to save. 119 120 """ 121 self.click_button_by_xpath('//button[@name="Apply"]', 122 alert_handler=self._alert_handler) 123 124 125 def set_mode(self, mode, band=None): 126 # The mode popup changes based on the security mode. Set to no 127 # security to get the right popup. 128 self.add_item_to_command_list(self._set_security_disabled, (), 1, 600) 129 self.add_item_to_command_list(self._set_mode, (mode, ), 1, 700) 130 131 132 def _set_mode(self, mode, band=None): 133 if mode == ap_spec.MODE_G or mode == ap_spec.MODE_A: 134 mode = 'Up to 54 Mbps' 135 elif mode == ap_spec.MODE_N: 136 mode = 'Up to 300 Mbps' 137 else: 138 raise RuntimeError('Unsupported mode passed.') 139 xpath = '//select[@name="opmode"]' 140 if self.current_band == ap_spec.BAND_5GHZ: 141 xpath = '//select[@name="opmode_an"]' 142 self.wait_for_object_by_xpath(xpath) 143 self.select_item_from_popup_by_xpath(mode, xpath, 144 alert_handler=self._alert_handler) 145 146 147 def set_radio(self, enabled=True): 148 # We cannot turn off the radio in Netgear 149 return None 150 151 152 def set_ssid(self, ssid): 153 self.add_item_to_command_list(self._set_ssid, (ssid,), 1, 900) 154 155 156 def _set_ssid(self, ssid): 157 xpath = '//input[@name="ssid"]' 158 if self.current_band == ap_spec.BAND_5GHZ: 159 xpath = '//input[@name="ssid_an"]' 160 self.set_content_of_text_field_by_xpath(ssid, xpath) 161 self._ssid = ssid 162 163 164 def set_channel(self, channel): 165 self.add_item_to_command_list(self._set_channel, (channel,), 1, 800) 166 167 168 def _set_channel(self, channel): 169 position = self._get_channel_popup_position(channel) 170 channel_choices = ['Auto', '01', '02', '03', '04', '05', '06', '07', 171 '08', '09', '10', '11'] 172 xpath = '//select[@name="w_channel"]' 173 if self.current_band == ap_spec.BAND_5GHZ: 174 xpath = '//select[@name="w_channel_an"]' 175 channel_choices = ['Auto', '36', '40', '44', '48', '149', '153', 176 '157', '161', '165'] 177 self.select_item_from_popup_by_xpath(channel_choices[position], 178 xpath, 179 alert_handler=self._alert_handler) 180 181 182 def set_band(self, band): 183 if band == ap_spec.BAND_5GHZ: 184 self.current_band = ap_spec.BAND_5GHZ 185 elif band == ap_spec.BAND_2GHZ: 186 self.current_band = ap_spec.BAND_2GHZ 187 else: 188 raise RuntimeError('Invalid band sent %s' % band) 189 190 191 def set_security_disabled(self): 192 self.add_item_to_command_list(self._set_security_disabled, (), 1, 1000) 193 194 195 def _set_security_disabled(self): 196 xpath = '//input[@name="security_type"]' 197 if self.current_band == ap_spec.BAND_5GHZ: 198 xpath = '//input[@name="security_type_an"]' 199 self.click_button_by_xpath(xpath, alert_handler=self._alert_handler) 200 201 202 def set_security_wep(self, key_value, authentication): 203 # The button name seems to differ in various Netgear routers 204 self.add_item_to_command_list(self._set_security_wep, 205 (key_value, authentication), 1, 1000) 206 207 208 def _set_security_wep(self, key_value, authentication): 209 xpath = '//input[@name="security_type" and @value="WEP" and\ 210 @type="radio"]' 211 text_field = '//input[@name="passphraseStr"]' 212 button = '//button[@name="keygen"]' 213 if self.current_band == ap_spec.BAND_5GHZ: 214 xpath = '//input[@name="security_type_an" and @value="WEP" and\ 215 @type="radio"]' 216 text_field = '//input[@name="passphraseStr_an"]' 217 button = '//button[@name="Generate_an"]' 218 try: 219 self.wait_for_object_by_xpath(xpath) 220 self.click_button_by_xpath(xpath, alert_handler=self._alert_handler) 221 except Exception, e: 222 raise RuntimeError('We got an exception: "%s". Check the mode. ' 223 'It should be \'Up to 54 Mbps\'.' % str(e)) 224 self.wait_for_object_by_xpath(text_field) 225 self.set_content_of_text_field_by_xpath(key_value, text_field, 226 abort_check=True) 227 self.click_button_by_xpath(button, alert_handler=self._alert_handler) 228 229 230 def set_security_wpapsk(self, security, shared_key, update_interval=None): 231 self.add_item_to_command_list(self._set_security_wpapsk, 232 (security, shared_key,), 1, 1000) 233 234 235 def _set_security_wpapsk(self, security, shared_key, update_interval=None): 236 # Update Interval is not supported. 237 if security == ap_spec.SECURITY_TYPE_WPAPSK: 238 wpa_item = "WPA-PSK" 239 # WPA-PSK is supported only in mode g and a (Up to 54 Mbps). 240 # Setting correct mode before setting WPA-PSK. 241 if self.current_band == ap_spec.BAND_2GHZ: 242 self._set_mode(ap_spec.MODE_G, self.current_band) 243 else: 244 self._set_mode(ap_spec.MODE_A, self.current_band) 245 else: 246 wpa_item = "WPA2-PSK" 247 xpath = ('//input[@name="security_type" and @value="%s"]' % wpa_item) 248 text = '//input[@name="passphrase"]' 249 if self.current_band == ap_spec.BAND_5GHZ: 250 xpath = ('//input[@name="security_type_an" and @value="%s"]' % 251 wpa_item) 252 text = '//input[@name="passphrase_an"]' 253 try: 254 self.click_button_by_xpath(xpath, 255 alert_handler=self._alert_handler) 256 except Exception, e: 257 raise RuntimeError('For WPA-PSK the mode should be 54Mbps. %s' % e) 258 self.set_content_of_text_field_by_xpath(shared_key, text, 259 abort_check=True) 260 261 262 def set_visibility(self, visible=True): 263 # This router is very fussy with WPS even if it is not enabled. It 264 # throws an alert if visibility is off before you adjust security. 265 # Bump visibilities priority to avoid that warning. 266 self.add_item_to_command_list(self._set_visibility, (visible,), 1, 500) 267 268 269 def _set_visibility(self, visible=True): 270 xpath = '//input[@name="ssid_bc" and @type="checkbox"]' 271 if self.current_band == ap_spec.BAND_5GHZ: 272 xpath = '//input[@name="ssid_bc_an" and @type="checkbox"]' 273 check_box = self.wait_for_object_by_xpath(xpath) 274 # These check boxes behave different from other APs. 275 value = check_box.is_selected() 276 if (visible and not value) or (not visible and value): 277 self.click_button_by_xpath(xpath, alert_handler=self._alert_handler) 278