mirror of
https://github.com/esp-rs/espup.git
synced 2025-09-28 05:10:44 +00:00
118 lines
4.1 KiB
Markdown
118 lines
4.1 KiB
Markdown
# EspUp
|
|
[](https://github.com/SergioGasquez/espup/actions/workflows/build.yaml)
|
|
|
|
Tool for installing and maintaining ESP Rust toolchain.
|
|
> **Warning**
|
|
>
|
|
> This crate is still in early development (See [Known Issues section](#known-issues)). Use at your own risk and report any issues that you find!
|
|
|
|
## Requirements
|
|
### Windows
|
|
- Python must be installed and the version should be between `3.6` and `3.10`.
|
|
|
|
## Installation
|
|
```sh
|
|
cargo install espup --git https://github.com/SergioGasquez/espup
|
|
```
|
|
## Usage
|
|
> **Warning**
|
|
>
|
|
> Only install subcommand is available at the momment.
|
|
```sh
|
|
USAGE:
|
|
espup <SUBCOMMAND>
|
|
|
|
OPTIONS:
|
|
-h, --help Print help information
|
|
|
|
SUBCOMMANDS:
|
|
help Print this message or the help of the given subcommand(s)
|
|
install Installs esp-rs environment
|
|
reinstall Reinstalls esp-rs environment
|
|
uninstall Uninstalls esp-rs environment
|
|
update Updates esp-rs Rust toolchain
|
|
```
|
|
### Install Subcommand
|
|
```sg
|
|
Installs esp-rs environment
|
|
|
|
USAGE:
|
|
espup install [OPTIONS]
|
|
|
|
OPTIONS:
|
|
-c, --extra-crates <EXTRA_CRATES>
|
|
Comma or space list of extra crates to install
|
|
|
|
[default: cargo-espflash]
|
|
|
|
-d, --toolchain-destination <TOOLCHAIN_DESTINATION>
|
|
Xtensa Rust toolchain instalation folder
|
|
|
|
-e, --espidf-version <ESPIDF_VERSION>
|
|
ESP-IDF version to install. If empty, no esp-idf is installed. Version format:
|
|
|
|
- `commit:<hash>`: Uses the commit `<hash>` of the `esp-idf` repository.
|
|
|
|
- `tag:<tag>`: Uses the tag `<tag>` of the `esp-idf` repository.
|
|
|
|
- `branch:<branch>`: Uses the branch `<branch>` of the `esp-idf` repository.
|
|
|
|
- `v<major>.<minor>` or `<major>.<minor>`: Uses the tag `v<major>.<minor>` of the
|
|
`esp-idf` repository.
|
|
|
|
- `<branch>`: Uses the branch `<branch>` of the `esp-idf` repository.
|
|
|
|
-f, --export-file <EXPORT_FILE>
|
|
Destination of the generated export file
|
|
|
|
[default: export-esp.sh]
|
|
|
|
-h, --help
|
|
Print help information
|
|
|
|
-m, --profile-minimal
|
|
Minifies the installation
|
|
|
|
-n, --nightly-version <NIGHTLY_VERSION>
|
|
Nightly Rust toolchain version
|
|
|
|
[default: nightly]
|
|
|
|
-q, --quiet
|
|
Less output per occurrence
|
|
|
|
-t, --targets <TARGETS>
|
|
Comma or space separated list of targets [esp32,esp32s2,esp32s3,esp32c3,all]
|
|
|
|
[default: all]
|
|
|
|
-v, --verbose
|
|
More output per occurrence
|
|
|
|
-x, --toolchain-version <TOOLCHAIN_VERSION>
|
|
Xtensa Rust toolchain version
|
|
|
|
[default: 1.62.1.0]
|
|
```
|
|
## Known Issues
|
|
- Esp-idf is only installed properly for `all` targets
|
|
|
|
## Troubleshooting
|
|
- In Windows, when installing esp-idf fails with
|
|
```
|
|
ERROR: Could not find a version that satisfies the requirement windows-curses; sys_platform == "win32" (from esp-windows-curses) (from versions: none)
|
|
ERROR: No matching distribution found for windows-curses; sys_platform == "win32"
|
|
Traceback (most recent call last):
|
|
File "<home_dir>/.espressif\esp-idf-ae062fbba3ded0aa\release-v4.4\tools\idf_tools.py", line 1973, in <module>
|
|
main(sys.argv[1:])
|
|
File "<home_dir>/.espressif\esp-idf-ae062fbba3ded0aa\release-v4.4\tools\idf_tools.py", line 1969, in main
|
|
action_func(args)
|
|
File "<home_dir>/.espressif\esp-idf-ae062fbba3ded0aa\release-v4.4\tools\idf_tools.py", line 1619, in action_install_python_env
|
|
subprocess.check_call(run_args, stdout=sys.stdout, stderr=sys.stderr, env=env_copy)
|
|
File "C:\Python311\Lib\subprocess.py", line 413, in check_call
|
|
raise CalledProcessError(retcode, cmd)
|
|
subprocess.CalledProcessError: Command '['<home_dir>/.espressif\\python_env\\idf4.4_py3.11_env\\Scripts\\python.exe', '-m', 'pip', 'install', '--no-warn-script-location', '-r', <home_dir>/.espressif\\esp-idf-ae062fbba3ded0aa\\release-v4.4\\requirements.txt', '--extra-index-url', 'https://dl.espressif.com/pypi']' returned non-zero exit status 1.
|
|
Error: Could not install esp-idf
|
|
```
|
|
*_Solution_*: This is due to python `3.11` being used. Use a python version between `3.6` and `3.10`
|