Skip to content

Commit c227683

Browse files
Revise Chromebook Articles [HC-1348, HC-1512, HC-1501, HC-1500] (#345)
* Revised Cloud Editor instructions + new imgs * structural fixes * Troubleshoot Guide added * Split articles "If the sketch uploads but the device isn’t online" * Chromebook edits and grammar * Added information/troubleshooting section * fixes after feedback * tweaks to troubleshooting section * Add article ID to front matter * Add temporary warning about missing app * Some adjustments to article structure * Streamline the troubleshooting section * grammar tweaks --------- Co-authored-by: seaxwi <[email protected]>
1 parent 8409768 commit c227683

10 files changed

+170
-163
lines changed

content/Arduino Cloud/Arduino Chrome App/Use-Arduino-with-Chromebook.md

+34-12
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,27 @@ title: "Use Arduino with Chromebook"
33
id: 360016495639
44
---
55

6+
> [!WARNING]
7+
> The **Arduino Cloud for Chromebook** has been removed from Google Play and is currently unavailable. We are actively working to resolve the issue.
8+
69
You can write and upload sketches on Chrome OS with the Cloud Editor in Arduino Cloud. The Cloud Editor has an extensive feature set similar to the desktop IDE. While many popular boards are compatible, you should check [the list of compatible boards here](https://support.arduino.cc/hc/en-us/articles/360014779899).
710

811
---
912

1013
## Install Arduino Cloud for Chromebook
1114

12-
To use Arduino boards on Chromebook, you need to install the **Arduino Cloud for Chromebook** app. This app handles serial communication with the board, and is replacing the previous Chrome Apps[^chrome-apps].
15+
> [!WARNING]
16+
> The **Arduino Cloud for Chromebook** has been removed from Google Play and is currently unavailable. We are actively working to resolve the issue.
17+
18+
To use Arduino boards on Chromebook, you need to install the **Arduino Cloud for Chromebook** app. This app handles serial communication with the board and is replacing the previous Chrome Apps[^chrome-apps].
1319

1420
Follow these steps to install Arduino Cloud for Chromebook:
1521

1622
1. Open [Arduino Cloud for Chromebook (Google Play)](https://play.google.com/store/apps/details?id=cc.arduino.create_editor){.link-external}
1723
2. Click the **Install** button on the page.
1824
3. Choose the device and click **Install**.
1925
4. Find the app in the **Launcher** to open it.
20-
5. Sign into your Arduino account
26+
5. Sign in to your Arduino account
2127

2228
<a id="compatible"></a>
2329

@@ -40,28 +46,44 @@ The currently supported boards include:
4046
## Use the Cloud Editor on Chromebook
4147

4248
> [!IMPORTANT]
43-
> The first time you use your board with Chromebook, you need to allow access to the serial port.
49+
> The first time you use your board with a Chromebook, you need to allow access to the serial port.
4450
>
4551
> To do this, attempt to upload a sketch (even if no port is available).
4652
4753
Follow these steps:
4854

49-
1. Open **Arduino Cloud for Chromebook** from the Launcher or go to [create.arduino.cc/editor](https://create.arduino.cc/editor).
50-
1. If you're not signed into an Arduino account, you will be asked to do so.
51-
1. Connect a [compatible board](https://support.arduino.cc/hc/en-us/articles/360014779899#chromebook) to a USB port on your Chromebook.
52-
1. Open the board selector:
55+
1. Open the **Arduino Cloud for Chromebook** either from the Launcher or by visiting [create.arduino.cc/editor](create.arduino.cc/editor)
5356

54-
![The Boards Dropdown in the Cloud Editor.](img/web-editor-boards-dropdown.png)
57+
1. If you're not already signed into your Arduino account, you'll be prompted to do so.
58+
59+
1. Connect a [compatible board](https://support.arduino.cc/hc/en-us/articles/360014779899#chromebook) to one of the USB ports on your Chromebook.
5560

5661
1. In the board selector menu, choose **Select Other Board & Port**
5762

58-
1. Select the board that you are using (don't worry about the port).
63+
![The Boards Dropdown in the Cloud Editor.](img/web-editor-boards-dropdown.png)
64+
65+
1. Pick the specific board you're using and click **OK**.
5966

60-
1. Click the **Upload** button. This will open the **Authorise USB connection** prompt.
67+
1. Click the **Upload** button ![Upload button](img/upload_button.png) in the editor.
6168

62-
1. Click **Select port**. This will open a ChromeOS prompt.
69+
1. That should open a **Authorise USB connection** window. Click **Select port**.
6370

64-
1. Select the desired port and click **Connect**.
71+
![Authorise USB connection](img/Authorise-USB-connection.png)
72+
73+
1. A **ChromeOS** window should appear. Select the desired port and click **Connect**.
74+
75+
![ChromeOS window](img/usbpromptchrome.png)
76+
77+
## Troubleshooting
78+
79+
* Make sure your device is connected using a functional data USB cable and that one or more LEDs on the board are lit.
80+
* Even if no board is detected, try clicking the Upload button to open the **Authorise USB connection** prompt.
81+
* Make sure you’re using the [Arduino Cloud for Chromebook](https://play.google.com/store/apps/details?id=cc.arduino.create_editor) app, **not** the Arduino Create for Education Chrome app.
82+
* Verify that the board is [compatible](https://support.arduino.cc/hc/en-us/articles/360014779899-Boards-compatible-with-the-Web-Editor).
83+
* If you're using either **Nano RP2040 Connect** or **UNO WiFi Rev2**, please follow the special [setup instructions](https://support.arduino.cc/hc/en-us/articles/360014779899-Boards-compatible-with-the-Cloud-Editor#chromebook) for those boards.
84+
* Ensure that the board is not [counterfeit](https://support.arduino.cc/hc/en-us/articles/360020652100-How-to-spot-a-counterfeit-Arduino).
85+
86+
---
6587

6688
Learn more about the Cloud Editor:
6789

Loading
Loading
Loading
Loading
Loading

content/Arduino Cloud/Arduino IoT Cloud/Configure-your-network-for-Arduino-Cloud.md

+26-2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,15 @@ title: "Configure your network for Arduino Cloud"
33
id: 360017279260
44
---
55

6+
Learn the network requirements for Arduino Cloud.
7+
8+
---
9+
10+
## TCP and UDP ports used by Arduino Cloud
11+
12+
> [!NOTE]
13+
> A home network with a default configuration will usually not prevent any Arduino Cloud connections. You do not need to add any of the configurations above unless you're experiencing problems or will be using the service on a restricted network.
14+
615
The Arduino Cloud uses the following domains and ports, which need to be whitelisted in your firewall.
716

817
| Domain | Port |
@@ -13,5 +22,20 @@ The Arduino Cloud uses the following domains and ports, which need to be whiteli
1322

1423
You will also need to allow NTP access on port 123 UDP for `time.arduino.cc`.
1524

16-
> [!NOTE]
17-
> A home network with a default configuration will usually not prevent any Arduino Cloud connections. You do not need to add any of the configurations above unless you're experiencing problems, or will be using the service on a restricted network.
25+
---
26+
27+
## Using Arduino Cloud on school networks
28+
29+
Internet access in Schools can vary depending on the end user, device type, and the Wi-Fi network type you have installed in schools. Most schools today are switching to using a WEP2-Enterprise network as a safe and secure way to access the internet for students, teachers, and other staff.
30+
31+
Setting up Arduino to access the internet via the school network can be challenging. This guide aims to walk you through the steps to connect your Arduino board to the school network and access our IoT features.
32+
33+
The WPA2 (Enterprise) RADIUS combination affords networks the highest level of cybersecurity, especially when X.509 digital certificates are used for authentication. WPA2 Enterprise requires an 802.1X authentication server anyway, so it's only logical to implement the best possible authentication security during configuration. However, WPA2 - Enterprise **doesn't work with Arduino Devices**.
34+
35+
**Try this if you're having issues using Arduino Cloud on a school network:**
36+
37+
* Find out the type of Wi-Fi network implemented on your school premises. If you are using any sort of WEP/WEP2 personal networks in your school besides the main network that essentially only requires an SSID (the name of the Wi-Fi connection) and password, you are good to go.
38+
39+
* Reach out to your school administrator and recommend creating a subnetwork specifically for connecting your Arduino devices using WEP/WEP2. This network would have limited access and can only be used for IoT purposes.
40+
41+
* If you don't have access to or can't create a separate WEP/WEP2 network, you can create a hotspot using your mobile device and try to connect your devices to it. Keep in mind that this solution is temporary and restrictive, primarily suitable for testing purposes. It's not intended for prolonged deployment.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: "If the sketch uploads but the device isn’t online"
3+
id: 13459093156764
4+
---
5+
6+
> [!NOTE]
7+
> Device status is not supported by the LoRa protocol, see [About device status in Arduino Cloud](https://support.arduino.cc/hc/en-us/articles/4407169649682-About-device-status-in-IoT-Cloud).
8+
9+
1. Go to the [Devices tab](https://app.arduino.cc/devices) and verify that your device has an associated Thing. If not, you must either create and new Thing or associate an existing Thing with the device.
10+
11+
![A linked Thing in the Devices tab.](img/arduino-cloud-device-thing-example-offline.png)
12+
13+
2. Go to the [Things tab](https://app.arduino.cc/things) and open the Thing that's associated with your device. Then go to the [Devices tab](https://app.arduino.cc/devices), and find your device in the list. Under **Network**, click on **Change** and verify that your credentials are correct.
14+
15+
* **Wi-Fi:** Make sure the name (also called _SSID_) and password (also called _encryption key_ or just _key_) are correct. The password can be revealed by clicking the eye symbol. If you don't know your network name or password, contact your network administrator or the manufacturer of your Wi-Fi access point. If your device has a secret key, make sure it's entered correctly (if you're unsure, remove and re-add the device to generate a new key).
16+
* **Arduino SIM:** [Use these credentials](https://support.arduino.cc/hc/en-us/articles/360013825159). Make sure a working GSM antenna is connected to the board and that an Arduino SIM plan is activated with [your account](https://store.arduino.cc/digital/subscriptions/plans).
17+
18+
3. Open the Thing's **Sketch tab**. Make sure the right device is selected and re-upload the sketch.
19+
20+
![Uploading a sketch in Arduino Cloud.](img/iot-sketch-upload.png)
21+
22+
4. Fully [delete the device](https://support.arduino.cc/hc/en-us/articles/360018324700), then add it again as a new device. For detailed instructions, see [Add and connect a device to Arduino Cloud](https://support.arduino.cc/hc/en-us/articles/360016495559).
23+
24+
5. Test your setup with an example from the [ArduinoIoTCloud library](https://www.arduino.cc/reference/en/libraries/arduinoiotcloud/). Upload using Arduino IDE or the [Cloud Editor](https://create.arduino.cc/editor).
25+
26+
6. Check your device's power supply. Avoid using a USB hub, and instead connect the board directly to a USB port or another power source with a reliable cable to ensure sufficient power.

content/Arduino Cloud/Arduino IoT Cloud/If-your-device-cant-be-added-or-wont-connect-to-Arduino-Cloud.md

-149
This file was deleted.

0 commit comments

Comments
 (0)