From 22a309217247eb4db54c6c2d6594916eb3481e5c Mon Sep 17 00:00:00 2001 From: per1234 Date: Wed, 2 Dec 2020 21:45:57 -0800 Subject: [PATCH 1/2] [skip changelog] Improve wording of FAQ re: boards w/o dedicated VID/PID Some minor wording improvements for readability/correct terminology. --- docs/FAQ.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index d022190d3d1..c94716ea9e6 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -1,11 +1,11 @@ ## Arduino Uno/Mega/Duemilanove is not detected -When you run `arduino-cli board list`, your board doesn't show up. Possible causes: +When you run [`arduino-cli board list`][arduino cli board list], your board doesn't show up. Possible causes: -- Your board is a cheaper clone, or -- It mounts a USB2Serial converter like FT232 or CH340: these chips always report the same USB VID/PID to the operating - system, so the only thing we know is that the board mounts that specific USB2Serial chip, but we don’t know which - board that chip is on. +- Your board is a cheaper derivative, or +- It uses a USB to serial converter like FTDI FT232 or CH340. These chips always report the same USB VID/PID to the + operating system, so the only thing we know is that the board mounts that specific USB2Serial chip, but we don’t know + which board that chip is on. ## What's the FQBN string? @@ -33,6 +33,7 @@ the [Monitor service documentation][monitor service]. If your question wasn't answered, feel free to ask on [Arduino CLI's forum board][1]. +[arduino cli board list]: commands/arduino-cli_board_list.md [0]: platform-specification.md [1]: https://forum.arduino.cc/index.php?board=145.0 [screen]: https://www.gnu.org/software/screen/manual/screen.html From 2cecd2e4e80cb88493b5c3219803b43c27c22644 Mon Sep 17 00:00:00 2001 From: per1234 Date: Wed, 2 Dec 2020 21:47:39 -0800 Subject: [PATCH 2/2] [skip changelog] Mention Nano in FAQ re: boards w/o dedicated VID/PID The classic Nano is the sole active official board without a custom VID/PID, so it's especially important to mention it in this FAQ. --- docs/FAQ.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index c94716ea9e6..9d110b5d4ca 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -1,11 +1,11 @@ -## Arduino Uno/Mega/Duemilanove is not detected +## Arduino Nano/Uno/Mega is not detected When you run [`arduino-cli board list`][arduino cli board list], your board doesn't show up. Possible causes: - Your board is a cheaper derivative, or -- It uses a USB to serial converter like FTDI FT232 or CH340. These chips always report the same USB VID/PID to the - operating system, so the only thing we know is that the board mounts that specific USB2Serial chip, but we don’t know - which board that chip is on. +- It's a board, such the classic Nano, that uses a USB to serial converter like FTDI FT232 or CH340. These chips always + report the same USB VID/PID to the operating system, so the only thing we know is that the board mounts that specific + USB2Serial chip, but we don’t know which board that chip is on. ## What's the FQBN string?