Skip to content

Commit

Permalink
Document new Rust 1.83 requirement and add a new troubleshooting hint (
Browse files Browse the repository at this point in the history
  • Loading branch information
acmorrow authored Dec 17, 2024
1 parent 841ece0 commit 21f7a8e
Showing 1 changed file with 8 additions and 1 deletion.
9 changes: 8 additions & 1 deletion docs/installation/viam-micro-server-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ The instructions below are for configuring a development environment in order to
1. Use `espup` to download and install the ESP Rust toolchain:

```sh { class="command-line" data-prompt="$"}
espup install -s -f /dev/null -v 1.76.0
espup install -s -f /dev/null -v 1.83.0
```

{{< alert title="Note" color="tip" >}}
Expand Down Expand Up @@ -275,6 +275,13 @@ For further details on `viam-micro-server` development, including credentials ma
This is caused by an [upstream bug](https://github.com/esp-rs/esp-idf-template/issues/174).
To work around this issue, ensure that `CRATE_CC_NO_DEFAULTS=1` is set in the environment when building.
### Error: `error: externally-managed-environment` when building ESP-IDF on macOS
This is encountered when attempting to build ESP-IDF projects while using Python obtained from Homebrew.
Homebrew's Python infrastructure is not intended for end-user consumption but is instead made available to support Homebrew packages which require a python interpreter.
The preferred workaround for this issue is to obtain a user-facing python installation not from Homebrew, but there are other, less safe, workarounds.
Please see the macOS specific notes in the [development technical notes on GitHub](https://github.com/viamrobotics/micro-rdk/blob/main/DEVELOPMENT.md#fixing-esp-builds-on-macos) for more details.
### Error: Failed to open serial port
If you run into the error `Failed to open serial port` when flashing your ESP32 with Linux, make sure the user is added to the group `dialout` with `sudo gpasswd -a $USER dialout`.
Expand Down

0 comments on commit 21f7a8e

Please sign in to comment.