Merge remote-tracking branch 'private/main' into marqdevx/opta/public-launch

Author: marqdevx

content/arduino-cloud/03.tutorials/iot-remote-phone-sensors/assets/dashboard.png

@@ -0,0 +1,173 @@
+---
+title: 'Use Sensor Data From Your Phone'
+description: 'Stream sensor data from your phone live to the Arduino IoT Cloud'
+tags:
+- Arduino IoT Cloud
+- Remote app
+- Mobile sensors
+- Android
+- iOS
+author: 'Jacob Hylén'
+---
+
+The Arduino IoT Cloud is a powerful platform that can help you with setting up your own IoT devices within minutes. 
+
+It is now possible to synchronize your phone's sensor data with the cloud, using the Arduino Remote App for [iOS](https://apps.apple.com/us/app/arduino-iot-cloud-remote/id1514358431) and [Android](https://play.google.com/store/apps/details?id=cc.arduino.cloudiot&hl=en&gl=US). Furthermore, this data can also be used to control your Arduino boards, such as mapping a value from a sensor on your phone to an actuator on your Arduino.
+
+Your smartphone is absolutely **packed** with sophisticated sensors that constantly measure everything from GPS position, to magnetic fields, acceleration, and so on. But they're difficult for a maker to take advantage of without having extensive knowledge of mobile development. 
+
+That is changed by the Arduino IoT Remote app - as you are able to, with the latest version of the app for [Android](https://play.google.com/store/apps/details?id=cc.arduino.cloudiot&hl=en&gl=US) and [iOS](https://apps.apple.com/us/app/arduino-iot-cloud-remote/id1514358431), set up a dashboard in the Arduino IoT Cloud that tracks and displays all your sensor data in a neat dashboard within a minute.
+
+The goal with this project is to learn about how you can use your smartphone as a remote, sending sensor data to the Arduino IoT Cloud. You'll also learn how this sensor data can be used by other Things in your Arduino Cloud account, essentially letting you control your IoT devices depending on your variables such as GPS position, compass orientation, or any of the other in the long list of variables the IoT Remote app can stream live to the cloud. 
+
+You will learn this by making a small project where a servo motor reacts to where you point your phone, as shown below.
+
+![Expected Outcome](assets/expected-outcome.gif)
+
+## Requirements
+To Follow along with this article, you will need the following:
+
+- An Android or iOS Smartphone/tablet
+- An [Arduino Cloud](https://cloud.arduino.cc/home/) Account
+- An Arduino IoT Cloud-compatible board (optional).
+- A Servo motor (optional). 
+
+## Phone Setup
+To start this process, you will need to download the Arduino IoT Cloud Remote app from either the [Google Play Store](https://play.google.com/store/apps/details?id=cc.arduino.cloudiot&hl=en&gl=US) or the[ Apple App store](https://apps.apple.com/us/app/arduino-iot-cloud-remote/id1514358431) depending on your device, if you don't already have it installed. If you do have it installed already you may need to update it, so take a quick look to make sure that you have the latest version downloaded.
+
+Once you have the app installed, open it and log into your [Arduino Cloud](https://cloud.arduino.cc/home/) account. At this point you should be presented with a list of all your previous dashboards if you have any. 
+
+![Dashboards](assets/dashboards.png)
+
+Tap the hamburger-menu in the top left of your screen, if you're using version 1.1 of the app or later you should have two options, press "**Use data from your phone**". 
+
+At this point, if you expand the section, you can see all the sensors that can be tracked in the Arduino IoT Cloud listed. You'll need to consent to the sensor data being sent to the Arduino IoT Cloud by checking the box, then you're ready to start the automated process of building the dashboard. Tap "**SET YOUR PHONE**" and sit back, relax, while the app takes care of everything else for you.
+
+Once done, check out all the sensor data in the dashboard. How neat is that?
+
+![Dashboard](assets/dashboard.png)
+
+Try manipulating your phone in different ways to see how the data reacts, move it around, bring magnets close, make sounds, try anything you can think of!
+
+## Use the Data
+Now that you've got your sensor data in the Arduino IoT Cloud, the next step is to use it for a project. As an example, let's sync the compass orientation of your phone to a variable controlling the angle of a servo motor.
+
+The mobile "**Thing**" can't be programmed, but you can sync the variables from it with variables in other "**Things**"
+
+So go to the [Arduino IoT Cloud](https://create.arduino.cc/iot/things) on your computer, and create a new **Thing**. 
+
+Grab your **Arduino IoT Cloud** compatible Arduino board and connect it to your computer, and configure it with your thing. I am using an **Arduino Nano 33 IoT**, and I am going with the suggested name for my device, which happens to be "**Robby**"
+
+You will also need to enter your network credentials at this stage.
+
+Now you can add a new variable in your **Thing**. When configuring this variable, you have the option to sync it to variables in other **Things**. This is very powerful and lets your devices talk to each other seamlessly, while still acting just like the variables you are familiar with in the code you're writing. 
+
+Name the variable something appropriate, "Compass" for example. Click the **"Sync with other Things"** button to open up the syncing menu, search for **"compass"** and make sure to tick the box of the compass variable tied to your mobile devices Thing. 
+
+![Variable syncing](assets/variablesync.png)
+
+When one of the variables are updated, the other one will sync to the same value. This means that if we refer to the Compass variable in the sketch of our Arduino Thing we can access the values from the mobile device. 
+
+Now that the input is figured out, let's move on to creating our sketch. If you want to skip the code explanation, the full sketch can be found at the bottom of this section. 
+
+At the very top of the sketch we want to do three things, the first one is to include the servo library, the second one is to initialise the servo library, and the third is to create a variable to hold a mapped value from the compass. The compass in your phone reports a value between 0-360, but because servo motors usually cannot rotate 360 degrees we need to make sure that the value we send to the servo is witing the acceptables ranges for the servo we're using. Most small servos can move within a 90 or 180 degree range.
+
+So start by including and initialising the servo library, and creating an empty integer variable at the top of your sketch.
+
+```arduino
+#include <Servo.h>
+
+Servo myServo;
+
+int mappedCompass;
+```
+
+Within `void setup()` we'll need select a pin for the servo motor. We'll also write it to a default starting position.
+
+Add the following code somwehere in the setup function:
+```
+  myServo.attach(2);
+  myServo.write(80);
+```
+
+In `void loop()` we need to remap the compass value like explained earlier, but once that is done all we need to do is to write the remapped value to the servo motor.
+
+Add the following code in the loop function:
+```
+  mappedCompass = map(compass, 0, 360, 0, 90);
+  
+  myServo.write(mappedCompass);
+```
+
+The full code can be found here:
+```
+/* 
+  Arduino IoT Cloud Variables description
+
+  The following variables are automatically generated and updated when changes are made to the Thing
+
+  float compass;
+
+  Variables which are marked as READ/WRITE in the Cloud Thing will also have functions
+  which are called when their values are changed from the Dashboard.
+  These functions are generated with the Thing and added at the end of this sketch.
+*/
+
+#include "thingProperties.h"
+#include <Servo.h>
+
+Servo myServo;
+
+int mappedCompass;
+
+void setup() {
+  // Initialize serial and wait for port to open:
+  Serial.begin(9600);
+  // This delay gives the chance to wait for a Serial Monitor without blocking if none is found
+  delay(1500); 
+  
+  myServo.attach(2);
+  myServo.write(80);
+
+  // Defined in thingProperties.h
+  initProperties();
+
+  // Connect to Arduino IoT Cloud
+  ArduinoCloud.begin(ArduinoIoTPreferredConnection);
+  
+  /*
+     The following function allows you to obtain more information
+     related to the state of network and IoT Cloud connection and errors
+     the higher number the more granular information you’ll get.
+     The default is 0 (only errors).
+     Maximum is 4
+ */
+  setDebugMessageLevel(2);
+  ArduinoCloud.printDebugInfo();
+}
+
+void loop() {
+  ArduinoCloud.update();
+  // Your code here 
+  mappedCompass = map(compass, 0, 360, 0, 90);
+  
+  myServo.write(mappedCompass);
+  
+}
+
+/*
+  Since Compass is READ_WRITE variable, onCompassChange() is
+  executed every time a new value is received from IoT Cloud.
+*/
+void onCompassChange()  {
+  // Add your code here to act upon Compass change
+}
+
+```
+
+Once the sketch is uploaded to your board, wait for it to connect to your network, then open the IoT Remote app on your phone and watch as the Servo reacts when you rotate your phone.
+
+## Conclusion
+With this tutorial, you have learned how to connect your android or iOS smartphone to the Arduino IoT Cloud and send all sorts of sensor data from your device, and how to integrate this sensor data with your other Arduino IoT Cloud Things.
+
+The small project done in this tutorial is just the tip of the iceberg, you could take what you learned here and apply it in other ways to create an endless amount of cool interactive IoT projects that take advantage of the sophisticated sensors you carry in your pocket every day. 

content/arduino-cloud/03.tutorials/iot-remote-phone-sensors/assets/dashboards.png

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-mkr1000-wifi
 url_guide: /software/ide-v1/tutorials/getting-started/cores/arduino-samd
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkr1000/137'
+certifications: [CE]
 status: end-of-life
 productCode: '017'
 ---

content/arduino-cloud/03.tutorials/iot-remote-phone-sensors/assets/expected-outcome.gif

@@ -4,6 +4,7 @@ url_guide: /software/ide-v1/tutorials/getting-started/cores/arduino-samd
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrgsm1400/146'
 status: end-of-life
+certifications: [CE]
 productCode: '021'
 ---
 

content/arduino-cloud/03.tutorials/iot-remote-phone-sensors/assets/variablesync.png

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-mkr-vidor-4000
 url_guide: /software/ide-v1/tutorials/getting-started/cores/arduino-samd
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrvidor4000/150'
+certifications: [CE]
 productCode: '024'
 ---
 

content/arduino-cloud/03.tutorials/iot-remote-phone-sensors/iot-remote-phone-sensors.md

@@ -4,6 +4,7 @@ url_shop: https://store.arduino.cc/arduino-mkr-wan-1300
 url_guide: /software/ide-v1/tutorials/getting-started/cores/arduino-samd
 core: arduino:samd
 forumCategorySlug: '/hardware/mkr-boards/mkrwan1310/161'
+certifications: [CE]
 productCode: '129'
 ---
 

content/hardware/01.mkr/01.boards/mkr-1000-wifi/certifications/Arduino_ABX00004-DoC_CE.pdf

@@ -2,6 +2,7 @@
 title: MKR 485 Shield
 url_shop: https://store.arduino.cc/arduino-mkr-485-shield
 url_guide: /tutorials/mkr-485-shield/mkr-485-communication
+certifications: [CE]
 ---
 
 The MKR 485 Shield makes it possible to communicate with legacy industrial systems that uses the RS-485 protocol. The shield is simply mounted on a MKR family board, easily turning your old local system into a modern IoT system.

content/hardware/01.mkr/01.boards/mkr-1000-wifi/certifications/Arduino_ABX00011-DoC_CE.pdf

@@ -2,6 +2,7 @@
 title: MKR CAN Shield
 url_shop: https://store.arduino.cc/arduino-mkr-can-shield
 url_guide: /tutorials/mkr-can-shield/mkr-can-communication
+certifications: [CE]
 ---
 
 The MKR CAN Shield is a great addon for MKR family boards, and allows you to connect to a CAN (Controller Area Network) bus, widely used in the automotive industry.

content/hardware/01.mkr/01.boards/mkr-1000-wifi/product.md

@@ -2,6 +2,7 @@
 title: MKR ENV Shield
 url_shop: https://store.arduino.cc/mkr-env-shield-r2
 url_guide: /tutorials/mkr-env-shield/mkr-env-shield-basic
+certifications: [CE]
 ---
 
 The MKR ENV Shield is a perfect addon for the MKR family series, and is capable of reading temperature, humidity, light and pressure. The data is acquired easily through an easy-to-use library, and has an SD card slot for offline data logging.

content/hardware/01.mkr/01.boards/mkr-gsm-1400/certifications/Arduino_ABX00018-DoC_CE.pdf

@@ -2,6 +2,7 @@
 title: MKR IMU Shield
 url_shop: https://store.arduino.cc/arduino-mkr-imu-shield
 url_guide: /tutorials/mkr-imu-shield/mkr-imu-shield-basics
+certifications: [CE]
 ---
 
 The MKR IMU Shield helps you integrate inertial measurements with your projects. Read three-dimensional acceleration, yaw rate and magnetical field by simply mounting it on top of a MKR family board.

content/hardware/01.mkr/01.boards/mkr-gsm-1400/product.md

@@ -2,6 +2,7 @@
 title: MKR MEM Shield
 url_shop: https://store.arduino.cc/arduino-mkr-mem-shield
 url_guide: /tutorials/mkr-mem-shield/mkr-mem-shield-data-logger
+certifications: [CE]
 ---
 
 Add extra flash memory (2MB) and store larger files on a Micro SD card with the MKR MEM Shield. As a bonus, the shield has a prototyping area, for adding e.g. smaller displays, sensors, actuators and more. Compatible with all MKR family boards.

content/hardware/01.mkr/01.boards/mkr-vidor-4000/certifications/Arduino_ABX00022-DoC_CE.pdf

@@ -2,6 +2,7 @@
 title: MKR Relay Shield
 url_shop: https://store.arduino.cc/arduino-mkr-relay-proto-shield
 url_guide: /tutorials/mkr-relay-proto-shield/mkr-relay-shield-basic
+certifications: [CE]
 ---
 
 The MKR Relay Shield has two relays mounted that can be used for loads up to 24V. It also features two status LEDs and a prototyping area for adding your own components.

content/hardware/01.mkr/01.boards/mkr-vidor-4000/product.md

@@ -2,6 +2,7 @@
 title: MKR Therm Shield
 url_shop: https://store.arduino.cc/arduino-mkr-therm-shield
 url_guide: /tutorials/mkr-therm-shield/mkr-therm-shield-basic
+certifications: [CE]
 ---
 
 The MKR Therm Shield is a great addon for MKR family boards, and allows you to connect high quality thermocouplers, and can calculate temperatures from -200°C to +700°C. An ideal solution to use for ovens, freezers, smokers and similar environments.

content/hardware/01.mkr/01.boards/mkr-wan-1300/certifications/Arduino_ABX00017-DoC_CE.pdf

@@ -2,6 +2,7 @@
 title: MKR Connector Carrier
 url_shop: https://store.arduino.cc/arduino-mkr-connector-carrier
 url_guide: /tutorials/mkr-connector-carrier/connector-basics
+certifications: [CE]
 ---
 
 The MKR Connector Carrier is a really useful extension for MKR family boards. It features 14 grove compatible connectors, which allows you to choose between hundreds of different sensors and actuators for your project.     

content/hardware/01.mkr/01.boards/mkr-wan-1300/product.md

@@ -0,0 +1,14 @@
+software: ~
+hardware:
+  shields: ~
+  carriers: ~
+  boards:
+    - mkr-zero
+    - mkr-1000-wifi
+    - mkr-wifi-1010
+    - mkr-fox-1200
+    - mkr-wan-1300
+    - mkr-wan-1310
+    - mkr-gsm-1400
+    - mkr-nb-1500
+    - mkr-vidor-4000

content/hardware/01.mkr/02.shields/mkr-485-shield/certifications/Arduino_ASX00004-DoC_CE.pdf

@@ -0,0 +1 @@
+../../../mkr-iot-carrier/datasheet/assets/Pinout.png

content/hardware/01.mkr/02.shields/mkr-485-shield/product.md

@@ -0,0 +1 @@
+../../../mkr-iot-carrier/datasheet/assets/Power_Tree_MKR_IoT_Carrier.png