Merge branch 'main' into karlsoderby/lang-ref-compressed

Author: karlsoderby

content/arduino-cloud/01.guides/07.node-red/nodered-intro.md

@@ -181,7 +181,7 @@ The final step is connecting the **DHT11 humidity sensor** to our Arduino MKR Wi
 
 Use the steps below to use Node-RED with the Arduino Cloud:
 
-**1.** Go to the [API keys section](https://app.arduino.cc/home/api-keys), and create a new API key.
+**1.** Go to the [API keys section](https://app.arduino.cc/api-keys), and create a new API key.
 
 **2.** Save the Client ID and Client Secret in a safe document
 

content/arduino-cloud/07.api/01.api-overview/api-overview.md

@@ -13,7 +13,7 @@ The main goal of the Application API is to allow you to create and manage IoT re
 
 The core of those APIs is organized around  [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer). Our API has predictable resource-oriented URLs, accepts  [form-encoded](https://en.wikipedia.org/wiki/POST_(HTTP)#Use_for_submitting_web_forms)  request bodies, returns  [JSON-encoded](http://www.json.org/) responses, and uses standard HTTP response codes, authentication, and verbs. 
 
-You can use those APIs, both directly calling our HTTP endpoints or using our clients that wrap those calls into easy-to-use abstractions like objects and functions. We have Applications API clients available in `javascript`, `golang`, and `python`. To use the Application API, you need to create an **API Key** in the [API Keys](https://cloud.arduino.cc/home/api-keys) section.
+You can use those APIs, both directly calling our HTTP endpoints or using our clients that wrap those calls into easy-to-use abstractions like objects and functions. We have Applications API clients available in `javascript`, `golang`, and `python`. To use the Application API, you need to create an **API Key** in the [API Keys](https://cloud.arduino.cc/api-keys) section.
 
 With this API, you can:
 - Build an automated script to create your things, in bulk

content/arduino-cloud/07.api/02.arduino-iot-api/arduino-iot-api.md

@@ -47,9 +47,9 @@ To authenticate, you will need to generate a `clientId` and `clientSecret`. This
 
 **1.** Log in to your [Arduino account](https://cloud.arduino.cc/home/).
 
-**2.** Navigate to the [Arduino Cloud home page](https://cloud.arduino.cc/home/).
+**2.** Navigate to the [API Keys page](https://app.arduino.cc/api-keys).
 
-**3.** Click **"API keys"** at the bottom left corner, and then click **"CREATE API KEY"**. Name it, and save it as a PDF. You will **not** be able to see `clientSecret` again.
+**3.** Click **"CREATE API KEY"**. Name it, and save it as a PDF. You will **not** be able to see `clientSecret` again.
 
 ![API Keys in the Arduino Cloud](assets/api-keys.png)
 

content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md

@@ -73,7 +73,7 @@ Each command has a set of **subcommands** which we will be exploring in this gui
 
 - `arduino-cloud-cli credentials`
 
-***Get your API key from the [Arduino Cloud home page](https://cloud.arduino.cc/home/) (bottom left corner of the page)***
+***Get your API key from the [Arduino Cloud API Keys page](https://app.arduino.cc/api-keys)***
 
 To authenticate with the Arduino Cloud, we will need to first set our credentials, using our `clientId` and `clientSecret` which is obtained from the Arduino Cloud API keys section.
 

content/hardware/02.hero/boards/uno-r4-minima/tutorials/opamp/assets/amp_screenshot.png

@@ -0,0 +1,107 @@
+---
+title: 'Arduino UNO R4 Minima OPAMP'
+description: 'Learn how to use the built-in Operational Amplifier in the UNO R4 Minima'
+tags:
+  - OPAMP
+author: 'Maximilian Gerhardt, Hannes Siebeneicher'
+hardware:
+  - hardware/02.hero/boards/uno-r4-minima
+software:
+  - web-editor
+  - ide-v1
+  - ide-v2
+---
+
+In this tutorial, you will learn how to use the built-in operational amplifier (OPAMP) featured on the [Arduino UNO R4 Minima](https://store.arduino.cc/products/uno-r4-minima). Operational amplifiers are very versatile and can be used to e.g. mirror an electrical signal or amplify it. 
+
+## Goals
+
+In this article, you will learn:
+- about the OPAMP feature onboard the UNO R4 Minima,
+- about the basics of the OPAMP library, 
+- how to mirror a voltage signal,
+- how to amplify a voltage signal.
+
+## Hardware & Software Needed
+  To follow along with this article, you will need the following hardware: 
+  
+  - [Arduino UNO R4 Minima](https://store.arduino.cc/uno-r4-minima)
+  - resistors 
+  - Jumper wires
+  
+  
+## Operational Amplifier (OPAMP)
+
+An OPAMP is a versatile and widely used electronic component that belongs to the class of analog integrated circuits. Its primary function is to amplify voltage signals but they are very versatile and can be used to:
+
+- mirror an input voltage to its output,
+- amplify a small analog voltage to its output pin, the UNO R4's output voltage range is 0 to ~4.7 V,
+- compare two input voltages and give a binary "higher" or "lower" output,
+- integrate and differentiate signals.
+
+## Voltage Follower
+
+The simplest way to test the OPAMP is to configure it as a voltage follower by connecting A2 to A3. In this setup, the voltage at A3 should mimic the voltage applied to A1. For instance, if you connect A1 to the ground (GND), the OPAMP output at A3 should also be at the ground potential. Similarly, if you connect A1 to 3.3 V, the output at A3 should be approximately 3.3 V.
+
+## Circuit
+
+![Voltage Follower Circuit](./assets/circuitFollowerMinima.png)
+
+## Voltage Amplifier
+
+***Caution: When amplifying the voltage of a battery using an operational amplifier, you should be aware of potential risks. The amplification process can lead to a high current draw, essentially placing a significant load on the battery, which may result in overheating, damage, or even pose a security risk. To mitigate this risk, you may for example add a resistor in series with the battery.***
+
+A voltage amplifier, as the name suggests, amplifies the voltage. A simple 2x amplifier can be built using e.g. two `10k` resistors. Connect one resistor between "minus" and GND. Then use the second resistor to connect the output and "minus" together. A circuit diagram [can be seen below](#circuit). Any signal input at "plus" will now appear with double the amplitude at the output pin. Of course, the input signal and the Arduino board should share the same `GND`. 
+
+***The amplified output signal should not go above ~4.7 V, otherwise clipping will appear and you can damage the board***
+
+Below is a capture of an oscilloscope in which an approx. 2 V square wave (green, channel 2) is amplified to a 4 V square wave (yellow, channel 1) with the circuit shown below. The input signal was generated by a function generation (and shared GND was connected).
+
+![Oscilloscope measurements](./assets/amp_screenshot.png)
+
+But let's say you want to amplify the voltage signal 4x instead of 2x. The amplification of an OPAMP mainly depends on the chosen resistor values. Take a look at the formula below:
+
+![Calculate resistor value](./assets/calc.png)
+
+**Av** = Amplified Voltage (V)
+
+**R1** = Resistor connected to Ground (Ω)
+
+**R2** = Feedback resistor (Ω)
+
+We know we want to amplify the voltage times four so:
+
+**Av** = 4 V
+
+Now, we need to figure out what resistors to choose. Because we only can solve for one unknown value we choose a predefined value for one of the resistors, e.g. 10k Ω for R1.
+
+**R1** = 10k Ω
+
+Your formula should now look like this:
+
+![Add values to the formula](./assets/numCalc.png)
+
+ That leaves R2 as the only unknown variable. Now, Subtract one from both sides and multiply by ten, which leaves us with:
+
+**R2 = 30k Ω**
+
+## Circuit
+
+![Voltage 2x Amplifier Circuit](./assets/circuitAmplifierMinima.png)
+
+***Read more about an amplifier circuit [here](https://www.electronics-tutorials.ws/opamp/opamp_3.html).***
+
+## Code
+
+To start up the opamp, simply include the library and call `OPAMP.begin(speed)`. As the optional `speed` argument to this function, can choose either `OPAMP_SPEED_LOWSPEED` as the low-speed (lower power) mode or `OPAMP_SPEED_HIGHSPEED` as the high-speed, high-power mode.
+
+```arduino
+#include <OPAMP.h>
+
+void setup () {
+  OPAMP.begin(OPAMP_SPEED_HIGHSPEED);
+}
+
+void loop() {}
+
+```

content/hardware/02.hero/boards/uno-r4-minima/tutorials/opamp/assets/calc.png

@@ -0,0 +1,107 @@
+---
+title: 'Arduino UNO R4 WiFi OPAMP'
+description: 'Learn how to use the built-in Operational Amplifier in the UNO R4 WiFi'
+tags:
+  - OPAMP
+author: 'Maximilian Gerhardt, Hannes Siebeneicher'
+hardware:
+  - hardware/02.hero/boards/uno-r4-wifi
+software:
+  - web-editor
+  - ide-v1
+  - ide-v2
+---
+
+In this tutorial, you will learn how to use the built-in operational amplifier (OPAMP) featured on the [Arduino UNO R4 WiFi](https://store.arduino.cc/products/uno-r4-wifi). Operational amplifiers are very versatile and can be used to e.g. mirror an electrical signal or amplify it. 
+
+## Goals
+
+In this article, you will learn:
+- about the OPAMP feature onboard the UNO R4 WiFi,
+- about the basics of the OPAMP library, 
+- how to mirror a voltage signal,
+- how to amplify a voltage signal.
+
+## Hardware & Software Needed
+  To follow along with this article, you will need the following hardware: 
+  
+  - [Arduino UNO R4 WiFi](https://store.arduino.cc/uno-r4-wifi)
+  - resistors
+  - Jumper wires
+  
+  
+## Operational Amplifier (OPAMP)
+
+An OPAMP is a versatile and widely used electronic component that belongs to the class of analog integrated circuits. Its primary function is to amplify voltage signals but they are very versatile and can be used to:
+
+- mirror an input voltage to its output,
+- amplify a small analog voltage to its output pin, the UNO R4's output voltage range is 0 to ~4.7 V,
+- compare two input voltages and give a binary "higher" or "lower" output,
+- integrate and differentiate signals.
+
+## Voltage Follower
+
+The simplest way to test the OPAMP is to configure it as a voltage follower by connecting A2 to A3. In this setup, the voltage at A3 should mimic the voltage applied to A1. For instance, if you connect A1 to the ground (GND), the OPAMP output at A3 should also be at the ground potential. Similarly, if you connect A1 to 3.3 V, the output at A3 should be approximately 3.3 V.
+
+## Circuit
+
+![Voltage Follower Circuit](./assets/circuitFollowerWiFi.png)
+
+## Voltage Amplifier
+
+***Caution: When amplifying the voltage of a battery using an operational amplifier, you should be aware of potential risks. The amplification process can lead to a high current draw, essentially placing a significant load on the battery, which may result in overheating, damage, or even pose a security risk. To mitigate this risk, you may for example add a resistor in series with the battery.***
+
+A voltage amplifier, as the name suggests, amplifies the voltage. A simple 2x amplifier can be built using e.g. two `10k` resistors. Connect one resistor between "minus" and GND. Then use the second resistor to connect the output and "minus" together. A circuit diagram [can be seen below](#circuit). Any signal input at "plus" will now appear with double the amplitude at the output pin. Of course, the input signal and the Arduino board should share the same `GND`. 
+
+***The amplified output signal should not go above ~4.7 V, otherwise clipping will appear and you can damage the board***
+
+Below is a capture of an oscilloscope in which an approx. 2 V square wave (green, channel 2) is amplified to a 4 V square wave (yellow, channel 1) with the circuit shown below. The input signal was generated by a function generation (and shared GND was connected).
+
+![Oscilloscope measurements](./assets/amp_screenshot.png)
+
+But let's say you want to amplify the voltage signal 4x instead of 2x. The amplification of an OPAMP mainly depends on the chosen resistor values. Take a look at the formula below:
+
+![Calculate resistor value](./assets/calc.png)
+
+**Av** = Amplified Voltage (V)
+
+**R1** = Resistor connected to Ground (Ω)
+
+**R2** = Feedback resistor (Ω)
+
+We know we want to amplify the voltage times four so:
+
+**Av** = 4 V
+
+Now, we need to figure out what resistors to choose. Because we only can solve for one unknown value we choose a predefined value for one of the resistors, e.g. 10k Ω for R1.
+
+**R1** = 10k Ω
+
+Your formula should now look like this:
+
+![Add values to the formula](./assets/numCalc.png)
+
+ That leaves R2 as the only unknown variable. Now, Subtract one from both sides and multiply by ten, which leaves us with:
+
+**R2 = 30k Ω**
+
+## Circuit
+
+![Voltage 2x Amplifier Circuit](./assets/circuitAmplifierWiFi.png)
+
+***Read more about an amplifier circuit [here](https://www.electronics-tutorials.ws/opamp/opamp_3.html).***
+
+## Code
+
+To start up the opamp, simply include the library and call `OPAMP.begin(speed)`. As the optional `speed` argument to this function, can choose either `OPAMP_SPEED_LOWSPEED` as the low-speed (lower power) mode or `OPAMP_SPEED_HIGHSPEED` as the high-speed, high-power mode.
+
+```arduino
+#include <OPAMP.h>
+
+void setup () {
+  OPAMP.begin(OPAMP_SPEED_HIGHSPEED);
+}
+
+void loop() {}
+
+```

content/hardware/02.hero/boards/uno-r4-minima/tutorials/opamp/assets/circuitAmplifierMinima.png

@@ -921,7 +921,7 @@ First, the necessary libraries are included:
  - The `WiFiC3.h` and `WiFiClient.h` are included at the start, those libraries contains the functionalities required to communicate via Wi-Fi®. 
  - The SSID and password for the Wi-Fi® network are defined.
 
-Then, the server is defined ( "www.google.com" in this case) and the Wi-Fi® client object is created to manage the connection to the server.
+Then, the server is defined ( `www.google.com` in this case) and the Wi-Fi® client object is created to manage the connection to the server.
 
 Next, in the `setup()` function:
 
@@ -1059,7 +1059,7 @@ First, the necessary libraries are included:
 - The `EthernetC33` library which contains the functionality required to communicate via Ethernet is included in the beginning.
 
 
-Then, the server is defined, which is "www.google.com" in this case:
+Then, the server is defined, which is `www.google.com` in this case:
 
 - The static IP address which will be used if the DHCP fails to assign an IP address is set.
 

content/hardware/02.hero/boards/uno-r4-minima/tutorials/opamp/assets/circuitFollowerMinima.png

@@ -24,7 +24,7 @@ In this tutorial, we will create a simple container and upload it to the Arduino
 - [Portenta X8](https://store.arduino.cc/portenta-x8)
 - ADB: [Check how to connect to your Portenta X8](https://docs.arduino.cc/tutorials/portenta-x8/user-manual#out-of-the-box-experience)
 - USB-C® cable (either USB-C® to USB-A or USB-C® to USB-C®)
-- Arduino Pro Cloud Subscription [Learn more about the Pro Cloud](https://www.arduino.cc/pro/hardware/product/portenta-x8#pro-cloud)
+- Arduino Pro Cloud Subscription [Learn more about the Pro Cloud](https://cloud.arduino.cc/)
 - [Arduino IDE 1.8.10+](https://www.arduino.cc/en/software), [Arduino IDE 2](https://www.arduino.cc/en/software), or [Arduino Web Editor](https://create.arduino.cc/editor)
 
 ## Instructions

content/hardware/02.hero/boards/uno-r4-minima/tutorials/opamp/assets/numCalc.png

@@ -68,7 +68,7 @@ Next you can look at some of the code in the example sketch.
 
 Now let's take a look at some important parts of the code.
 
-The sketch will make the board connect to a website. This line in the code decides what website it connects to. The example uses "www.google.com", but feel free to change it and experiment with different websites.
+The sketch will make the board connect to a website. This line in the code decides what website it connects to. The example uses `www.google.com`, but feel free to change it and experiment with different websites.
 
 ```arduino
 char server[] = "www.google.com";

content/hardware/02.hero/boards/uno-r4-minima/tutorials/opamp/opamp.md

@@ -60,7 +60,7 @@ First you are making use of some micropython libraries, [network](http://docs.mi
 import network, usocket
 ```
 
-The script will make the board connect to a website and set a port for later use. This line in the code decides what website it connects to. The example uses "www.google.com", but feel free to change it and experiment with different websites.
+The script will make the board connect to a website and set a port for later use. This line in the code decides what website it connects to. The example uses `www.google.com`, but feel free to change it and experiment with different websites.
 
 ```arduino
 PORT = 80

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/opamp/assets/amp_screenshot.png

@@ -1,7 +1,11 @@
 ---
 title: Nicla Sense ME
 url_shop: https://store.arduino.cc/products/nicla-sense-me
-url_guide: /software/ide-v1/tutorials/getting-started/cores/arduino-mbed_nicla
+url_guide: /tutorials/nicla-sense-me/cheat-sheet
+primary_button_url: /tutorials/nicla-sense-me/getting-started
+primary_button_title: Get Started
+secondary_button_url: /tutorials/nicla-sense-me/cheat-sheet
+secondary_button_title: Cheat Sheet
 core: arduino:mbed_nicla
 certifications: [CE, FCC, UKCA, WEEE, RoHS, IC, MIC, RCM]
 productCode: '043'

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/opamp/assets/calc.png

@@ -731,7 +731,7 @@ Use the sensor IDs from the section "Sensor IDs" to enable and configure the des
 
 The BHI260AP sensor runs a customizable firmware based on the BSX Sensor Fusion library. It provides a complete 9-axis fusion solution, which combines the measurements from 3-axis gyroscope, 3-axis geomagnetic sensor and a 3-axis accelerometer, to provide a robust absolute orientation vector. The algorithm fuses the sensor raw data from the accelerometer, geomagnetic sensor and gyroscope in an intelligent way to improve each sensor’s output.
 
-Go to this [site](https://www.bosch-sensortec.com/software-tools/software/sensor-fusion-software/) or take a look at the BHI260AP's [datasheet](https://www.bosch-sensortec.com/media/boschsensortec/downloads/datasheets/bst-bhi260ap-ds000.pdf) for more information.
+Go to this [site](https://www.bosch-sensortec.com/software-tools/software/sensor-fusion-software-bsx/) or take a look at the BHI260AP's [datasheet](https://www.bosch-sensortec.com/media/boschsensortec/downloads/datasheets/bst-bhi260ap-ds000.pdf) for more information.
 
 ## Communication
 

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/opamp/assets/circuitAmplifierWiFi.png

@@ -2,6 +2,8 @@
 title: Nicla Vision
 url_shop: https://store.arduino.cc/products/nicla-vision
 url_guide: /tutorials/nicla-vision/getting-started
+primary_button_url: /tutorials/nicla-vision/getting-started
+primary_button_title: Get Started
 core: arduino:mbed_nicla
 certifications: [CE, UKCA]
 productCode: '120'

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/opamp/assets/circuitFollowerWiFi.png

@@ -73,9 +73,9 @@ While using the Nicla Vision with OpenMV, the RGB LED of the board can be used t
 
 🟢 **Blinking Green:** Your Nicla Vision onboard bootloader is running. The onboard bootloader runs for a few seconds when your Nicla Vision is powered via USB to allow OpenMV IDE to reprogram your Nicla Vision.
 
-🔵 **Blinking Blue:** Your Nicla Vision is running the default [main.py](http://main.py/) script onboard. 
+🔵 **Blinking Blue:** Your Nicla Vision is running the default `main.py` script onboard. 
 
-If you overwrite the [main.py](http://main.py/) script on your Nicla Vision, then it will run whatever code you loaded on it instead.
+If you overwrite the `main.py` script on your Nicla Vision, then it will run whatever code you loaded on it instead.
 
 ***If the LED is blinking blue but OpenMV IDE cannot connect to your Nicla Vision, please make sure you are connecting your Nicla Vision to your PC with a USB cable that supplies both data and power.***
 

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/opamp/assets/numCalc.png

@@ -2,6 +2,10 @@
 title: Nicla Voice
 url_shop: https://store.arduino.cc/nicla-voice
 url_guide: /tutorials/nicla-voice/user-manual
+primary_button_url: /tutorials/nicla-voice/user-manual
+primary_button_title: User Manual
+secondary_button_url: /tutorials/nicla-voice/ei-intruder-detector
+secondary_button_title: Audio ML Guide
 core: arduino:mbed_voice
 productCode: 'ABX00061'
 certifications: [CE, UKCA]

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/opamp/opamp.md

@@ -1,4 +1,5 @@
 ---
 title: Nicla Family
 description: Our smallest footprint packed with advanced features.
+businessUnit: pro
 ---