Merge pull request #635 from arduino/mcmchris/opta-expansions/user-manual-section

[PC-1626] Opta Digital Expansion- Opta User Manual Section

Merging to Launch Branch

Author: jcarolinares

.github/actions/cloudflare-upload/action.yml

@@ -4,7 +4,7 @@ inputs:
   upload-dir:
     description: "The name of the app to build and export"
     required: true
-  
+
   project-name:
     description: "The name of the project to upload to"
     required: true
@@ -66,7 +66,7 @@ runs:
           ### ${{ inputs.project-name }}
           🚀 Preview this PR: ${{ steps.deploy-cloudflare.outputs.url }}
           📍 Commit SHA: ${{ github.sha }}
-          
+
 
     - name: Update PR Preview Comment
       if: github.event_name == 'pull_request' && steps.deploy-preview-comment.outputs.comment-id != 0

.github/workflows/cloudflare.yml

@@ -15,6 +15,8 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
       - uses: actions/setup-node@v3
         with:
           node-version: 18

.github/workflows/deploy-prd.yml

@@ -16,6 +16,8 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
       - uses: actions/setup-node@v3
         with:
           node-version: 18

.github/workflows/deploy-stg.yml

@@ -15,6 +15,9 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - run: git log -1 --pretty=format:%aI content/learn/04.electronics/05.servo-motors/servo-motors.md
       - uses: actions/setup-node@v3
         with:
           node-version: 18

content/arduino-cloud/01.guides/04.micropython/content.md

@@ -61,7 +61,7 @@ Next step is to create some Cloud variables, which we will later interact with v
 1. While in Thing configuration, click on **"Add Variable"** which will open a new window.
 2. Name your variable `led` and select it to be of an `boolean` type.
 3. Click on **"Add Variable"** at the bottom of the window.
-4. Create another variable, name it `ledSwitch` and select it to be `int` type.
+4. Create another variable, name it `ledSwitch` and select it to be `boolean` type.
 
 You should now have **two variables**:
 - `led` - boolean 
@@ -153,6 +153,8 @@ led = Pin("LEDB", Pin.OUT) # Configure the desired LED pin as an output.
 def on_switch_changed(client, value):
     # Toggles the hardware LED on or off.
     led.value(not value)
+    # Depending on the board you use you may need to use "led.value(value)" instead
+    # so that the LED's state reflects correctly the boolean value.
 
     # Sets the value of the Cloud variable "led" to the current state of the LED
     # and thus mirrors the hardware state in the Cloud.
@@ -223,4 +225,4 @@ If the code is not working, there are some common issues we can troubleshoot:
 
 ## Conclusion
 
-This tutorial has guided you through the process of connecting your Arduino device to the Arduino Cloud using MicroPython. You learned how to install the necessary library, set up your device, and control an LED via the Arduino Cloud. This opens up possibilities for more complex applications, as you can control and monitor your Arduino device remotely.
+This tutorial has guided you through the process of connecting your Arduino device to the Arduino Cloud using MicroPython. You learned how to install the necessary library, set up your device, and control an LED via the Arduino Cloud. This opens up possibilities for more complex applications, as you can control and monitor your Arduino device remotely.

content/arduino-cloud/02.hardware/00.cloud-agent/assets/board-connected.png

@@ -0,0 +1,33 @@
+---
+title: Cloud Agent
+description: The Cloud Agent allows Arduino boards to interface with the Arduino Cloud.
+tags: [Arduino Cloud, Cloud Agent, Cloud Editor]
+author: Karl Söderby
+---
+
+The [Arduino Cloud Agent](https://create.arduino.cc/getting-started/plugin/welcome) is a plugin that you install on your computer, that enables serial communication between your board and the Arduino Cloud. This allows you to upload sketches, and read/write serial data to/from your board, via your web browser.
+
+The Cloud Agent is a requirement to program your devices in the Arduino Cloud, and takes only a minute to install.
+
+## Installation
+
+When you configure a device or use the Cloud Editor, you will automatically receive a prompt to install the Cloud Agent. 
+
+You can also access the download page through [this link](https://create.arduino.cc/getting-started/plugin/welcome). It should look like this:
+
+![Download Cloud Agent.](assets/install-agent.png)
+
+Follow the installation guide in the page, where you will download an installation file. To install it, run the file and follow the instructions for your operating system.
+
+Once installed, you can navigate back to the Cloud Editor, and you should be able to recognize the board connected to your computer.
+
+![Board connected to computer.](assets/board-connected.png)
+
+## Source Code
+
+The source code for the Cloud Agent lives [in this GitHub repository](https://github.com/arduino/arduino-create-agent). To report issues or improvements, please do so inside in this repository.
+
+## Troubleshooting
+
+If you are having issues with the Cloud Agent, you can visit the link below:
+- [Arduino Help Center - Create Agent](https://support.arduino.cc/hc/en-us/articles/360014869820-Install-the-Arduino-Create-Agent)

content/arduino-cloud/02.hardware/00.cloud-agent/assets/install-agent.png

@@ -34,12 +34,12 @@ $ npm install arduino-iot-js
 $ yarn add arduino-iot-js
 ```
 
-***Check out the [JavaScript Setup guide](/arduino-cloud/guides/javascript) for more information and a detailed step by step tutorial.***  
+***Check out the [JavaScript Setup guide](/arduino-cloud/guides/javascript) for more information and a detailed step by step tutorial.***
 
 ## Connection Methods
 
 There are three available methods for connection:
-- Using device credentials (recommended method). 
+- Using device credentials (recommended method).
 - Using an API key (generated and listed at [Arduino Cloud API keys](https://app.arduino.cc/app-keys)).
 - Using a [JWT token](https://jwt.io/)