Skip to content

Commit 5a66325

Browse files
authored
Merge pull request #161 from 9names/develop
2 parents 76ef770 + bd32b21 commit 5a66325

1 file changed

Lines changed: 18 additions & 6 deletions

File tree

ASSEMBLY.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,10 @@ The Board Management Controller (BMC) is responsible for controlling power and r
9090
$ cargo install probe-run
9191
```
9292
93-
**NOTE**: Linux Mint requires `open-ocd`, `libudev-dev` and `libusb-1.0-0-dev` before installing `probe-run`.
93+
**NOTE**: On Linux you will need to install probe-run's dependencies (libudev and libusb) before probe-run.
94+
For Debian based distros, run `sudo apt install -y libusb-1.0-0-dev libudev-dev`
95+
For Fedora based distros, run `sudo dnf install -y libusbx-devel systemd-devel`
96+
See https://github.com/knurling-rs/probe-run#installation for the latest dependency information
9497
9598
5. Connect your Arm Serial Wire Debug probe to J1001, the BMC programming header.
9699
* If you have 12V DC power to the board, the 3.3V pin will be live and should be treated as an output - connect it to the VTref pin of your programmer if it has one.
@@ -127,14 +130,23 @@ Time to learn Rust and get hacking on the BIOS and the OS! That's what the Neotr
127130
128131
You can make one out of a Raspberry Pi Pico. See <https://github.com/rp-rs/rp2040-project-template/blob/main/debug_probes.md> for more details.
129132
130-
For Linux Mint (and likely most other modern Linux distributions), the udev-rules also need to be updated for the SWD debug probe. The file `/etc/udev/rules.d/99-cmsis-dap.rules` should be created, containing:
133+
For Linux Mint (and likely most other modern Linux distributions), you will not have sufficient privileges to access the probe without adding a udev rules file.
131134
132-
```text
133-
# cafe:4005 RP2040 Pico with CMSIS-DAP
134-
SUBSYSTEM=="usb", ATTR{idVendor}=="cafe", ATTR{idProduct}=="4005", MODE:="0666"
135+
The following instructions will set up udev to allow access to your probe:
136+
137+
```system
138+
wget https://probe.rs/files/69-probe-rs.rules
139+
sudo mv 69-probe-rs.rules /etc/udev/rules.d/
140+
sudo udevadm control --reload
141+
sudo udevadm trigger
142+
```
143+
144+
You also need to add your user to the plugdev group for these permissions to apply:
145+
146+
```system
147+
sudo usermod -a -G plugdev replace_this_with_your_username
135148
```
136149

137-
**NOTE:** Edit idVendor & idProduct to match VID & PID of the device you are using.
138150

139151
## Connecting up a PC Case
140152

0 commit comments

Comments
 (0)