chore: update against Arduino IDE 2

Signed-off-by: Frederic Pillon <[email protected]>

Author: fpistm

Getting-Started.md

@@ -1,12 +1,17 @@
+> [!WARNING]
+> Since core release 2.8.0, only Arduino IDE 2 is supported.
+> To use Legacy IDE (1.8.X), see the [[Getting Started_V1]]
+
 # Install Arduino.cc IDE
-Download and install [Arduino software (IDE)](https://www.arduino.cc/en/Main/Software) for the required OS.
-([Windows](https://www.arduino.cc/en/Guide/Windows), [Linux](https://www.arduino.cc/en/Guide/linux) or [Mac](https://www.arduino.cc/en/Guide/MacOSX) instructions)
+
+Download and install [Arduino IDE 2](https://www.arduino.cc/en/software) for the required OS.
+([Windows](https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing/#windows), [Linux](https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing/#linux) or [macOS](https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing/#macos) instructions)
 
 ## About Boards manager concept
 Arduino.cc IDE allows to add easily new board thanks the "**Boards Managers**".
 More information about "**Boards Managers**" is available on Arduino.cc official website:
 
-[Installing additional Arduino Cores](https://www.arduino.cc/en/guide/cores)
+[Installing a Board Package in the IDE 2](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-board-manager)
 
 The corresponding STM32 cores packages are provided thanks to:
 
@@ -22,39 +27,39 @@ So carefully follow the following steps.
 
 1- Launch Arduino.cc IDE. Click on "**File**" menu and then "**Preferences**".
 
-[[img/preferences.png|alt=Preferences]]
+[[img/v2/preferences.png|alt=Preferences]]
 
 The "**Preferences**" dialog will open, then add the following link to the "*Additional Boards Managers URLs*" field:
 
 https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json
 
 Click "**Ok**"
 
-2- Click on "**Tools**" menu and then "**Boards > Boards Manager**"
+2- Click on "**Tools**" menu and then "**Boards > Boards Manager**" or use the underlined icon on the left side bar:
 
-[[img/menu_bm.png|alt="BoardsManager Menu"]]
+[[img/v2/menu_bm.png|alt="BoardsManager Menu"]]
 
 The board manager will open and you will see a list of installed and available boards. 
 
 Select "**Contributed**" type.
 
-[[img/boardsmanager.png|alt="BoardsManager dialog"]]
+[[img/v2/boardsmanager.png|alt="BoardsManager dialog"]]
 
 Select the "**STM32 MCU based boards**" and click on install.
 
-[[img/boardsmanager2.png|alt="BoardsManager dialog"]]
+[[img/v2/boardsmanager2.png|alt="BoardsManager dialog"]]
 
-After installation is complete an "*INSTALLED*" tag appears next to the core name. 
+After installation is complete a "*\<version> installed*" tag appears below the core name.
 
 You can close the Board Manager.
 
-[[img/boardslist.png|alt="Boards list"]]
+[[img/v2/boardslist.png|alt="Boards list"]]
 
 Now you can find the STM32 boards package in the "**Board**" menu.
 
 Select the desired boards series: _Nucleo-64 / Nucleo-144 / Discovery / ..._
 
-[[img/SelectBoard.png|alt="Select boards"]]
+[[img/v2/SelectBoard.png|alt="Select boards"]]
 
 Then you can find the Nucleo-64 boards available in a sub-menu of the "Tools" menu.
 
@@ -76,38 +81,37 @@ Else configure the proxy in the Arduino.cc IDE (open the "**Preferences**" dialo
 
 2. Launch the Arduino software
 
-    [[/img/arduino.png|alt="Arduino icon"]]
+    [[/img/v2/arduino.png|alt="Arduino icon"]]
 
 3. Select the [Nucleo L476RG] board in two steps:
 
 a. From the "**Tools > Board**" menu, select the STM32 boards groups: _Nucleo-64_
 
-  [[/img/boardslist.png|alt="Board selection"]]
+  [[/img/v2/boardslist.png|alt="Board selection"]]
 
 b. Then from the "**Tools > Board part number**" menu, select the [Nucleo L476RG]
 
-  [[/img/SelectBoard.png|alt="Board selection"]]
+  [[/img/v2/SelectBoard.png|alt="Board selection"]]
 
 3. Select the serial port from the "**Tools > Port**" menu
 
     * On Mac, it's something like _/dev/tty.usbmodem-1511_.
-    * On Windows, it's often the highest-numbered COM port. In this example, it's _COM5_
+    * On Windows, it's often the highest-numbered COM port. In this example, it's _COM40_
     * On Linux, it's something like _/dev/ttyACM0_.
 
     (Or unplug the board, check the menu, and then plug the board and check what new port appears)
 
-  [[/img/SelectPort.png|alt="Port selection"]]
+  [[/img/v2/SelectPort.png|alt="Port selection"]]
 
 ## Upload methods
 Depending of the board, several upload methods could be proposed, thanks the "**Tools > Upload Method**" menu.
 
 See [[Upload methods]] for more details.
 
-[[/img/UploadMethod.png|alt="Upload Method"]]
+[[/img/v2/UploadMethod.png|alt="Upload Method"]]
 
 # Examples
 * [[Blink-example]]
-* [[Firmata-example]] (to use with [ScratchX](http://scratchx.org/) for example)
 
 
 [Nucleo L476RG]: http://www.st.com/en/evaluation-tools/nucleo-l476rg.html

Getting-Started_V1.md

@@ -0,0 +1,117 @@
+> [!WARNING]
+> This page is dedicated to Legacy Arduino IDE (1.8.X).
+> Legacy Arduino IDE (1.8.X) can be used only with core version prio to 2.8.0.
+> For core version higher or equal to 2.8.0, see the [[Getting Started]]
+
+# Install Arduino.cc IDE
+Download and install [Arduino software (IDE)](https://www.arduino.cc/en/software) for the required OS.
+([Windows](https://docs.arduino.cc/software/ide-v1/tutorials/Windows), [Linux](https://docs.arduino.cc/software/ide-v1/tutorials/Linux) or [Mac](https://docs.arduino.cc/software/ide-v1/tutorials/macOS/) instructions)
+
+## About Boards manager concept
+Arduino.cc IDE allows to add easily new board thanks the "**Boards Managers**".
+More information about "**Boards Managers**" is available on Arduino.cc official website:
+
+[Installing additional Arduino Cores](https://docs.arduino.cc/learn/starting-guide/cores)
+
+The corresponding STM32 cores packages are provided thanks to:
+
+https://github.com/stm32duino/BoardManagerFiles
+
+Follow the below steps to get STM32 boards installed to your Arduino IDE.
+
+# Add STM32 boards support to Arduino
+This is the needed step to get STM32 targets added to Arduino.
+So carefully follow the following steps.
+
+## Installing STM32 Cores
+
+1- Launch Arduino.cc IDE. Click on "**File**" menu and then "**Preferences**".
+
+[[img/v1/preferences.png|alt=Preferences]]
+
+The "**Preferences**" dialog will open, then add the following link to the "*Additional Boards Managers URLs*" field:
+
+https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json
+
+Click "**Ok**"
+
+2- Click on "**Tools**" menu and then "**Boards > Boards Manager**"
+
+[[img/v1/menu_bm.png|alt="BoardsManager Menu"]]
+
+The board manager will open and you will see a list of installed and available boards. 
+
+Select "**Contributed**" type.
+
+[[img/v1/boardsmanager.png|alt="BoardsManager dialog"]]
+
+Select the "**STM32 MCU based boards**" and click on install.
+
+[[img/v1/boardsmanager2.png|alt="BoardsManager dialog"]]
+
+After installation is complete an "*INSTALLED*" tag appears next to the core name. 
+
+You can close the Board Manager.
+
+[[img/v1/boardslist.png|alt="Boards list"]]
+
+Now you can find the STM32 boards package in the "**Board**" menu.
+
+Select the desired boards series: _Nucleo-64 / Nucleo-144 / Discovery / ..._
+
+[[img/v1/SelectBoard.png|alt="Select boards"]]
+
+Then you can find the Nucleo-64 boards available in a sub-menu of the "Tools" menu.
+
+## Extra step
+
+To upload through SWD (STLink), Serial or DFU, [STM32CubeProgrammer](https://www.st.com/en/development-tools/stm32cubeprog.html) needs to be installed. See [[Upload methods|Upload-methods#stm32cubeprogrammer]].
+
+## Troubleshooting
+
+If you have any issue to download/use a package, you could [file an issue on Github](https://github.com/stm32duino/BoardManagerFiles/issues/new).
+
+### Proxy
+If you have any issue to download a package, ensure to not be behind a proxy.
+
+Else configure the proxy in the Arduino.cc IDE (open the "**Preferences**" dialog and select "**Network**" tab).
+
+# Configuring IDE 
+1. Connect a board to the computer USB port. For this example: [Nucleo L476RG]
+
+2. Launch the Arduino software
+
+    [[/img/v1/arduino.png|alt="Arduino icon"]]
+
+3. Select the [Nucleo L476RG] board in two steps:
+
+a. From the "**Tools > Board**" menu, select the STM32 boards groups: _Nucleo-64_
+
+  [[/img/v1/boardslist.png|alt="Board selection"]]
+
+b. Then from the "**Tools > Board part number**" menu, select the [Nucleo L476RG]
+
+  [[/img/v1/SelectBoard.png|alt="Board selection"]]
+
+3. Select the serial port from the "**Tools > Port**" menu
+
+    * On Mac, it's something like _/dev/tty.usbmodem-1511_.
+    * On Windows, it's often the highest-numbered COM port. In this example, it's _COM5_
+    * On Linux, it's something like _/dev/ttyACM0_.
+
+    (Or unplug the board, check the menu, and then plug the board and check what new port appears)
+
+  [[/img/v1/SelectPort.png|alt="Port selection"]]
+
+## Upload methods
+Depending of the board, several upload methods could be proposed, thanks the "**Tools > Upload Method**" menu.
+
+See [[Upload methods]] for more details.
+
+[[/img/v1/UploadMethod.png|alt="Upload Method"]]
+
+# Examples
+* [[Blink-example]]
+
+
+[Nucleo L476RG]: http://www.st.com/en/evaluation-tools/nucleo-l476rg.html

_Examples/Blink-example.md

@@ -1,19 +1,19 @@
 ## Blink example on [Nucleo L476RG](http://www.st.com/en/evaluation-tools/nucleo-l476rg.html)
-1. If not already done, download and install the [Arduino software (IDE)](https://www.arduino.cc/en/Main/Software) for the required OS.
-([Windows](https://www.arduino.cc/en/Guide/Windows), [Linux](https://www.arduino.cc/en/Guide/linux) or [Mac](https://www.arduino.cc/en/Guide/MacOSX) instructions)
+
+1. If not already done, [[Getting-Started#Install-Arduino.cc-IDE]]
 
 2. Configure the IDE to the desired board. 
 
   See [[Getting-Started#configuring-ide]]
 
 3. Open the Blink sketch from the "**File> Examples > 01.Basics > Blink**"
 
-  [[/img/SelectBlinkExample.png|alt="Blink example selection"]]
-
 4. Click the upload button
 
   See [[Getting-Started#upload-method]] to change the upload method.
 
-  [[/img/Upload.png|alt="Upload"]]
+  [[/img/v1/Upload.png|alt="Upload"]]
+
+  [[/img/v2/Upload.png|alt="Upload"]]
 
 That's all. LED should blink on the [Nucleo L476RG](http://www.st.com/en/evaluation-tools/nucleo-l476rg.html).