From ea36c1215ea69b5785c5d53ada3e76f79a05c7c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Karl=20S=C3=B6derby?= <35461661+karlsoderby@users.noreply.github.com> Date: Wed, 9 Mar 2022 13:48:32 +0100 Subject: [PATCH 1/2] update cloud compatible boards --- .../iot-cloud-getting-started.md | 6 ++- .../iot-cloud-tech-ref.md | 49 +++++++++++-------- .../06.device-to-device/device-to-device.md | 4 +- .../10.webhooks/iot-cloud-webhooks.md | 2 +- 4 files changed, 35 insertions(+), 26 deletions(-) diff --git a/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md b/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md index 52cfc047a5..1dfaa932ee 100644 --- a/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md +++ b/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md @@ -43,7 +43,7 @@ Below is a list of Arduino IoT Cloud features. ## Compatible Hardware -To use the Arduino IoT Cloud, we need a **cloud compatible board**. You can choose between using an official Arduino board, or a board based on the ESP32 / ESP8266 microcontroller. The Arduino IoT Cloud currently supports connection via Wi-Fi, LoRaWAN (via The Things Network) and mobile networks. +To use the Arduino IoT Cloud, a **cloud compatible board** is required. You can choose between using an official Arduino board, or a board based on the ESP32 / ESP8266 microcontroller. The Arduino IoT Cloud currently supports connection via Wi-Fi, LoRaWAN® (via The Things Network) and mobile networks. ***All cloud-compatible Arduino boards come with a hardware secure element (such as the [ECC508](/resources/datasheets/ATECC508A-datasheet.pdf) cryptochip), where you can store your security keys.*** @@ -56,6 +56,8 @@ The following boards connect to the Arduino IoT Cloud via Wi-Fi. - [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect) - [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot) - [Portenta H7](https://store.arduino.cc/portenta-h7) +- [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected) +- [Nicla Vision](https://store.arduino.cc/products/nicla-vision) Connection via Wi-Fi is an easy alternative, and your credentials can safely be entered during the configuration of a project. This type of connection is most suitable for low-range projects, where you connect your board to the cloud via your home/work/school router. @@ -66,7 +68,7 @@ The following boards connect to the Arduino IoT Cloud via [The Things Stack](htt - [MKR WAN 1300](https://store.arduino.cc/arduino-mkr-wan-1300-lora-connectivity-1414) - [MKR WAN 1310](https://store.arduino.cc/mkr-wan-1310) -Connection via LoRaWAN is recommended for low-power projects in both remote and urban areas, where Wi-Fi or other popular connectivity types are not available. The MKR WAN 1300/1310 boards are equipped with a LoRa radio module and has a slot for an antenna. With the right low-power configuration, the board can send data to the cloud for months on a single battery. +Connection via LoRaWAN® is recommended for low-power projects in both remote and urban areas, where Wi-Fi or other popular connectivity types are not available. The MKR WAN 1300/1310 boards are equipped with a LoRa radio module and has a slot for an antenna. With the right low-power configuration, the board can send data to the cloud for months on a single battery. ***To learn more about setting up LoRaWAN® devices, visit the [Configuring LoRaWAN® devices in the Arduino Cloud](/cloud/iot-cloud/tutorials/cloud-lora-getting-started) guide.*** diff --git a/content/cloud/iot-cloud/tutorials/02.technical-reference/iot-cloud-tech-ref.md b/content/cloud/iot-cloud/tutorials/02.technical-reference/iot-cloud-tech-ref.md index 4a569b7494..6de0ccce1f 100644 --- a/content/cloud/iot-cloud/tutorials/02.technical-reference/iot-cloud-tech-ref.md +++ b/content/cloud/iot-cloud/tutorials/02.technical-reference/iot-cloud-tech-ref.md @@ -9,48 +9,55 @@ author: 'Liam Aljundi' This article summarizes the use of the Arduino Cloud IoT, and includes information regarding requirements, installation, API and general usage of the platform. -## Hardware Compatibility +## Compatible Hardware -The Arduino IoT Cloud's compatible boards can be either an **official Arduino board**, or a board based on the **ESP32/ESP8266 microcontroller**. +To use the Arduino IoT Cloud, a **cloud compatible board** is required. You can choose between using an official Arduino board, or a board based on the ESP32 / ESP8266 microcontroller. The Arduino IoT Cloud currently supports connection via Wi-Fi, LoRaWAN® (via The Things Network) and mobile networks. -### Arduino Boards +***All cloud-compatible Arduino boards come with a hardware secure element (such as the [ECC508](/resources/datasheets/ATECC508A-datasheet.pdf) cryptochip), where you can store your security keys.*** -All official Arduino boards that are compatible with the Arduino Cloud are listed in the image below. +### Wi-Fi -![Compatible IoT Cloud boards.](./images/iot-cloud-compatible-boards.png) +The following boards connect to the Arduino IoT Cloud via Wi-Fi. - [MKR 1000 WiFi](https://store.arduino.cc/arduino-mkr1000-wifi) - [MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010) -- [MKR WAN 1300](https://store.arduino.cc/arduino-mkr-wan-1300-lora-connectivity-1414) -- [MKR WAN 1310](https://store.arduino.cc/mkr-wan-1310) -- [MKR GSM 1400](https://store.arduino.cc/arduino-mkr-gsm-1400)\* -- [MKR NB 1500](https://store.arduino.cc/arduino-mkr-nb-1500-1413)\* - [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect) - [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot) - [Portenta H7](https://store.arduino.cc/portenta-h7) +- [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected) +- [Nicla Vision](https://store.arduino.cc/products/nicla-vision) -***\* Please note: The MKR GSM 1400 and MKR NB 1500 require a SIM card to connect to the cloud, as they communicate over mobile networks.*** +Connection via Wi-Fi is an easy alternative, and your credentials can safely be entered during the configuration of a project. This type of connection is most suitable for low-range projects, where you connect your board to the cloud via your home/work/school router. -### Third Party Boards +### LoRaWAN® -The Arduino IoT Cloud supports a wide range of third party boards based on the ESP32 and ESP8266 microcontrollers with support for Wi-Fi. To set them up, the **third party option** can be simply chosen in the device setup. +The following boards connect to the Arduino IoT Cloud via [The Things Stack](https://www.thethingsindustries.com/stack/), a LoRaWAN® Network Server connected to thousands of public LoRa® gateways. -***The official Arduino boards are equipped with a Secure Element chip which provides an additional layer of security, protecting the communication between the board and the cloud with public-key cryptography.*** +- [MKR WAN 1300](https://store.arduino.cc/arduino-mkr-wan-1300-lora-connectivity-1414) +- [MKR WAN 1310](https://store.arduino.cc/mkr-wan-1310) -You can read more about setting up ESP32/8266 boards in the tutorial listed below: +Connection via LoRaWAN® is recommended for low-power projects in both remote and urban areas, where Wi-Fi or other popular connectivity types are not available. The MKR WAN 1300/1310 boards are equipped with a LoRa radio module and has a slot for an antenna. With the right low-power configuration, the board can send data to the cloud for months on a single battery. -- [Connecting ESP32 & ESP8266 to Arduino Cloud IoT](/cloud/iot-cloud/tutorials/esp-32-cloud) +***To learn more about setting up LoRaWAN® devices, visit the [Configuring LoRaWAN® devices in the Arduino Cloud](/cloud/iot-cloud/tutorials/cloud-lora-getting-started) guide.*** -### LoRaWAN® +### GSM / NB-IoT Boards -You can easily set up your Arduino LoRaWAN® devices in the Arduino Cloud IoT platform, which is interfaced with the [The Things Stack](https://www.thethingsindustries.com/stack/). Currently, the following boards are supported: +The MKR GSM 1400 and MKR NB 1500 require a **SIM card** to connect to the cloud, as they communicate over the mobile networks. -- [MKR WAN 1300](https://store.arduino.cc/arduino-mkr-wan-1300-lora-connectivity-1414) -- [MKR WAN 1310](https://store.arduino.cc/mkr-wan-1310) +- [MKR GSM 1400](https://store.arduino.cc/arduino-mkr-gsm-1400) +- [MKR NB 1500](https://store.arduino.cc/arduino-mkr-nb-1500-1413) + +Connection through mobile networks can be considered in remote areas where there's no Wi-Fi, or in mobile projects (such as cargo tracking). + +***For more information, visit the [Arduino SIM page](https://store.arduino.cc/digital/sim).*** + +### ESP32 / ESP8266 + +The Arduino IoT Cloud supports a wide range of third party boards based on the ESP32 and ESP8266 microcontrollers with support for Wi-Fi. To set them up, simply choose the **third party option** in the device setup. -A complete guide to setting up your LoRaWAN® devices is found in the link below: +![Configuring third party boards.](assets/3rd-party-support.png) -- [Configuring LoRaWAN® devices in the Arduino Cloud](https://docs.arduino.cc/cloud/iot-cloud/tutorials/cloud-lora-getting-started) +***To learn more about ESP32/ESP8266 support and how to set it up, visit the [Connecting ESP32 & ESP8266 to Arduino Cloud IoT](/cloud/iot-cloud/tutorials/esp-32-cloud) guide.*** ## Software Requirements diff --git a/content/cloud/iot-cloud/tutorials/06.device-to-device/device-to-device.md b/content/cloud/iot-cloud/tutorials/06.device-to-device/device-to-device.md index e700489b08..a0ab0bb6de 100644 --- a/content/cloud/iot-cloud/tutorials/06.device-to-device/device-to-device.md +++ b/content/cloud/iot-cloud/tutorials/06.device-to-device/device-to-device.md @@ -31,7 +31,7 @@ The goals of this project are: - 2x [Arduino Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect-with-headers). - Micro USB cable. ->**Note:** It is not required to have two devices of the same type. You can for example use a Nano RP2040 Connect and a MKR WiFi 1010. Any IoT Cloud enabled Wi-Fi board will work with this tutorial. +***Note: It is not required to have two devices of the same type. You can for example use a Nano RP2040 Connect and a MKR WiFi 1010. Any [IoT Cloud enabled Wi-Fi board](/cloud/iot-cloud/tutorials/iot-cloud-getting-started#compatible-hardware) will work with this tutorial.*** We will also need the following components for the circuit: @@ -45,7 +45,7 @@ We will also need the following components for the circuit: Follow the circuit below to connect the buttons and LEDs to your Arduino board. ->**Note:** Remember that the pinouts are different on a Nano board. The circuit below is for a MKR WiFi 1000/1010 board. +***Note that the pinouts are different on a Nano board. The circuit below is for a MKR WiFi 1000/1010 board.*** ![Two identical circuits with 1x button and 1x LED each.](assets/device-to-device-img-01.png) diff --git a/content/cloud/iot-cloud/tutorials/10.webhooks/iot-cloud-webhooks.md b/content/cloud/iot-cloud/tutorials/10.webhooks/iot-cloud-webhooks.md index 6d220e33d7..16330e44b7 100644 --- a/content/cloud/iot-cloud/tutorials/10.webhooks/iot-cloud-webhooks.md +++ b/content/cloud/iot-cloud/tutorials/10.webhooks/iot-cloud-webhooks.md @@ -37,7 +37,7 @@ You will also need a cloud compatible board: - [Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot) - [Portenta H7](https://store.arduino.cc/portenta-h7) -***\* Please note: The MKR GSM 1400 and MKR NB 1500 require a SIM card to connect to the cloud, as they communicate over mobile networks.*** +***Please note: The MKR GSM 1400 and MKR NB 1500 require a SIM card to connect to the cloud, as they communicate over mobile networks.*** ## Webhook Setup From 173d74d594ae8996aa8bdd312614bdf61bfe04e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Karl=20S=C3=B6derby?= <35461661+karlsoderby@users.noreply.github.com> Date: Wed, 9 Mar 2022 14:54:26 +0100 Subject: [PATCH 2/2] Update iot-cloud-getting-started.md --- .../01.iot-cloud-getting-started/iot-cloud-getting-started.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md b/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md index 1dfaa932ee..8e9209fa99 100644 --- a/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md +++ b/content/cloud/iot-cloud/tutorials/01.iot-cloud-getting-started/iot-cloud-getting-started.md @@ -59,6 +59,7 @@ The following boards connect to the Arduino IoT Cloud via Wi-Fi. - [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected) - [Nicla Vision](https://store.arduino.cc/products/nicla-vision) + Connection via Wi-Fi is an easy alternative, and your credentials can safely be entered during the configuration of a project. This type of connection is most suitable for low-range projects, where you connect your board to the cloud via your home/work/school router. ### LoRaWAN®