mirror of
https://github.com/espressif/esp-idf.git
synced 2024-09-20 00:36:01 -04:00
55 lines
3.4 KiB
ReStructuredText
55 lines
3.4 KiB
ReStructuredText
ESP-IDF Windows Installer
|
|
=========================
|
|
|
|
:link_to_translation:`zh_CN:[中文]`
|
|
|
|
Command-Line Parameters
|
|
-----------------------
|
|
|
|
Windows Installer ``esp-idf-tools-setup`` provides the following command-line parameters:
|
|
|
|
* ``/CONFIG=[PATH]`` - Path to ``ini`` configuration file to override default configuration of the installer. Default: ``config.ini``.
|
|
* ``/GITCLEAN=[yes|no]`` - Perform ``git clean`` and remove untracked directories in offline-mode installation. Default: ``yes``.
|
|
* ``/GITRECURSIVE=[yes|no]`` - Clone recursively all Git repository submodules. Default: yes.
|
|
* ``/GITREPO=[URL|PATH]`` - URL of repository to clone ESP-IDF. Default: ``https://github.com/espressif/esp-idf.git``.
|
|
* ``/GITRESET=[yes|no]`` - Enable/Disable ``git reset`` of repository during installation. Default: ``yes``.
|
|
* ``/HELP`` - Display command line options provided by Inno Setup installer.
|
|
* ``/IDFDIR=[PATH]`` - Path to directory where it is installed. Default: ``{userdesktop}\esp-idf}``.
|
|
* ``/IDFVERSION=[v4.3|v4.1|master]`` - Use specific ESP-IDF version. E.g., v4.1, v4.2, master. Default: ``empty``, pick the first version in the list.
|
|
* ``/IDFVERSIONSURL=[URL]`` - Use URL to download list of ESP-IDF versions. Default: ``https://dl.espressif.com/dl/esp-idf/idf_versions.txt``.
|
|
* ``/LOG=[PATH]`` - Store installation log file in specific directory. Default: ``empty``.
|
|
* ``/OFFLINE=[yes|no]`` - Execute installation of Python packages by ``pip`` in offline mode. The same result can be achieved by setting the environment variable ``PIP_NO_INDEX``. Default: ``no``.
|
|
* ``/USEEMBEDDEDPYTHON=[yes|no]`` - Use Embedded Python version for the installation. Set to ``no`` to allow the Python selection screen in the installer. Default: ``yes``.
|
|
* ``/PYTHONNOUSERSITE=[yes|no]`` - Set ``PYTHONNOUSERSITE`` variable before launching any Python command to avoid loading Python packages from AppData\Roaming. Default: ``yes``.
|
|
* ``/PYTHONWHEELSURL=[URL]`` - Specify URLs to PyPi repositories for resolving binary Python Wheel dependencies. The same result can be achieved by setting the environment variable ``PIP_EXTRA_INDEX_URL``. Default: ``https://dl.espressif.com/pypi``.
|
|
* ``/SKIPSYSTEMCHECK=[yes|no]`` - Skip System Check page. Default: ``no``.
|
|
* ``/VERYSILENT /SUPPRESSMSGBOXES /SP- /NOCANCEL`` - Perform silent installation.
|
|
|
|
Unattended Installation
|
|
-----------------------
|
|
|
|
The unattended installation of ESP-IDF can be achieved by following command-line parameters:
|
|
|
|
.. code-block:: batch
|
|
|
|
esp-idf-tools-setup-x.x.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /NOCANCEL
|
|
|
|
When running the installer from the command line, it detaches its process from the command line and starts a separate process in the background to perform the installation without blocking the use of the command line. The following PowerShell script allows you to wait for the installer to complete:
|
|
|
|
.. code-block:: powershell
|
|
|
|
esp-idf-tools-setup-x.x.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /NOCANCEL
|
|
$InstallerProcess = Get-Process esp-idf-tools-setup
|
|
Wait-Process -Id $InstallerProcess.id
|
|
|
|
Custom Python and Custom Location of Python Wheels
|
|
--------------------------------------------------
|
|
|
|
The ESP-IDF installer is using by default embedded Python with reference to the Python Wheel mirror.
|
|
|
|
The following parameters allow to select custom Python and custom location of Python wheels:
|
|
|
|
.. code-block:: batch
|
|
|
|
esp-idf-tools-setup-x.x.exe /USEEMBEDDEDPYTHON=no /PYTHONWHEELSURL=https://pypi.org/simple/
|