From 0e21b4c950e878a93bb4c9f3fa5e90d4467d2b53 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Wed, 13 Nov 2024 12:18:23 +0100 Subject: [PATCH 1/3] update library info --- ...nect-a-board-to-the-Science-Journal-app.md | 29 ++++++---- .../Upload-the-Science-Journal-firmware.md | 56 ++++++++++++------- 2 files changed, 54 insertions(+), 31 deletions(-) diff --git a/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md b/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md index 4cd2c670..3dc096b8 100644 --- a/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md +++ b/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md @@ -5,10 +5,10 @@ id: 4407749620370 Learn how to connect a board to the Arduino Science Journal app. In this article: -* [Compatible boards](#compatible-boards) -* [Set up your board](#set-up-your-board) -* [Connect the Science Journal app](#connect-the-science-journal-app) -* [Troubleshooting](#troubleshooting) +- [Compatible boards](#compatible-boards) +- [Set up your board](#set-up-your-board) +- [Connect the Science Journal app](#connect-the-science-journal-app) +- [Troubleshooting](#troubleshooting) --- @@ -18,10 +18,10 @@ Learn how to connect a board to the Arduino Science Journal app. In this article 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) +- 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) > [!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). @@ -32,8 +32,8 @@ The Science Journal can be used with the following boards: 1. **Upload the Science Journal firmware:** - * 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). + - 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). 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. @@ -76,3 +76,12 @@ Under **Available Devices**, the arrow next to Arduino Boards should be pointing 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/SJ-v2-missing-board-middle.gif) + +### Ensure your libraries are updated + +If you’re experiencing connectivity issues, it may be due to outdated libraries. Verify in that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are updated to their latest version in the Library Manager in Arduino IDE. + +If the libraries aren’t available in the Library Manager, you can download and install the latest versions manually: + +- [Arduino_ScienceJournal](https://github.com/arduino-libraries/Arduino_ScienceJournal/releases/tag/1.3.0) +- [Arduino_BMI270_BMM150](https://github.com/arduino-libraries/Arduino_BMI270_BMM150/releases/tag/1.2.1) diff --git a/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md b/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md index 866f4e02..c6f1071b 100644 --- a/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md +++ b/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md @@ -5,10 +5,10 @@ id: 4408029337746 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 Cloud Editor](#using-the-cloud-editor) -* [Upload the firmware using Arduino IDE](#using-arduino-ide) +- [Compatible boards](#compatible-boards) +- [Board configuration overview](#board-configuration) +- [Upload the firmware using the Cloud Editor](#using-the-cloud-editor) +- [Upload the firmware using Arduino IDE](#using-arduino-ide) @@ -16,12 +16,12 @@ Learn how to upload the Science Journal firmware to your board. In this article: 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) +- 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). +> 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). @@ -29,14 +29,15 @@ The Science Journal can be used with the following boards: 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: -| Board | Library | Example | -| ------------------------------------------ | ----------------------- | ------------------------------------- | -| Arduino Nano 33 BLE Sense (by itself) | Arduino_ScienceJournal | /ScienceKit/Nano33BLESenseFirmware | -| Arduino Nano 33 BLE Sense Rev2 (by itself) | Arduino_ScienceJournal | /ScienceKit/Nano33BLESenseRev2Firmware | -| Arduino MKR WiFi 1010 (with Science Carrier)| Arduino_ScienceJournal | /ScienceKit/PhysicsLabFirmware | -| Arduino MKR WiFi 1010 (with Science Carrier Rev2)| Arduino_ScienceJournal | /ScienceKitR2/PhysicsLabFirmware | -| Arduino Nano RP2040 Connect (by itself) | Arduino_ScienceJournal | /ScienceKit/RP2040ConnectFirmware | -| Arduino Nano RP2040 Connect (with Science Carrier R3)| Arduino_ScienceKitCarrier | /ScienceJournal | +| Board | Library | Example | +| ----------------------------------------------------- | ------------------------- | ----------------------------------------------- | +| Arduino Nano 33 BLE Sense (by itself) | Arduino_ScienceJournal | /ScienceKit/Nano33BLESenseFirmware | +| Arduino Nano 33 BLE Sense Rev2 (by itself) | Arduino_ScienceJournal | /ScienceKit/Nano33BLESenseRev2Firmware | +| Arduino MKR WiFi 1010 (with Science Carrier) | Arduino_ScienceJournal | /ScienceKit/PhysicsLabFirmware | +| Arduino MKR WiFi 1010 (with Science Carrier Rev2) | Arduino_ScienceJournal | /ScienceKitR2/PhysicsLabFirmware | +| Arduino Nano RP2040 Connect (by itself) | Arduino_ScienceJournal | /ScienceKit/RP2040ConnectFirmware | +| Arduino Nano RP2040 Connect (with Science Carrier R3) | Arduino_ScienceKitCarrier | /ScienceJournal | + {.table-regular} @@ -44,21 +45,25 @@ To use the Science Journal, it is necessary to use different libraries and examp ## Upload the firmware using the Cloud Editor 1. Open the [Cloud Editor](https://support.arduino.cc/hc/en-us/articles/13809101080732-Open-the-Cloud-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 Cloud Editor.](img/web-editor-sj-firmware-board.png) -4. Check the [Board configuration overview table](#board-configuration) for information about the required library and example for your board. +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. - ![Opening the Nano33BLESenseFirmware example from the Arduino_ScienceJournal library.](img/web-editor-select-example.png) + ![Opening the Nano33BLESenseFirmware example from the Arduino_ScienceJournal library.](img/web-editor-select-example.png) 6. Click the ![Cloud Editor upload button.](img/symbol_upload-web.png) **Upload** button. ![Uploading the sketch in the Cloud Editor.](img/web-editor-sj-firmware-upload.png) 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). @@ -66,13 +71,22 @@ To use the Science Journal, it is necessary to use different libraries and examp ## Upload the firmware using Arduino IDE 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. + +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. + + > [!NOTE] + > Ensure that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are updated to their latest versions, as these outdated libraries may lead to connectivity issues. + 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`). - ![Arduino IDE 2 with the Nano33BLESenseFirmware example in the File>Examples menu](img/ide2-select-example-sj.png) + ![Arduino IDE 2 with the Nano33BLESenseFirmware example in the File>Examples menu](img/ide2-select-example-sj.png) 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). From 50f8d079e5d959c04443a10361b06a3e21ea61b0 Mon Sep 17 00:00:00 2001 From: alexandra Date: Mon, 18 Nov 2024 11:00:41 +0100 Subject: [PATCH 2/3] small edit --- .../Connect-a-board-to-the-Science-Journal-app.md | 2 +- .../Science Journal App/Upload-the-Science-Journal-firmware.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md b/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md index 3dc096b8..4d16828b 100644 --- a/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md +++ b/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md @@ -79,7 +79,7 @@ If both the Internal sensors and the board sensor categories are expanded, they ### Ensure your libraries are updated -If you’re experiencing connectivity issues, it may be due to outdated libraries. Verify in that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are updated to their latest version in the Library Manager in Arduino IDE. +If you’re experiencing connectivity issues, it may be due to outdated libraries. Verify in that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are both updated to their latest version in the Library Manager in Arduino IDE. If the libraries aren’t available in the Library Manager, you can download and install the latest versions manually: diff --git a/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md b/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md index c6f1071b..b0f720ee 100644 --- a/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md +++ b/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md @@ -79,7 +79,7 @@ To use the Science Journal, it is necessary to use different libraries and examp 4. [Install the library](https://support.arduino.cc/hc/en-us/articles/5145457742236-Add-libraries-to-Arduino-IDE) for your board. > [!NOTE] - > Ensure that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are updated to their latest versions, as these outdated libraries may lead to connectivity issues. + > Ensure that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are both updated to their latest versions, as these outdated libraries may lead to connectivity issues. 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`). From e42e8cea71e93fcdc14ba047b8fc1e8f4cbab6b3 Mon Sep 17 00:00:00 2001 From: alexandra <83598143+gorillagripcore@users.noreply.github.com> Date: Wed, 20 Nov 2024 13:19:37 +0100 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Renat0Ribeir0 <86349945+Renat0Ribeir0@users.noreply.github.com> --- .../Connect-a-board-to-the-Science-Journal-app.md | 8 ++++---- .../Upload-the-Science-Journal-firmware.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md b/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md index 4d16828b..303771b5 100644 --- a/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md +++ b/content/Education and Kits/Science Journal App/Connect-a-board-to-the-Science-Journal-app.md @@ -79,9 +79,9 @@ If both the Internal sensors and the board sensor categories are expanded, they ### Ensure your libraries are updated -If you’re experiencing connectivity issues, it may be due to outdated libraries. Verify in that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are both updated to their latest version in the Library Manager in Arduino IDE. +If you’re experiencing connectivity issues, it may be due to outdated libraries. Verify in that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are both updated to their latest version in the [Library Manager](https://support.arduino.cc/hc/en-us/articles/5145457742236-Add-libraries-to-Arduino-IDE#library-manager) in Arduino IDE. -If the libraries aren’t available in the Library Manager, you can download and install the latest versions manually: +Alternatively, you can download and [manually install](https://support.arduino.cc/hc/en-us/articles/5145457742236-Add-libraries-to-Arduino-IDE#manual-installation) the latest versions from the releases pages: -- [Arduino_ScienceJournal](https://github.com/arduino-libraries/Arduino_ScienceJournal/releases/tag/1.3.0) -- [Arduino_BMI270_BMM150](https://github.com/arduino-libraries/Arduino_BMI270_BMM150/releases/tag/1.2.1) +- [Arduino_ScienceJournal](https://github.com/arduino-libraries/Arduino_ScienceJournal/releases) {.link-external} +- [Arduino_BMI270_BMM150](https://github.com/arduino-libraries/Arduino_BMI270_BMM150/releases) {.link-external} diff --git a/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md b/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md index b0f720ee..f3df1f4c 100644 --- a/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md +++ b/content/Education and Kits/Science Journal App/Upload-the-Science-Journal-firmware.md @@ -79,7 +79,7 @@ To use the Science Journal, it is necessary to use different libraries and examp 4. [Install the library](https://support.arduino.cc/hc/en-us/articles/5145457742236-Add-libraries-to-Arduino-IDE) for your board. > [!NOTE] - > Ensure that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are both updated to their latest versions, as these outdated libraries may lead to connectivity issues. + > Ensure that the `Arduino_ScienceJournal` and `Arduino_BMI270_BMM150` libraries are updated to their latest versions, as outdated libraries may cause connectivity issues. 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`).