Merge pull request #113 from ferrous-systems/merge-tooling-check

move tool installation out of tooling check, clarify cd tools
This commit is contained in:
Lotte Steenbrink 2020-12-21 17:47:02 +01:00 committed by GitHub
commit 8b0ad4d3fb
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 57 additions and 15 deletions

View file

@ -150,9 +150,41 @@ Installed package `cargo-bloat v0.9.3` (..)
$ cargo install probe-run
(..)
Installed package `probe-run v0.1.3` (..)
Installed package `probe-run v0.1.8` (..)
```
### Workshop tools
The workshop git repository contains custom crates that help you with flashing and debugging the workshops. Depending on the workshop you're attending, you need to install all or some of them.
#### Beginner workshop
Change to the `tools` folder and run these commands *from different terminals so they'll run in parallel*:
```console
$ cd embedded-trainings-2020/tools
$ cargo install --path usb-list
$ # in a new terminal, for parallelization
$ cargo install --path dongle-flash
$ # in a new terminal, for parallelization
$ cargo install --path serial-term
$ # in a new terminal, for parallelization
$ cargo install --path change-channel
```
Leave the processes running in the background.
#### Advanced workshop
Change to the `tools` folder and run these commands:
```console
$ cd embedded-trainings-2020/tools
$ cargo install --path usb-list
```
Leave the process running in the background.
## Python
**Windows**: Go to [https://www.python.org/downloads/](https://www.python.org/downloads/) and run the Python *3* installer

View file

@ -2,7 +2,7 @@
## Setup check
First, let's check that you have installed all the tools listed in the previous section.
Let's check that you have installed all the tools listed in the previous section.
❗ The first two commands *must* return version `0.8.x`
@ -20,25 +20,35 @@ $ nrfutil version
nrfutil version 6.1.0
```
## More tools
✅ Now let's install some tools shipped with the workshop material.
✅ Now let's make sure you've installed the tools shipped with the workshop material.
### Beginner workshop
From the `tools` folder run these commands *from different terminals so they'll run in parallel*:
Run the commands listed here and see if they produce similar output, i.e. *don't* yield `command not found: ...`
- `cargo install --path usb-list`
- `cargo install --path dongle-flash`
- `cargo install --path serial-term`
- `cargo install --path change-channel`
```console
$ usb-list
Bus 020 Device 007: ID 1b1c:0a42
Bus 020 Device 006: ID 1fc9:0132
(..)
Leave the processes running in the background.
$ dongle-flash
Error: expected exactly one argument
$ serial-term
(waiting for the Dongle to be connected)
$ change-channel
Error: expected exactly one argument
```
### Advanced workshop
From the `tools` folder run these commands *from different terminals so they'll run in parallel*:
Run the commands listed here and see if they produce similar output, i.e. *don't* yield `command not found: ...`
- `cargo install --path usb-list`
Leave the processes running in the background.
```console
$ usb-list
Bus 020 Device 007: ID 1b1c:0a42
Bus 020 Device 006: ID 1fc9:0132
(..)
```