Science journal updates [HC-1394]

content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md

@@ -3,32 +3,42 @@ title: "Connect a board to the Science Journal app"
 id: 4407749620370
 ---
 
-## Supported boards
+Learn how to connect a board to the Arduino Science Journal app. In this article:
 
-The Science Journal app supports the following boards:
+* [Compatible boards](#compatible-boards)
+* [Set up your board](#set-up-your-board)
+* [Connect the Science Journal app](#connect-the-science-journal-app)
+* [Troubleshooting](#troubleshooting)
 
-- Arduino Nano 33 BLE Sense
-- Arduino MKR WiFi 1010 (with the Science carrier board)
+---
 
-## Set up your board
+<a id="compatible-boards"></a>
+
+## Compatible boards
 
-### Set up the Arduino MKR WiFi 1010
+The Science Journal can be used with the following boards:
 
-> The MKR WiFi 1010 can't be connected without the _Science carrier board_, which is only available in the [Arduino Science Kit Physics Lab](https://store.arduino.cc/products/arduino-science-kit-physics-lab).
+* Arduino MKR WiFi 1010 (with the Science Carrier, or Science Carrier Rev2)
+* Arduino Nano 33 BLE Sense
+* Arduino Nano 33 BLE Sense Rev2
+* Arduino Nano RP2040 Connect (by itself, or with the Science Carrier R3)
 
-The MKR WiFi 1010 included with the Science Kit comes with the required firmware out-of-the-box. [Follow these instructions](https://support.arduino.cc/hc/en-us/articles/4408029337746) if you are using an individually bought replacement or have flashed the board with different firmware.
+> Note: The MKR WiFi 1010 needs to be connected using the Science Carrier, which is only available in the [Arduino Science Kit Physics Lab](https://store.arduino.cc/products/arduino-science-kit-physics-lab).
 
-1. Connect the board to the carrier, making sure that the pins (e.g. A1, A2) line up.
+<a id="set-up-your-board"></a>
+
+## Set up your board
 
-2. Power the setup, via a USB cable to the board or otherwise.
+1. **Upload the Science Journal firmware:**
 
-### Set up the Arduino Nano 33 BLE Sense
+   * If your board came with a Science Kit, **it will have the the required firmware out-of-the-box**.
+   * If you're using a board not included in a Science Kit, an individually bought board replacement, or have flashed the board with different firmware, see [Upload the Science Journal firmware](https://support.arduino.cc/hc/en-us/articles/4408029337746-Upload-the-Science-Journal-firmware).
 
-The Nano 33 BLE Sense needs to be flashed with special firmware for use with the Science Journal app.
+2. **If you're using a Science Carrier:** Connect the board to the Science Carrier, ensuring that the pins (e.g., A1, A2) align properly.
 
-1. [Flash the firmware](https://support.arduino.cc/hc/en-us/articles/4408029337746).
+3. Power the setup, via a USB cable to the board or otherwise.
 
-2. Power the setup, via a USB cable to the board or otherwise.
+<a id="connect-the-science-journal-app"></a>
 
 ## Connect the Science Journal app
 
@@ -40,11 +50,11 @@ The Nano 33 BLE Sense needs to be flashed with special firmware for use with the
 
 4. Tap **Sensors**.
 
-   ![The Sensors button in Science Journal.](img/sj-button-sensors.png)
+   ![The Sensors button in Science Journal.](img/sj-v2-button-sensors.png)
 
 5. Open settings by tapping the cogwheel button in the top right.
 
-   ![The settings button in Science Journal.](img/sj-button-cogwheel.png)
+   ![The settings button in Science Journal.](img/sj-v2-button-cogwheel.png)
 
 6. Scroll down to **Available devices** and find the "Arduino Boards" category. Tap to to expand it (you may have to scroll down for the revealed items to show).
 
@@ -56,10 +66,10 @@ The Nano 33 BLE Sense needs to be flashed with special firmware for use with the
 
 Under **Available Devices**, the arrow next to Arduino Boards should be pointing downwards (if not, tap it). You may have to swipe down to see the list.
 
-![Finding the device in the 'Arduino boards' category.](img/science-journal-missing-board-expand.gif)
+![Finding the device in the 'Arduino boards' category.](img/SJ-v2-missing-board-expand.gif)
 
 ### The board may already be added
 
 If both the Internal sensors and the board sensor categories are expanded, they can be mistaken for a single category. Try swiping up, and tap to collapse the Internal sensors category. Your board may appear below.
 
-![Finding the added device.](img/science-journal-missing-board-middle.gif)
+![Finding the added device.](img/SJ-v2-missing-board-middle.gif)

content/Education and Kits/Science Journal App/Get-started-with-the-Arduino-Science-Journal.md

@@ -3,30 +3,50 @@ title: "Get started with the Arduino Science Journal"
 id: 4412950851346
 ---
 
-Learn how to get started with the Arduino Science Journal.
+Learn how to get started with the Arduino Science Journal. In this article:
+
+* [Get the app](#get-the-app)
+* [Compatible boards](#compatible-boards)
+* [Connect a board](#connect-a-board)
+* [Access lessons and activities](#access-lessons-and-activities)
+* [Troubleshooting](#troubleshooting)
 
 ---
 
+<a id="get-the-app"></a>
+
 ## Get the app
 
-The Arduino Science Journal app can be downloaded from the App Store (iOS) and Google Play (Android).
+You can download the Arduino Science Journal app from the App Store (iOS) and Google Play (Android).
 
-* [Download on the App Store](https://apps.apple.com/us/app/arduino-science-journal/id1518014927)
-* [Get it on Google Play](https://play.google.com/store/apps/details?id=cc.arduino.sciencejournal)
+* <a class="link-external" href="https://apps.apple.com/us/app/arduino-science-journal/id1518014927">Download on the App Store</a>
+* <a class="link-external" href="https://play.google.com/store/apps/details?id=cc.arduino.sciencejournal">Get it on Google Play</a>
 
 Read [Setting up Experiments](https://science-journal.arduino.cc/sj/module/getting-started-1/lesson/setting-up-experiments) for instructions on how to setup the app on an Android or iOS device.
 
+<a id="compatible-boards"></a>
+
 ## Compatible boards
 
-The Science Journal can be used with **Arduino MKR WiFi 1010** or **Arduino Nano 33 BLE Sense**.
+The Science Journal can be used with the following boards:
+
+* Arduino MKR WiFi 1010 (with the Science Carrier, or Science Carrier Rev2)
+* Arduino Nano 33 BLE Sense
+* Arduino Nano 33 BLE Sense Rev2
+* Arduino Nano RP2040 Connect (by itself, or with the Science Carrier R3)
 
-* The MKR WiFi 1010 included with the Science Kit comes pre-configured for use with Science Journal. It needs to be connected using the _Science carrier board_, which is only available in the [Arduino Science Kit Physics Lab](https://store.arduino.cc/products/arduino-science-kit-physics-lab).
-* [Follow these instructions](https://support.arduino.cc/hc/en-us/articles/4408029337746-Upload-the-Science-Journal-firmware) if you are using an individually bought replacement, uploaded a different firmware, or are using the Nano 33 BLE Sense.
+> Note 1: The MKR WiFi 1010 needs to be connected using the Science Carrier, which is only available in the [Arduino Science Kit Physics Lab](https://store.arduino.cc/products/arduino-science-kit-physics-lab).
+>
+> Note 2: If your board came with a Science Kit, it will have the the required firmware out-of-the-box. If you're using a board not included in a Science Kit, an individually bought board replacement, or have flashed the board with different firmware, see [Upload the Science Journal firmware](https://support.arduino.cc/hc/en-us/articles/4408029337746-Upload-the-Science-Journal-firmware).
+
+<a id="connect-a-board"></a>
 
 ## Connect a board
 
 You can find [instructions on how to connect a board here](https://support.arduino.cc/hc/en-us/articles/4407749620370-Connect-a-board-to-the-Science-Journal-app).
 
+<a id="access-lessons-and-activities"></a>
+
 ## Access lessons and activities
 
 Lessons and activities are available within the different modules:
@@ -41,8 +61,10 @@ Lessons and activities are available within the different modules:
 
 ![Accessing lessons and activities in the menu.](img/science-journal-web-modules-dropdown.png)
 
+<a id="troubleshooting"></a>
+
 ## Troubleshooting
 
-* If you're using the MKR WiFI 1010, make sure the Science carrier board is connected.
-* Make sure your board has the correct firmware.
+* If you're using a Science Carrier, make sure the board is properly connected to it and that the pins (e.g. A1, A2) line up.
+* Make sure your board has the correct firmware. See [Upload the Science Journal firmware](https://support.arduino.cc/hc/en-us/articles/4408029337746-Upload-the-Science-Journal-firmware) for more information.
 * [If Arduino Science Journal quits unexpectedly or does not start](https://support.arduino.cc/hc/en-us/articles/4409561973010)

content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md

@@ -3,89 +3,108 @@ title: "Upload the Science Journal firmware"
 id: 4408029337746
 ---
 
-Boards supported by the Science Journal App require special firmware to connect.
-
-- Arduino Nano 33 BLE Sense
-- Arduino MKR WiFi 1010
-
----
-
-## Using the Web Editor
+Learn how to upload the Science Journal firmware to your board. In this article:
+
+* [Compatible boards](#compatible-boards)
+* [Board configuration overview](#board-configuration)
+* [Upload the firmware using the Web Editor](#using-the-web-editor)
+* [Upload the firmware using Arduino IDE](#using-arduino-ide)
+
+<a id="compatible-boards"></a>
+
+## Compatible boards
+
+The Science Journal can be used with the following boards:
+
+* Arduino MKR WiFi 1010 (with the Science Carrier, or Science Carrier Rev2)
+* Arduino Nano 33 BLE Sense
+* Arduino Nano 33 BLE Sense Rev2
+* Arduino Nano RP2040 Connect (by itself, or with the Science Carrier R3)
+
+>The MKR WiFi 1010 needs to be connected using the Science Carrier, which is only available in the [Arduino Science Kit Physics Lab](https://store.arduino.cc/products/arduino-science-kit-physics-lab).
+
+<a id="board-configuration"></a>
+
+## Board configuration overview
+
+To use the Science Journal, it is necessary to use different libraries and examples depending on your board or Science Kit. See the table below for an overview:
+
+<table>
+  <thead>
+    <tr>
+      <th>Board</th>
+      <th>Library</th>
+      <th>Example</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Arduino Nano 33 BLE Sense (by itself)</td>
+      <td>Arduino_ScienceJournal</td>
+      <td>/ScienceKit/<em>Nano33BLESenseFirmware</em></td>
+    </tr>
+    <tr>
+      <td>Arduino Nano 33 BLE Sense Rev2 (by itself)</td>
+      <td>Arduino_ScienceJournal</td>
+      <td>/ScienceKit/<em>Nano33BLESenseRev2Firmware</em></td>
+    </tr>
+    <tr>
+      <td>Arduino MKR WiFi 1010 (with Science Carrier)</td>
+      <td>Arduino_ScienceJournal</td>
+      <td>/ScienceKit/<em>PhysicsLabFirmware</em></td>
+    </tr>
+    <tr>
+      <td>Arduino MKR WiFi 1010 (with Science Carrier Rev2)</td>
+      <td>Arduino_ScienceJournal</td>
+      <td>/ScienceKitR2/<em>PhysicsLabFirmware</em></td>
+    </tr>
+    <tr>
+      <td>Arduino Nano RP2040 Connect (by itself)</td>
+      <td>Arduino_ScienceJournal</td>
+      <td>/ScienceKit/<em>RP2040ConnectFirmware</em></td>
+    </tr>
+    <tr>
+      <td>Arduino Nano RP2040 Connect (with Science Carrier R3)</td>
+      <td>Arduino_ScienceKitCarrier</td>
+      <td>/<em>ScienceJournal</em></td>
+    </tr>
+  </tbody>
+</table>
+
+<a id="using-the-web-editor"></a>
+
+## Upload the firmware using the Web Editor
 
 1. Open the [Web Editor](https://create.arduino.cc/editor).
-
 2. Connect your board to your computer with a USB cable.
-
 3. Select your board in the board dropdown.
 
    ![The board dropdown in the Web Editor.](img/web-editor-sj-firmware-board.png)
 
-4. Click on **Examples** in the left-most sidebar to open the Examples tab.
-
-   - If you're using Nano 33 BLE Sense, search for "Nano33BLESenseFirmware" and open the  the result in the ARDUINO_SCIENCEJOURNAL library.
-
-     ![Opening the Nano33BLESenseFirmware example from the Arduino_ScienceJournal library.](img/web-editor-sj-firmware-sj-open.png)
+4. Check the [Board configuration overview  table](#board-configuration) for information about the required library and example for your board.
+5. Click on **Examples** in the left-most sidebar to open the Examples tab. Search the example for your board in the textbox and select it in the results area.
 
-   - MKR WiFi 1010: Search for `PhysicsLabFirmware` and open the result from the PHYSICSLABFIRMWARE library, **not** the ARDUINO_SCIENCEJOURNAL library.
+    ![Opening the Nano33BLESenseFirmware example from the Arduino_ScienceJournal library.](img/web-editor-select-example.png)
 
-      ![Opening the PhysicsLabFirmware example from the PhyisicsLabFirmware library.](img/web-editor-sj-firmware-physlab-open.png)
-
-5. Click the ![Web Editor upload button.](img/symbol_upload-web.png) **Upload** button.
+6. Click the ![Web Editor upload button.](img/symbol_upload-web.png) **Upload** button.
 
    ![Uploading the sketch in the Web Editor.](img/web-editor-sj-firmware-upload.png)
 
-6. Wait for the process to finish.
-
-> Compilation for the Nano 33 BLE Sense may take several minutes, and the console will not print any messages during this time.
-
-When the upload is completed you can [connect your board to the Science Journal app](https://support.arduino.cc/hc/en-us/articles/4407749620370).
-
----
-
-## Using Arduino IDE
-
-### Install the libraries
-
-You need to install the following libraries:
-
-- `Arduino_ScienceJournal`
-- `Adafruit LSM9DS1 Library` (MKR WiFi 1010 only)
-
-Find and install the libraries by using the Library Manager (`Tools > Manage Libraries...`).
-
-![Library manager showing a search query for Arduino Science Journal](img/Science_journal_library.png)
-
-### Run the firmware upload sketch
-
-1. Find and open the firmware upload sketch:
-
-   - **MKR WiFi 1010:**
-
-     IDE 1.x: `File > Examples > INCOMPATIBLE > Arduino_ScienceJournal > PhysicsLabFirmware`.
-
-     IDE 2: `File > Examples > Arduino_ScienceJournal > PhysicsLabFirmware`.
-
-   - **Nano 33 BLE Sense:**
-
-     IDE 1.x: `File > Examples > INCOMPATIBLE > Arduino_ScienceJournal > Nano33BLESenseFirmware`, depending on the IDE version.
-
-     IDE 2: `File > Examples > Arduino_ScienceJournal > Nano33BLESenseFirmware`
-
-2. Click the ![Upload button](img/symbol_upload.png) **Upload** button.
-
-3. Wait for the process to finish.
-
-> Compilation for the Nano 33 BLE Sense may take several minutes, and the console will not print any messages during this time. In IDE 1.8, you can monitor the progress bar in the console's top-right corner.
-
-When the upload is completed you can [connect your board to the Science Journal app](https://support.arduino.cc/hc/en-us/articles/4407749620370).
+7. Wait for the process to finish (Compilation for the Nano 33 BLE Sense may take several minutes, and the console will not print any messages during this time).
+8. When the upload is completed, you can [connect your board to the Science Journal app](https://support.arduino.cc/hc/en-us/articles/4407749620370).
 
-### Troubleshooting
+<a id="using-arduino-ide"></a>
 
-#### If you can't find the library
+## Upload the firmware using Arduino IDE
 
-- Make sure the library is installed in the Library Manager
-- Make sure your board is selected in `Tools > Board`.
+1. Connect your board to your computer with a USB cable.
+2. Open Arduino IDE and [select your board](https://support.arduino.cc/hc/en-us/articles/4406856349970-Select-board-and-port-in-Arduino-IDE).
+3. Check the [Board configuration overview  table](#board-configuration) for information about the required library and example for your board.
+4. [Install the library](https://support.arduino.cc/hc/en-us/articles/5145457742236-Add-libraries-to-Arduino-IDE) for your board.
+5. In `File > Examples`, hover over the library for your board to reveal the examples and select the example for your board (In IDE 1, the path is `File > Examples > INCOMPATIBLE`).
 
-#### Adafruit_LSM9DS1.h: No such file or directory
+    ![Arduino IDE 2 with the Nano33BLESenseFirmware example in the File>Examples menu](img/ide2-select-example-sj.png)
 
-If you get this error message, you need to install the `Adafruit LSM9DS1 Library` and it's dependencies in the Library Manager.
+6. Click the ![Upload button](img/symbol_upload.png) **Upload** button.
+7. Wait for the process to finish (Compilation for the Nano 33 BLE Sense may take several minutes, and the console will not print any messages during this time).
+8. When the upload is completed, you can [connect your board to the Science Journal app](https://support.arduino.cc/hc/en-us/articles/4407749620370).