Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nerves-project/asdf-plugin-nerves-toolchain
asdf plugin for using Nerves cross-compiler toolchains outside of Elixir/Nerves
https://github.com/nerves-project/asdf-plugin-nerves-toolchain
asdf-plugin elixir-lang nerves-project
Last synced: about 2 months ago
JSON representation
asdf plugin for using Nerves cross-compiler toolchains outside of Elixir/Nerves
- Host: GitHub
- URL: https://github.com/nerves-project/asdf-plugin-nerves-toolchain
- Owner: nerves-project
- License: mit
- Created: 2024-04-19T18:44:18.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-06-28T20:34:12.000Z (6 months ago)
- Last Synced: 2024-06-28T21:46:32.974Z (6 months ago)
- Topics: asdf-plugin, elixir-lang, nerves-project
- Language: Shell
- Homepage:
- Size: 24.4 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# asdf-nerves-toolchain [](https://github.com/nerves-project/asdf-plugin-nerves-toolchain/actions/workflows/build.yml) [](https://github.com/nerves-project/asdf-plugin-nerves-toolchain/actions/workflows/lint.yml)
[nerves-toolchain](https://github.com/nerves-project/asdf-plugin-nerves-toolchain) plugin for the [asdf version manager](https://asdf-vm.com).
This lets you use the official [Nerves](https://nerves-project.org/) cross
toolchains outside of Elixir. These provide recent versions of GCC with either
[musl libc](https://musl.libc.org/) or [GNU
libc](https://www.gnu.org/software/libc/) for Intel, 32-bit and 64-bit ARM,
RISC-V and MIPS.
```sh
$ asdf install nerves-toolchain v13.2.0-riscv64-nerves-linux-gnu
$ asdf local nerves-toolchain v13.2.0-riscv64-nerves-linux-gnu
$ riscv64-nerves-linux-gnu-gcc --version
riscv64-nerves-linux-gnu-gcc (crosstool-NG UNKNOWN) 13.2.0
Copyright (C) 2023 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
```
## Contents
- [Dependencies](#dependencies)
- [Install](#install)
- [Contributing](#contributing)
- [License](#license)
## Dependencies
- `bash`, `curl`, `tar`, and [POSIX utilities](https://pubs.opengroup.org/onlinepubs/9699919799/idx/utilities.html).
- `xz` / `xz-utils`
- [`jq`](https://jqlang.github.io/jq/)
Nerves toolchain releases are large and hosted on GitHub. It is recommended to
create a GitHub API token and export it as `GITHUB_API_TOKEN` to avoid
throttling.
## Install
Plugin:
```shell
asdf plugin add nerves-toolchain https://github.com/nerves-project/asdf-plugin-nerves-toolchain.git
# Once https://github.com/asdf-vm/asdf-plugins/pull/994 is merged, run this instead:
asdf plugin add nerves-toolchain
```
nerves-toolchain:
```shell
# Show all installable versions. Only toolchains compatible with the current OS/arch
# will be displayed.
asdf list-all nerves-toolchain
# Install specific version
asdf install nerves-toolchain v13.2.0-aarch64-nerves-linux-gnu
# Set a version globally (on your ~/.tool-versions file)
asdf global nerves-toolchain v13.2.0-aarch64-nerves-linux-gnu
```
Check [asdf](https://github.com/asdf-vm/asdf) readme for more instructions on
how to install & manage versions.
## Contributing
Contributions of any kind welcome! See the [contributing
guide](contributing.md).
[Thanks goes to these contributors](https://github.com/nerves-project/asdf-plugin-nerves-toolchain/graphs/contributors)!
## License
See [LICENSE](LICENSE).