[TC-407][TC-406] Integrate Julian's X8 Updates

.github/workflows/deploy-prd.yml

@@ -22,6 +22,17 @@ jobs:
           cache: "npm"
           cache-dependency-path: "**/package-lock.json"
 
+      - name: Render Datasheets
+        run: cd ${GITHUB_WORKSPACE}/scripts/datasheet-rendering;./render-datasheets.sh
+
+      - name: Copy Static Files
+        run: | 
+          mkdir -p static/resources/datasheets static/resources/schematics static/resources/pinouts
+          find ./content/hardware -type f -name "*-schematics.pdf" -exec cp {} ./static/resources/schematics/ \;
+          find ./content/hardware -type f -name "*-datasheet.pdf" -exec cp {} ./static/resources/datasheets/ \;
+          find ./content/hardware -type f -name "*-full-pinout.pdf" -exec cp {} ./static/resources/pinouts/ \;
+          find ./content/hardware -type f -name "*-pinout.png" -exec cp {} ./static/resources/pinouts/ \;
+
       - name: Gatsby main cache
         uses: actions/cache@v2
         id: gatsby-cache-folder
@@ -41,8 +52,7 @@ jobs:
             ${{ runner.os }}-public-gatsby-
 
       - run: npm install
-
-      - run: GENERATE_DATASHEETS=true npm run build
+      - run: npm run build
 
       - name: Configure AWS Credentials
         uses: aws-actions/configure-aws-credentials@v1

.github/workflows/deploy-stg.yml

@@ -20,6 +20,17 @@ jobs:
           node-version: 14
           cache: "npm"
           cache-dependency-path: "**/package-lock.json"
+
+      - name: Render Datasheets
+        run: cd ${GITHUB_WORKSPACE}/scripts/datasheet-rendering;./render-datasheets.sh
+
+      - name: Copy Static Files
+        run: | 
+          mkdir -p static/resources/datasheets static/resources/schematics static/resources/pinouts
+          find ./content/hardware -type f -name "*-schematics.pdf" -exec cp {} ./static/resources/schematics/ \;
+          find ./content/hardware -type f -name "*-datasheet.pdf" -exec cp {} ./static/resources/datasheets/ \;
+          find ./content/hardware -type f -name "*-full-pinout.pdf" -exec cp {} ./static/resources/pinouts/ \;
+          find ./content/hardware -type f -name "*-pinout.png" -exec cp {} ./static/resources/pinouts/ \;
 
       - name: Gatsby main cache
         uses: actions/cache@v2
@@ -40,8 +51,7 @@ jobs:
             ${{ runner.os }}-public-gatsby-
 
       - run: npm install
-
-      - run: GENERATE_DATASHEETS=true npm run build
+      - run: npm run build
 
       - name: Configure AWS Credentials
         uses: aws-actions/configure-aws-credentials@v1

.vscode/tasks.json

@@ -87,7 +87,7 @@
                 "cwd": "${workspaceFolder}${pathSeparator}scripts${pathSeparator}validation"
             },
             "windows": {
-                "command": "node .\\fix-issues.js -p ..\\..\\content\\hardware\\"               
+                "command": "node .\\fix-issues.js -p '..\\..\\content\\hardware\\'"
             },
             "group": "none",
             "presentation": {
@@ -97,14 +97,14 @@
             "problemMatcher": []
         },
         {
-            "label": "Generate all datasheets",
+            "label": "Render all datasheets",
             "type": "shell",
-            "command": "./generate-datasheets.sh",
+            "command": "./render-datasheets.sh",
             "options": {
-                "cwd": "${workspaceFolder}${pathSeparator}scripts${pathSeparator}datasheet-generator"
+                "cwd": "${workspaceFolder}${pathSeparator}scripts${pathSeparator}datasheet-rendering"
             },
             "windows": {
-                "command": ".\\generate-datasheets.cmd"                
+                "command": ".\\render-datasheets.cmd"                
             },
             "group": "none",
             "presentation": {
@@ -114,14 +114,14 @@
             "problemMatcher": []
         },
         {
-            "label": "Generate datasheet (current document)",
+            "label": "Render datasheet (current document)",
             "type": "shell",
-            "command": "./generate-datasheets.sh '../../${relativeFileDirname}'",
+            "command": "./render-datasheets.sh '../../${relativeFileDirname}'",
             "options": {
-                "cwd": "${workspaceFolder}${pathSeparator}scripts${pathSeparator}datasheet-generator"
+                "cwd": "${workspaceFolder}${pathSeparator}scripts${pathSeparator}datasheet-rendering"
             },
             "windows": {
-                "command": ".\\generate-datasheets.cmd '..\\..\\${relativeFileDirname}'"                
+                "command": ".\\render-datasheets.cmd '..\\..\\${relativeFileDirname}'"                
             },
             "group": "none",
             "presentation": {
@@ -138,7 +138,7 @@
                 "cwd": "${workspaceFolder}"
             },
             "windows": {
-                "command": ".\\scripts\\spell-check.cmd"                
+                "command": ".\\scripts\\spell-check.cmd"
             },
             "group": "none",
             "presentation": {
@@ -163,6 +163,9 @@
             "options": {
                 "cwd": "${workspaceFolder}"
             },
+            "windows": {
+                "command": ".\\scripts\\spell-check-fix.cmd"
+            },
             "group": "none",
             "presentation": {
                 "reveal": "always",

README.md

@@ -83,7 +83,9 @@ symbolic link created for AnalogInput <<===>> ..\..\..\..\..\built-in-examples\0
 ### Including Code Snippets
 
 Code snippets can be included by using the triple backticks syntax e.g. ` ```arduino` followed by the code and three closing backticks. The following syntaxes are supported:
+```
 arduino, bash, markup, clike, c, cpp, css, css-extras, javascript, jsx, js-extras, coffeescript, diff, git, go, graphql, handlebars, json, less, makefile, markdown, objectivec, ocaml, python, reason, sass, scss, sql, stylus, tsx, typescript, wasm, yaml
+```
 
 
 ## Previewing Changes

content/arduino-cloud/01.getting-started/01.iot-cloud-getting-started/iot-cloud-getting-started.md

@@ -59,8 +59,11 @@ The following boards connect to the Arduino IoT Cloud via Wi-Fi.
 - [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)
+- [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control)
 - [Nicla Vision](https://store.arduino.cc/products/nicla-vision)
+- [Opta](https://docs.arduino.cc/hardware/opta).\* 
 
+\* The Opta is scheduled to be released soon, along with documentation how to use it. Read more at the [Opta communications page](https://store.arduino.cc/pages/opta).
 
 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.
 
@@ -98,9 +101,13 @@ The Arduino IoT Cloud supports a wide range of third party boards based on the E
 
 ### Ethernet
 
-The Arduino IoT Cloud supports connection via Ethernet on a number of devices.
+The Arduino IoT Cloud supports connection via Ethernet on a number of devices. The options to connect via Ethernet are the following:
+- Connect with the [Portenta H7](https://store.arduino.cc/products/portenta-h7) in combination with an Ethernet compatible carrier/shield (see below).
+- Connect with the [Opta](https://docs.arduino.cc/hardware/opta).\* 
 
-To connect via Ethernet, you need a [Portenta H7](https://store.arduino.cc/products/portenta-h7) board, in combination with one of the following shields/carriers:
+\* The Opta is scheduled to be released soon, along with documentation how to use it. Read more at the [Opta communications page](https://store.arduino.cc/pages/opta).
+
+To connect with the **Portenta H7** board, you will need one of the following shields/carriers:
 - [Portenta Vision Shield Ethernet](https://store.arduino.cc/products/arduino-portenta-vision-shield-ethernet)
 - [Portenta Machine Control](https://store.arduino.cc/portenta-machine-control)
 

content/arduino-cloud/01.getting-started/02.technical-reference/iot-cloud-tech-ref.md

@@ -358,7 +358,7 @@ We provide two Arduino Iot Cloud APIs:
 
  The Arduino IoT Cloud REST API can be called just with any **HTTP Client**, or using one of these clients:
   - [Javascript NPM package](https://www.npmjs.com/package/@arduino/arduino-iot-client).
-  - [Python PYPI Package](https://pypi.org/project/arduino-iot-client/).
+  - [Python® PYPI Package](https://pypi.org/project/arduino-iot-client/).
   - [Golang Module](https://github.com/arduino/iot-client-go).
 
 **2.** The second is the **Data API (MQTT)** which allows you to send/receive Variables' data. An example of this API's use is sending IoT Cloud Variables' updates to the browser. A full [documentation of the Arduino IoT Cloud Data API (MQTT)](https://www.npmjs.com/package/arduino-iot-js) is available for advanced users.

content/arduino-cloud/01.getting-started/06.cloud-variables/cloud-variables.md

@@ -491,6 +491,24 @@ void onTvChange() {
 
 ```
 
+## Alexa Variables
+
+The integration between Alexa & Arduino IoT Cloud supports a limited amount of variables, see the list below:
+
+- [Colored Light](#coloredlight) - `bool` and `float` (complex type).
+- [Dimmed Light](#dimmedlight) - `bool` and `float` (complex type).
+- [Television](#television) - `bool` and `int` (complex type)
+- [Contact Sensor](#specialized-types) - `bool`
+- [Light](#specialized-types) - `bool`
+- [Motion Sensor](#specialized-types) - `bool`
+- [Smart Plug](#specialized-types) - `bool`
+- [Switch](#specialized-types) - `bool`
+- [Temperature Sensor](#specialized-types) - `float`
+
+Other variables used will not appear in the Amazon Alexa app.
+
+***To synchronize your Arduino Cloud with the Amazon Alexa service, you can check out the [Arduino Cloud Alexa Tutorial](/arduino-cloud/tutorials/alexa-mkr-rgb-shield).***
+
 ## Summary
 
 In this article, we have covered how to use variables in the Arduino IoT Cloud, and what variables are available.

content/arduino-cloud/01.getting-started/08.arduino-iot-api/arduino-iot-api.md

@@ -1,17 +1,17 @@
 ---
 title: 'Arduino Cloud REST API & SDK'
 difficulty: advanced
-description: 'Learn how to authenticate with the Arduino IoT Cloud REST API to make requests using HTTP Client, JavaScript and Python.'
+description: 'Learn how to authenticate with the Arduino IoT Cloud REST API to make requests using HTTP Client, JavaScript and Python®.'
 tags:
   - IoT Cloud REST API
   - JavaScript
-  - Python
+  - Python®
   - node.js
   - Golang
 author: 'Karl Söderby'
 ---
 
-The [Arduino IoT Cloud REST API](https://www.arduino.cc/reference/en/iot/api/) can be accessed through a set of endpoints to manage **Devices, Things, Properties** and more. It can be accessed via any HTTP client, and is supported by JavaScript, Python and Golang clients.
+The [Arduino IoT Cloud REST API](https://www.arduino.cc/reference/en/iot/api/) can be accessed through a set of endpoints to manage **Devices, Things, Properties** and more. It can be accessed via any HTTP client, and is supported by JavaScript, Python® and Golang clients.
 
 In this article you will find some useful examples to get started with the Arduino IoT Cloud API, and an understanding of what the API offers.
 
@@ -25,14 +25,14 @@ To see the full API, follow the link below:
 To connect with the Arduino Cloud API, we will need one of the following clients:
 
 - [Javascript NPM package](https://www.npmjs.com/package/@arduino/arduino-iot-client)
-- [Python PYPI Package](https://pypi.org/project/arduino-iot-client/)
+- [Python® PYPI Package](https://pypi.org/project/arduino-iot-client/)
 - [Golang Module](https://github.com/arduino/iot-client-go)
 
 ***You can also use services such as [Postman](https://www.postman.com/) to create HTTP requests.***
 
 ## Usage
 
-With the Arduino Cloud API, you are able to interface with the Arduino Cloud service through JavaScript, Python and Golang.
+With the Arduino Cloud API, you are able to interface with the Arduino Cloud service through JavaScript, Python® and Golang.
 
 You can for example write custom scripts that can: 
 
@@ -203,12 +203,12 @@ console.log(data[0].last_value);
 
 This is one of many examples of how to interact with the API. Now that you are setup, you can go on to explore the rest of the [Arduino IoT Cloud API](https://www.arduino.cc/reference/en/iot/api/).
 
-## Python
+## Python®
 
 **Requirements:**
 
-- [Python 3.7+](https://www.python.org/downloads/)
-- [arduino-iot-client](https://pypi.org/project/arduino-iot-client/) (python)
+- [Python® 3.7+](https://www.python.org/downloads/)
+- [arduino-iot-client](https://pypi.org/project/arduino-iot-client/) (Python®)
 
 To install, use the following command:
 
@@ -395,5 +395,5 @@ See the full example on [GitHub](https://github.com/arduino/iot-client-go/tree/m
 
 ## Summary
 
-This document covers the overall usage of the [Arduino IoT Cloud API](https://www.arduino.cc/reference/en/iot/api/), and how to use it with different clients (JavaScript, Python, Golang).
+This document covers the overall usage of the [Arduino IoT Cloud API](https://www.arduino.cc/reference/en/iot/api/), and how to use it with different clients (JavaScript, Python®, Golang).
 

content/arduino-cloud/02.features/04.ota-getting-started/ota-getting-started.md

@@ -28,6 +28,8 @@ Below is a list of all boards that supports OTA through the Arduino Cloud.
 - [Arduino Nano 33 IoT](https://store.arduino.cc/arduino-nano-33-iot)
 - [Arduino Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect-with-headers)
 - [Portenta H7](https://store.arduino.cc/portenta-h7)
+- [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control)
+- [Nicla Vision](https://store.arduino.cc/products/nicla-vision)
 
 
 ## How does it work

content/arduino-cloud/03.tutorials/alexa-mkr-rgb-shield/alexa-mkr-rgb-shield.md

@@ -1,5 +1,5 @@
 ---
-title: 'Arduino IoT Cloud, MKR RGB Shield and Alexa integration'
+title: 'Alexa & Arduino IoT Cloud Integration'
 compatible-products: [mkr-wifi-1010, mkr-rgb-shield]
 difficulty: intermediate
 description: 'Learn how to build a smart lamp by integrating the Arduino IoT Cloud and Alexa.'
@@ -12,7 +12,15 @@ featuredImage: 'cloud'
 
 ## Introduction
 
-In this tutorial, we will find out how to create a smart colored light with the help of Arduino IoT Cloud and the Alexa app. We will set it up so that we can control the brightness and color of the pixels onboard the [MKR RGB Shield](https://store.arduino.cc/arduino-mkr-rgb-shield).
+<iframe width="100%" height="400" src="https://www.youtube.com/embed/OMvZjwFYimo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+In this tutorial you will learn how to integrate the [Arduino IoT Cloud](https://create.arduino.cc/iot/) with the [Amazon Alexa skill](https://www.amazon.com/Arduino-LLC/dp/B07ZT2PK2H). At the end of this tutorial, we will be able to change the color of an  RGB matrix, using only voice commands in the Alexa app. 
+
+This tutorial focuses on using the [MKR RGB Shield](https://store.arduino.cc/products/arduino-mkr-rgb-shield) but can easily be modified to use other matrices. 
+
+***While this tutorial focuses on creating a smart lamp, it also shows the steps needed to integrate the two services, so you can essentially follow this tutorial to create other cool projects!***
+
+***You can also find all variables that can be synchronized between Arduino Cloud and Alexa in the [IoT Cloud Variables guide](/arduino-cloud/tutorials/alexa-mkr-rgb-shield#alexa-variables).***
 
 ## Goals
 

content/built-in-examples/01.basics/ReadAnalogVoltage/ReadAnalogVoltage.md

@@ -36,7 +36,7 @@ The microcontroller of the board has a circuit inside called an *analog-to-digit
 
 ### Code
 
-In the program below, the very first thing that you do will in the setup function is to begin serial communications, at 9600 bits of data per second, between your board and your computer with the line:
+In the program below, the very first thing you'll do will be in the setup function, to begin serial communication at 9600 bits of data per second, between your board and your computer with the line:
 
 `Serial.begin(9600);`
 
@@ -48,7 +48,7 @@ To change the values from 0-1023 to a range that corresponds to the voltage the
 
 `float voltage= sensorValue * (5.0 / 1023.0);`
 
-Finally, you need to print this information to your serial window as. You can do this with the command [Serial.println](https://www.arduino.cc/en/Serial/Println)()  in your last line of code:
+Finally, you need to print this information to your serial monitor. You can do this with the command [Serial.println](https://www.arduino.cc/en/Serial/Println)()  in your last line of code:
 
 `Serial.println(voltage)`
 
@@ -62,4 +62,4 @@ You can find more basic tutorials in the [built-in examples](/built-in-examples)
 
 You can also explore the [language reference](https://www.arduino.cc/reference/en/), a detailed collection of the Arduino programming language.
 
-*Last revision 2015/07/29 by SM*
+*Last revision Nov. 20, 2022 by Killaship*

content/hardware/02.hero/boards/mega-2560/datasheet/datasheet.md

@@ -129,9 +129,6 @@ Sample sketches for the Arduino® MEGA 2560 can be found either in the “Exampl
 ### Online Resources
 Now that you have gone through the basics of what you can do with the board you can explore the endless possibilities it provides by checking exciting projects on ProjectHub **[5]**, the Arduino® Library Reference **[6]** and the online store **[7]** where you will be able to complement your board with sensors, actuators and more.
 
-### Board Recovery
-All Arduino boards have a built-in bootloader which allows flashing the board via USB. In case a sketch locks up the processor and the board is not reachable anymore via USB it is possible to enter bootloader mode by double-tapping the reset button right after power up.
-
 ## Connector Pinouts
 
 ![Arduino Mega Pinout](./assets/ArduinoMEGAPinOut.png)

content/hardware/02.hero/boards/uno-mini-le/datasheet/datasheet.md

@@ -153,9 +153,6 @@ Sample sketches for the Arduino UNO Mini can be found either in the “Examples
 ### Online Resources
 Now that you have gone through the basics of what you can do with the board you can explore the endless possibilities it provides by checking exciting projects on ProjectHub **[5]**, the Arduino Library Reference **[6]** and the online store **[7]** where you will be able to complement your board with sensors, actuators and more
 
-### Board Recovery 
-All Arduino boards have a built-in bootloader which allows flashing the board via USB. In case a sketch locks up the processor and the board is not reachable anymore via USB it is possible to enter bootloader mode by double-tapping the reset button right after power up.
-
 <div class="breakPage"> </div>
 
 ## Connector Pinouts

content/hardware/02.hero/boards/uno-rev3/datasheet/datasheet.md

@@ -126,9 +126,6 @@ Sample sketches for the Arduino XXX can be found either in the “Examples” me
 ### Online Resources
 Now that you have gone through the basics of what you can do with the board you can explore the endless possibilities it provides by checking exciting projects on ProjectHub **[5]**, the Arduino Library Reference **[6]** and the online store **[7]** where you will be able to complement your board with sensors, actuators and more
 
-### Board Recovery 
-All Arduino boards have a built-in bootloader which allows flashing the board via USB. In case a sketch locks up the processor and the board is not reachable anymore via USB it is possible to enter bootloader mode by double-tapping the reset button right after power up.
-
 ## Connector Pinouts
 ![Pinout](assets/pinout.png)
 

content/hardware/03.nano/boards/nano-33-ble-sense/features.md

@@ -21,9 +21,9 @@ The Arduino Nano 33 BLE Sense is a great choice for any beginner, maker or profe
   <FeatureLink title="Datasheet" url="https://content.arduino.cc/assets/Nano_BLE_Sense_lsm9ds1.pdf" download blank/>
 </Feature>
 
-<Feature title="Python Support" image="python">
+<Feature title="Python® Support" image="python">
 
-  This board can be programmed with the Python programming language via the OpenMV IDE.
+  This board can be programmed with the Python® programming language via the OpenMV IDE.
 
   <FeatureLink title="Learn More" url="/learn/programming/arduino-and-python"/>
 </Feature>