-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
fix(nrf52): make node-lzma an optional dep, handle dynamic import (#140)
For development environments that don't have xz utils available for the node-lzma native bindings, that dependency is now optional until attempting to setup the nrf52 tooling on Linux or MacOS. If node-lzma is not available, a helpful error message will be displayed.
- Loading branch information
1 parent
804984f
commit f227830
Showing
5 changed files
with
61 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
--- | ||
title: Troubleshooting | ||
description: Tips for resolving known issues | ||
--- | ||
|
||
## `symbol not found in flat namespace '_lzma_stream_encoder_mt'` | ||
|
||
Other error messages can include: | ||
|
||
- "Unable to extract Arm Embedded Toolchain without XZ utils (https://tukaani.org/xz/). Please install that dependency on your system and reinstall xs-dev before attempting this setup again." | ||
|
||
If you encounter an error message related to lzma or node-lzma, this is likely due to a missing system dependency required to setup the tooling to program nrf52-based devices. This is only required on MacOS and Linux development environments. | ||
|
||
To resolve this, install the [XS Utils](https://tukaani.org/xz/) for your system. | ||
|
||
On MacOS, [Homebrew](https://brew.sh) can be used: | ||
|
||
``` | ||
brew install xz | ||
``` | ||
|
||
For Debian-based systems like Ubuntu: | ||
|
||
``` | ||
sudo apt-get -y install xz-utils | ||
``` | ||
|
||
If using `yum`: | ||
|
||
``` | ||
sudo yum -y install xz | ||
``` | ||
|
||
Once this is dependency has been installed, please re-install xs-dev to ensure the CLI is built correctly with the native bindings to xz-utils. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters