mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-11-03 16:41:44 +01:00 
			
		
		
		
	All `-cmake` suffixes are removed Where a GNU Make option is renamed, the `-legacy` suffix is used
		
			
				
	
	
		
			68 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			68 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
Add IDF_PATH to User Profile (Legacy GNU Make)
 | 
						|
==============================================
 | 
						|
:link_to_translation:`zh_CN:[中文]`
 | 
						|
 | 
						|
.. include:: ../gnu-make-legacy.rst
 | 
						|
 | 
						|
To preserve setting of ``IDF_PATH`` environment variable between system restarts, add it to the user profile, following instructions below.
 | 
						|
 | 
						|
 | 
						|
.. _add-idf_path-to-profile-windows-legacy:
 | 
						|
 | 
						|
Windows
 | 
						|
-------
 | 
						|
 | 
						|
The user profile scripts are contained in ``C:/msys32/etc/profile.d/`` directory. They are executed every time you open an MSYS2 window.
 | 
						|
 | 
						|
#. Create a new script file in ``C:/msys32/etc/profile.d/`` directory. Name it ``export_idf_path.sh``.
 | 
						|
 | 
						|
#. Identify the path to ESP-IDF directory. It is specific to your system configuration and may look something like ``C:\msys32\home\user-name\esp\esp-idf``
 | 
						|
 | 
						|
#. Add the ``export`` command to the script file, e.g.::
 | 
						|
 | 
						|
       export IDF_PATH="C:/msys32/home/user-name/esp/esp-idf"
 | 
						|
 | 
						|
   Remember to replace back-slashes with forward-slashes in the original Windows path.
 | 
						|
 | 
						|
#. Save the script file.
 | 
						|
 | 
						|
#. Close MSYS2 window and open it again. Check if ``IDF_PATH`` is set, by typing::
 | 
						|
 | 
						|
       printenv IDF_PATH
 | 
						|
 | 
						|
   The path previusly entered in the script file should be printed out.
 | 
						|
 | 
						|
If you do not like to have ``IDF_PATH`` set up permanently in user profile, you should enter it manually on opening of an MSYS2 window::
 | 
						|
 | 
						|
    export IDF_PATH="C:/msys32/home/user-name/esp/esp-idf"
 | 
						|
 | 
						|
If you got here from section :ref:`get-started-setup-path-legacy`, while installing s/w for ESP32 development, then go back to section :ref:`get-started-start-project-legacy`. 
 | 
						|
 | 
						|
 | 
						|
.. _add-idf_path-to-profile-linux-macos-legacy:
 | 
						|
 | 
						|
Linux and MacOS
 | 
						|
---------------
 | 
						|
 | 
						|
Set up ``IDF_PATH`` by adding the following line to ``~/.profile`` file::
 | 
						|
 | 
						|
    export IDF_PATH=~/esp/esp-idf
 | 
						|
 | 
						|
Log off and log in back to make this change effective. 
 | 
						|
 | 
						|
.. note::
 | 
						|
 | 
						|
    If you have ``/bin/bash`` set as login shell, and both ``.bash_profile`` and ``.profile`` exist, then update ``.bash_profile`` instead.
 | 
						|
 | 
						|
Run the following command to check if ``IDF_PATH`` is set::
 | 
						|
 | 
						|
    printenv IDF_PATH
 | 
						|
 | 
						|
The path previously entered in ``~/.profile`` file (or set manually) should be printed out.
 | 
						|
 | 
						|
If you do not like to have ``IDF_PATH`` set up permanently, you should enter it manually in terminal window on each restart or logout::
 | 
						|
 | 
						|
    export IDF_PATH=~/esp/esp-idf
 | 
						|
 | 
						|
If you got here from section :ref:`get-started-setup-path-legacy`, while installing s/w for ESP32 development, then go back to section :ref:`get-started-start-project-legacy`.
 |