Skip to content

Commit 0f0b8f4

Browse files
Merge pull request #296 from arduino/science-journal-updates
Science journal updates [HC-1394]
2 parents 5b913bc + 672084f commit 0f0b8f4

16 files changed

+147
-96
lines changed

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

Lines changed: 28 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -3,32 +3,42 @@ title: "Connect a board to the Science Journal app"
33
id: 4407749620370
44
---
55

6-
## Supported boards
6+
Learn how to connect a board to the Arduino Science Journal app. In this article:
77

8-
The Science Journal app supports the following boards:
8+
* [Compatible boards](#compatible-boards)
9+
* [Set up your board](#set-up-your-board)
10+
* [Connect the Science Journal app](#connect-the-science-journal-app)
11+
* [Troubleshooting](#troubleshooting)
912

10-
- Arduino Nano 33 BLE Sense
11-
- Arduino MKR WiFi 1010 (with the Science carrier board)
13+
---
1214

13-
## Set up your board
15+
<a id="compatible-boards"></a>
16+
17+
## Compatible boards
1418

15-
### Set up the Arduino MKR WiFi 1010
19+
The Science Journal can be used with the following boards:
1620

17-
> 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).
21+
* Arduino MKR WiFi 1010 (with the Science Carrier, or Science Carrier Rev2)
22+
* Arduino Nano 33 BLE Sense
23+
* Arduino Nano 33 BLE Sense Rev2
24+
* Arduino Nano RP2040 Connect (by itself, or with the Science Carrier R3)
1825

19-
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.
26+
> 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).
2027
21-
1. Connect the board to the carrier, making sure that the pins (e.g. A1, A2) line up.
28+
<a id="set-up-your-board"></a>
29+
30+
## Set up your board
2231

23-
2. Power the setup, via a USB cable to the board or otherwise.
32+
1. **Upload the Science Journal firmware:**
2433

25-
### Set up the Arduino Nano 33 BLE Sense
34+
* If your board came with a Science Kit, **it will have the the required firmware out-of-the-box**.
35+
* 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).
2636

27-
The Nano 33 BLE Sense needs to be flashed with special firmware for use with the Science Journal app.
37+
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.
2838

29-
1. [Flash the firmware](https://support.arduino.cc/hc/en-us/articles/4408029337746).
39+
3. Power the setup, via a USB cable to the board or otherwise.
3040

31-
2. Power the setup, via a USB cable to the board or otherwise.
41+
<a id="connect-the-science-journal-app"></a>
3242

3343
## Connect the Science Journal app
3444

@@ -40,11 +50,11 @@ The Nano 33 BLE Sense needs to be flashed with special firmware for use with the
4050

4151
4. Tap **Sensors**.
4252

43-
![The Sensors button in Science Journal.](img/sj-button-sensors.png)
53+
![The Sensors button in Science Journal.](img/sj-v2-button-sensors.png)
4454

4555
5. Open settings by tapping the cogwheel button in the top right.
4656

47-
![The settings button in Science Journal.](img/sj-button-cogwheel.png)
57+
![The settings button in Science Journal.](img/sj-v2-button-cogwheel.png)
4858

4959
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).
5060

@@ -56,10 +66,10 @@ The Nano 33 BLE Sense needs to be flashed with special firmware for use with the
5666

5767
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.
5868

59-
![Finding the device in the 'Arduino boards' category.](img/science-journal-missing-board-expand.gif)
69+
![Finding the device in the 'Arduino boards' category.](img/SJ-v2-missing-board-expand.gif)
6070

6171
### The board may already be added
6272

6373
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.
6474

65-
![Finding the added device.](img/science-journal-missing-board-middle.gif)
75+
![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

Lines changed: 31 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,30 +3,50 @@ title: "Get started with the Arduino Science Journal"
33
id: 4412950851346
44
---
55

6-
Learn how to get started with the Arduino Science Journal.
6+
Learn how to get started with the Arduino Science Journal. In this article:
7+
8+
* [Get the app](#get-the-app)
9+
* [Compatible boards](#compatible-boards)
10+
* [Connect a board](#connect-a-board)
11+
* [Access lessons and activities](#access-lessons-and-activities)
12+
* [Troubleshooting](#troubleshooting)
713

814
---
915

16+
<a id="get-the-app"></a>
17+
1018
## Get the app
1119

12-
The Arduino Science Journal app can be downloaded from the App Store (iOS) and Google Play (Android).
20+
You can download the Arduino Science Journal app from the App Store (iOS) and Google Play (Android).
1321

14-
* [Download on the App Store](https://apps.apple.com/us/app/arduino-science-journal/id1518014927)
15-
* [Get it on Google Play](https://play.google.com/store/apps/details?id=cc.arduino.sciencejournal)
22+
* <a class="link-external" href="https://apps.apple.com/us/app/arduino-science-journal/id1518014927">Download on the App Store</a>
23+
* <a class="link-external" href="https://play.google.com/store/apps/details?id=cc.arduino.sciencejournal">Get it on Google Play</a>
1624

1725
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.
1826

27+
<a id="compatible-boards"></a>
28+
1929
## Compatible boards
2030

21-
The Science Journal can be used with **Arduino MKR WiFi 1010** or **Arduino Nano 33 BLE Sense**.
31+
The Science Journal can be used with the following boards:
32+
33+
* Arduino MKR WiFi 1010 (with the Science Carrier, or Science Carrier Rev2)
34+
* Arduino Nano 33 BLE Sense
35+
* Arduino Nano 33 BLE Sense Rev2
36+
* Arduino Nano RP2040 Connect (by itself, or with the Science Carrier R3)
2237

23-
* 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).
24-
* [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.
38+
> 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).
39+
>
40+
> 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).
41+
42+
<a id="connect-a-board"></a>
2543

2644
## Connect a board
2745

2846
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).
2947

48+
<a id="access-lessons-and-activities"></a>
49+
3050
## Access lessons and activities
3151

3252
Lessons and activities are available within the different modules:
@@ -41,8 +61,10 @@ Lessons and activities are available within the different modules:
4161

4262
![Accessing lessons and activities in the menu.](img/science-journal-web-modules-dropdown.png)
4363

64+
<a id="troubleshooting"></a>
65+
4466
## Troubleshooting
4567

46-
* If you're using the MKR WiFI 1010, make sure the Science carrier board is connected.
47-
* Make sure your board has the correct firmware.
68+
* 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.
69+
* 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.
4870
* [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

Lines changed: 88 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -3,89 +3,108 @@ title: "Upload the Science Journal firmware"
33
id: 4408029337746
44
---
55

6-
Boards supported by the Science Journal App require special firmware to connect.
7-
8-
- Arduino Nano 33 BLE Sense
9-
- Arduino MKR WiFi 1010
10-
11-
---
12-
13-
## Using the Web Editor
6+
Learn how to upload the Science Journal firmware to your board. In this article:
7+
8+
* [Compatible boards](#compatible-boards)
9+
* [Board configuration overview](#board-configuration)
10+
* [Upload the firmware using the Web Editor](#using-the-web-editor)
11+
* [Upload the firmware using Arduino IDE](#using-arduino-ide)
12+
13+
<a id="compatible-boards"></a>
14+
15+
## Compatible boards
16+
17+
The Science Journal can be used with the following boards:
18+
19+
* Arduino MKR WiFi 1010 (with the Science Carrier, or Science Carrier Rev2)
20+
* Arduino Nano 33 BLE Sense
21+
* Arduino Nano 33 BLE Sense Rev2
22+
* Arduino Nano RP2040 Connect (by itself, or with the Science Carrier R3)
23+
24+
>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).
25+
26+
<a id="board-configuration"></a>
27+
28+
## Board configuration overview
29+
30+
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:
31+
32+
<table>
33+
<thead>
34+
<tr>
35+
<th>Board</th>
36+
<th>Library</th>
37+
<th>Example</th>
38+
</tr>
39+
</thead>
40+
<tbody>
41+
<tr>
42+
<td>Arduino Nano 33 BLE Sense (by itself)</td>
43+
<td>Arduino_ScienceJournal</td>
44+
<td>/ScienceKit/<em>Nano33BLESenseFirmware</em></td>
45+
</tr>
46+
<tr>
47+
<td>Arduino Nano 33 BLE Sense Rev2 (by itself)</td>
48+
<td>Arduino_ScienceJournal</td>
49+
<td>/ScienceKit/<em>Nano33BLESenseRev2Firmware</em></td>
50+
</tr>
51+
<tr>
52+
<td>Arduino MKR WiFi 1010 (with Science Carrier)</td>
53+
<td>Arduino_ScienceJournal</td>
54+
<td>/ScienceKit/<em>PhysicsLabFirmware</em></td>
55+
</tr>
56+
<tr>
57+
<td>Arduino MKR WiFi 1010 (with Science Carrier Rev2)</td>
58+
<td>Arduino_ScienceJournal</td>
59+
<td>/ScienceKitR2/<em>PhysicsLabFirmware</em></td>
60+
</tr>
61+
<tr>
62+
<td>Arduino Nano RP2040 Connect (by itself)</td>
63+
<td>Arduino_ScienceJournal</td>
64+
<td>/ScienceKit/<em>RP2040ConnectFirmware</em></td>
65+
</tr>
66+
<tr>
67+
<td>Arduino Nano RP2040 Connect (with Science Carrier R3)</td>
68+
<td>Arduino_ScienceKitCarrier</td>
69+
<td>/<em>ScienceJournal</em></td>
70+
</tr>
71+
</tbody>
72+
</table>
73+
74+
<a id="using-the-web-editor"></a>
75+
76+
## Upload the firmware using the Web Editor
1477

1578
1. Open the [Web Editor](https://create.arduino.cc/editor).
16-
1779
2. Connect your board to your computer with a USB cable.
18-
1980
3. Select your board in the board dropdown.
2081

2182
![The board dropdown in the Web Editor.](img/web-editor-sj-firmware-board.png)
2283

23-
4. Click on **Examples** in the left-most sidebar to open the Examples tab.
24-
25-
- If you're using Nano 33 BLE Sense, search for "Nano33BLESenseFirmware" and open the the result in the ARDUINO_SCIENCEJOURNAL library.
26-
27-
![Opening the Nano33BLESenseFirmware example from the Arduino_ScienceJournal library.](img/web-editor-sj-firmware-sj-open.png)
84+
4. Check the [Board configuration overview table](#board-configuration) for information about the required library and example for your board.
85+
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.
2886

29-
- MKR WiFi 1010: Search for `PhysicsLabFirmware` and open the result from the PHYSICSLABFIRMWARE library, **not** the ARDUINO_SCIENCEJOURNAL library.
87+
![Opening the Nano33BLESenseFirmware example from the Arduino_ScienceJournal library.](img/web-editor-select-example.png)
3088

31-
![Opening the PhysicsLabFirmware example from the PhyisicsLabFirmware library.](img/web-editor-sj-firmware-physlab-open.png)
32-
33-
5. Click the ![Web Editor upload button.](img/symbol_upload-web.png) **Upload** button.
89+
6. Click the ![Web Editor upload button.](img/symbol_upload-web.png) **Upload** button.
3490

3591
![Uploading the sketch in the Web Editor.](img/web-editor-sj-firmware-upload.png)
3692

37-
6. Wait for the process to finish.
38-
39-
> Compilation for the Nano 33 BLE Sense may take several minutes, and the console will not print any messages during this time.
40-
41-
When the upload is completed you can [connect your board to the Science Journal app](https://support.arduino.cc/hc/en-us/articles/4407749620370).
42-
43-
---
44-
45-
## Using Arduino IDE
46-
47-
### Install the libraries
48-
49-
You need to install the following libraries:
50-
51-
- `Arduino_ScienceJournal`
52-
- `Adafruit LSM9DS1 Library` (MKR WiFi 1010 only)
53-
54-
Find and install the libraries by using the Library Manager (`Tools > Manage Libraries...`).
55-
56-
![Library manager showing a search query for Arduino Science Journal](img/Science_journal_library.png)
57-
58-
### Run the firmware upload sketch
59-
60-
1. Find and open the firmware upload sketch:
61-
62-
- **MKR WiFi 1010:**
63-
64-
IDE 1.x: `File > Examples > INCOMPATIBLE > Arduino_ScienceJournal > PhysicsLabFirmware`.
65-
66-
IDE 2: `File > Examples > Arduino_ScienceJournal > PhysicsLabFirmware`.
67-
68-
- **Nano 33 BLE Sense:**
69-
70-
IDE 1.x: `File > Examples > INCOMPATIBLE > Arduino_ScienceJournal > Nano33BLESenseFirmware`, depending on the IDE version.
71-
72-
IDE 2: `File > Examples > Arduino_ScienceJournal > Nano33BLESenseFirmware`
73-
74-
2. Click the ![Upload button](img/symbol_upload.png) **Upload** button.
75-
76-
3. Wait for the process to finish.
77-
78-
> 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.
79-
80-
When the upload is completed you can [connect your board to the Science Journal app](https://support.arduino.cc/hc/en-us/articles/4407749620370).
93+
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).
94+
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).
8195

82-
### Troubleshooting
96+
<a id="using-arduino-ide"></a>
8397

84-
#### If you can't find the library
98+
## Upload the firmware using Arduino IDE
8599

86-
- Make sure the library is installed in the Library Manager
87-
- Make sure your board is selected in `Tools > Board`.
100+
1. Connect your board to your computer with a USB cable.
101+
2. Open Arduino IDE and [select your board](https://support.arduino.cc/hc/en-us/articles/4406856349970-Select-board-and-port-in-Arduino-IDE).
102+
3. Check the [Board configuration overview table](#board-configuration) for information about the required library and example for your board.
103+
4. [Install the library](https://support.arduino.cc/hc/en-us/articles/5145457742236-Add-libraries-to-Arduino-IDE) for your board.
104+
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`).
88105

89-
#### Adafruit_LSM9DS1.h: No such file or directory
106+
![Arduino IDE 2 with the Nano33BLESenseFirmware example in the File>Examples menu](img/ide2-select-example-sj.png)
90107

91-
If you get this error message, you need to install the `Adafruit LSM9DS1 Library` and it's dependencies in the Library Manager.
108+
6. Click the ![Upload button](img/symbol_upload.png) **Upload** button.
109+
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).
110+
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).
2.02 MB
Loading
1.96 MB
Loading
-63.7 KB
Binary file not shown.
153 KB
Loading
-1.64 MB
Binary file not shown.
-2.67 MB
Binary file not shown.
-7.06 KB
Binary file not shown.

0 commit comments

Comments
 (0)