wifi-sitter/WifiSitterGui/Resources/Troubleshooting.rtf

22 lines
4.3 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Calibri;}{\f1\fnil\fcharset0 Courier New;}}
{\colortbl ;\red0\green0\blue0;\red131\green105\blue103;}
{\*\generator Msftedit 5.41.21.2510;}\viewkind4\uc1\pard\sb100\sa100\sl240\slmult1\lang9\b\f0\fs28 Adapter Whitelisting\par
\pard\sb100\sa100\sl240\slmult1\b0\fs24\line\i Taken from the README.md (Program Files\\WifiSitter\\README.md)\i0\line\b Configuration\b0\line There isn't much to configure in WifiSitter but there is one tunable to configure, there may be some network adapters you want ignored complete, Microsoft WiFi Direct for example. Network adapters are named "Ethernet" or "WiFi", names are too generic so the whitelist is made up of the network adapter descriptions. They are string values located at: \line\pard\sb100\sa100\sl240\slmult1\f1\fs20 HKLM\\SYSTEM\\CurrentControlSet\\services\\WifiSitter\\NicWhiteList\par
\pard\li720\sb100\sa100\sl240\slmult1\f0\fs24 Value names are ignored entirely, they are only used to reference the values and can be anything, incrementing numbers are used by default. Regular expressions were overkill for my needs so matching is done by a case-insensitive .StartsWith(). Note, these values are removed when uninstalling.\par
\pard\sb100\sa100\sl240\slmult1 One of the first things to check if wifi won\rquote t connect is whether or not there are any virtual Ethernet cards that aren\rquote t listed in the whitelist. The registry values only need to match the beginning of the adapter names so: \ldblquote VMware Network Adapter\rdblquote , will match: \ldblquote VMware Network Adapter VMnet1\rdblquote and \ldblquote VMware Network Adapter VMnet8\rdblquote . By default, WifiSitter ships with two exclusions:\par
\trowd\trgaph10\trrh1\trpaddl10\trpaddr10\trpaddfl3\trpaddfr3
\clcfpat1\cellx2730\pard\intbl\sb100\sa100\sl240\slmult1 Microsoft Wi-Fi Direct\fs22\cell\row\trowd\trgaph10\trrh1\trpaddl10\trpaddr10\trpaddfl3\trpaddfr3
\clcfpat1\cellx2730\pard\intbl\sb100\sa100\sl240\slmult1\fs24 VirtualBox Host\fs22\cell\row\pard\sb100\sa100\sl240\slmult1\fs24 VMWare adapters not being ignored by default is an oversight on my part, I didn\rquote t run into these during testing. The exclusions that shipped by default were hard coded into the application, I\rquote ve made some changes and in the future, the installer will bundle a reg file with any additional exclusions that become necessary. Here\rquote s what\rquote s in there right now:\par
\pard\sl240\slmult1\f1\fs20 Windows Registry Editor Version 5.00\line\line [HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\WifiSitter\\NicWhiteList]\line "0"="Microsoft Wi-Fi Direct"\line "1"="VirtualBox Host"\line\pard\sl240\slmult1 "2"="VMware Network Adapter"\par
\pard\sb100\sa100\sl240\slmult1\f0\fs24 If you come across a machine that doesn\rquote t have those values in the whitelist, they can be copied into a .reg file and imported into the computer\rquote s registry.\par
\b\fs28 Troubleshooting Steps\par
\pard{\pntext\f0 1.\tab}{\*\pn\pnlvlbody\pnf0\pnindent360\pnstart1\pndec{\pntxta.}}
\fi-360\li720\sb100\sa100\sl240\slmult1\b0\fs24 Open: Control Panel\\Network and Internet\\Network Connections so you can observe changes to the network adapters as they happen.\par
{\pntext\f0 2.\tab}Check that the WifiSitter service is running, the quickest way is through the \ldblquote Services\rdblquote tab from within Task Manager.\par
{\pntext\f0 3.\tab}Attempt to connect to a wifi access point; if this fails, disable the WifiSitter service and try again.\par
{\pntext\f0 4.\tab}If it now succeeds, that would indicate that WifiSitter is detecting a connected wired Ethernet adapter and is disabling the offending wifi adapter as soon as the connection is made. Network connection status is more visible through the netsh command (the Network Connections window may fail to correctly indicate connection status).\par
{\pntext\f0 5.\tab}Disabled the wifi adapter and run netsh interface show interface and note any \ldblquote connected\rdblquote network adapters.\par
{\pntext\f0 6.\tab}If there is a connected Ethernet adapter, copy its name from the \ldblquote Interface Name\rdblquote column and add it to the WifiSitter whitelist.\par
{\pntext\f0 7.\tab}Once that\rquote s complete, start the service, re-enable the WiFi nic and resume troubleshooting at step 3.\par
}