From 25d6762b728cc0015ef4127748274e5b3eb85dd3 Mon Sep 17 00:00:00 2001 From: Lotte Steenbrink Date: Tue, 9 Jun 2020 14:18:28 +0200 Subject: [PATCH 1/4] README.md: resolve mac OS todos for Dongle, VSCode --- README.md | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index cbd2bde..f8f06a2 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,27 @@ $ ls /dev/ttyACM* /dev/ttyACM0 ``` -**macOS**: TODO instead of `lsusb` try `system_profiler SPUSBDataType` and/or `ioreg -p IOUSB`. The device should also show up in `/dev/` +**macOS**: a usb device when executing `ioreg -p IOUSB -b -n "Open DFU Bootloader"`. The device will have a vendor ID (`"idVendor"`) of `6421` and a product ID (`"idProduct"`) of `21023`: + +``` console +$ ioreg -p IOUSB -b -n "Open DFU Bootloader" +(...) +| +-o Open DFU Bootloader@14300000 `, e.g. `tty.usbmodemCA1781C8A1EE1`. + ### nRF52840 Development Kit (DK) @@ -89,7 +109,7 @@ $ # Arch Linux $ sudo pacman -S code ``` -**macOS**: TODO(confirm) Go to https://code.visualstudio.com and download the .app +**macOS**: Go to https://code.visualstudio.com and click on "Download for Mac" ### Rust Analyzer From 5d92c847646e1d6126882856293f222d667251e2 Mon Sep 17 00:00:00 2001 From: Lotte Steenbrink Date: Tue, 9 Jun 2020 14:49:07 +0200 Subject: [PATCH 2/4] README.md: resolve mac os TODOS for Development Kit, improve formatting --- README.md | 38 +++++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f8f06a2..73f4d09 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,8 @@ $ ioreg -p IOUSB -b -n "Open DFU Bootloader" | (...) | "idProduct" = 21023 | (...) + | "USB Product Name" = "Open DFU Bootloader" + | (...) | "USB Vendor Name" = "Nordic Semiconductor" | "idVendor" = 6421 | (...) @@ -55,8 +57,12 @@ $ ioreg -p IOUSB -b -n "Open DFU Bootloader" | ``` -The device will show up in the `/dev` directory as `tty.usbmodem`, e.g. `tty.usbmodemCA1781C8A1EE1`. +The device will show up in the `/dev` directory as `tty.usbmodem`: +``` console +$ ls /dev/tty.usbmodem* +/dev/tty.usbmodemCA1781C8A1EE1 +``` ### nRF52840 Development Kit (DK) @@ -79,7 +85,33 @@ $ ls /dev/ttyACM* /dev/ttyACM0 ``` -**macOS**: TODO instead of `lsusb` try `system_profiler SPUSBDataType` and/or `ioreg -p IOUSB`. The device should also show up in `/dev/` +**macOS**: a removable USB flash drive (named JLINK) in Finder and also a USB device named "J-Link" when executing `ioreg -p IOUSB -b -n "J-Link"`. + +``` console +$ ioreg -p IOUSB -b -n "J-Link" +(...) + | +-o J-Link@14300000 `: + +``` console +$ ls /dev/tty.usbmodem* +/dev/tty.usbmodem0006834208031 +``` The board has several switches to configure its behavior. The out of the box configuration is the one we want. If the above instructions didn't work for you, check the position of the on-board switches: @@ -135,7 +167,7 @@ $ rustup +stable component add llvm-tools-preview $ cargo install cargo-binutils ``` -### Python +### Python **Windows**: Go to https://www.python.org/downloads/ and run the Python *3* installer From 4a007a883582b92183291f4a2c5fb152b1fa88f8 Mon Sep 17 00:00:00 2001 From: Lotte Steenbrink Date: Tue, 9 Jun 2020 16:58:10 +0200 Subject: [PATCH 3/4] README.md: add python instructions for mac os --- README.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 73f4d09..8a5df83 100644 --- a/README.md +++ b/README.md @@ -181,11 +181,19 @@ $ # Arch Linux $ sudo pacman -S python-pip ``` -**macOS**: TODO(confirm) should come with Python 2 pre-installed. Is `pip` installed? Does `nrfutil` work with Python 2? +**macOS**: +Ensure that you have python 3 and pip installed. Refer to the following link for [Instructions on how to install python 3 and pip](https://docs.python-guide.org/starting/install3/osx/) + +```console +$ python --version +Python 3.7.7 +$ pip --version +pip 20.0.2 from /usr/local/lib/python3.7/site-packages/pip (python 3.7) +``` ### nrfutil -**All**: Open a terminal and run these commands: +**All**: Open a terminal and install nrfutil as follows. *If you are familiar with python, it is advised to do this in a [virtual environment](https://docs.python.org/3/library/venv.html).* ``` console $ pip install nrfutil From 6a0060e13c79d4f5ab4a79828e6a3fbeb26cc547 Mon Sep 17 00:00:00 2001 From: Lotte Steenbrink Date: Tue, 9 Jun 2020 17:21:21 +0200 Subject: [PATCH 4/4] README.md: update text regarding probe-rs-cli info error --- README.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8a5df83..f1d42b1 100644 --- a/README.md +++ b/README.md @@ -315,4 +315,29 @@ Connect the nRF52840 DK to your PC / laptop; use USB connector J2 on the DK. The $ probe-rs-cli info ``` -If you get an error, run the above program above a second time. Let us know what the output of the command(s) is. +In case you get an error, run the above program above a second time. You should now be seeing output similar to: + +``` +$ probe-rs-cli info +Available Access Ports: +IDR { + REVISION: 0x2, + DESIGNER: 0x23b, + CLASS: MEMAP, + _RES0: 0x0, + VARIANT: 0x1, + TYPE: AMBA_AHB3, +} +Class1RomTable( + CSComponentId { + base_address: 0xe00ff000, + class: RomTable, + peripheral_id: PeripheralID { + REVAND: 0x000000, + CMOD: No, + REVISION: 0x000003, + JEP106: Some( + JEP106Code({ cc: 0x02, id: 0x44 } => Some("Nordic VLSI ASA")), + ), +(...) +``` \ No newline at end of file