diff --git a/guides/faq.rst b/guides/faq.rst index 5b3e04aa8..cddaad5c1 100644 --- a/guides/faq.rst +++ b/guides/faq.rst @@ -351,6 +351,16 @@ The top level ``name:`` field in your .yaml file defines the node name(/hostname Important: follow these `instructions `_ to use the ``use_address`` parameter when renaming a live device, as the connection to an existing device will only work with the old name until the name change is complete. + +Why am I getting a warning about strapping pins? +-------------------------------------------------- + +The ESP chips have special "strapping pins" that are read during the bootup procedure and determine how it boots up. They define whether the ESP boots into a special "flashing mode" or normal boot and a couple of other internal settings. +If an external pullup/down changes the configured voltage levels boot failures or hard to diagnose issues can happen. +While the use of them in software is not a problem, if there's something attached to the pins (particularly if they're not floating during the bootup) you may run into problems. +It's recommended to avoid them unless you have a pressing need to use them and you have reviewed the expected boot voltage levels of these pins from the ESP datasheet. + +Note that some boards connect pins such as GPIO0 to a builtin tactile switch. In these cases using the strapping pins is not a problem. See Also --------