Merge branch 'arduino:main' into patch-1

Author: e1ke

.github/workflows/deploy-production.yml

@@ -26,7 +26,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          fetch-depth: 0
+          fetch-depth: 1
       - uses: actions/setup-node@v4
         with:
           node-version: 18
@@ -66,6 +66,9 @@ jobs:
       - run: npm install
       - run: npm run build
 
+      - name: Clean up node_modules
+        run: rm -rf node_modules
+
       - name: Configure AWS credentials from Production account
         uses: aws-actions/configure-aws-credentials@v4
         with:
@@ -79,12 +82,19 @@ jobs:
         # Don't cache any HTML or JSON file: they should always be up-to-dates
         run: aws s3 sync --cache-control "public, max-age=0, must-revalidate" --include "*.html" --include="sw.js" --include="*.json" --include "*.css" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.pdf" --delete public/ s3://${{ secrets.PRODUCTION_BUCKET_NAME }}/
 
-      - name: Sync PDF
-        run: aws s3 sync --cache-control "public, max-age=86400, must-revalidate" --include "*.pdf" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.css" --exclude="*.html" --exclude="*.json" --exclude="sw.json" --delete public/ s3://${{ secrets.PRODUCTION_BUCKET_NAME }}/
+      # - name: Sync PDF
+      #   run: aws s3 sync --cache-control "public, max-age=86400, must-revalidate" --include "*.pdf" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.css" --exclude="*.html" --exclude="*.json" --exclude="sw.json" --delete public/ s3://${{ secrets.PRODUCTION_BUCKET_NAME }}/
 
-      - name: Purge cache on CloudFlare
-        run: |
-          curl -X POST "https://api.cloudflare.com/client/v4/zones/${{ secrets.CLOUDFLARE_ZONE }}/purge_cache" \
-            -H "Authorization: Bearer ${{ secrets.CLOUDFLARE_PURGE_API_TOKEN }}" \
-            -H "Content-Type: application/json" \
-            --data '{"prefixes":["${{ vars.DATASHEETS_BASE_URL }}"]}'
+      # - name: Purge cache on CloudFlare
+      #   run: |
+      #     curl -X POST "https://api.cloudflare.com/client/v4/zones/${{ secrets.CLOUDFLARE_ZONE }}/purge_cache" \
+      #       -H "Authorization: Bearer ${{ secrets.CLOUDFLARE_PURGE_API_TOKEN }}" \
+      #       -H "Content-Type: application/json" \
+      #       --data '{"prefixes":["${{ vars.DATASHEETS_BASE_URL }}"]}'
+
+      - name: Sync all cacheable assets
+        run: aws s3 sync --cache-control "public, max-age=31536000, immutable" --include "*.css" --include="*.js" --include="*.gif" --include="*.png" --include="*.svg" --exclude "*.html" --exclude="sw.js" --exclude="*.json" --delete public/ s3://${{ secrets.PRODUCTION_BUCKET_NAME }}/
+
+      - name: Sync all non-cacheable assets
+        # Don't cache any HTML or JSON file: they should always be up-to-dates
+        run: aws s3 sync --cache-control "public, max-age=0, must-revalidate" --include "*.html" --include="sw.js" --include="*.json" --include "*.css" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --delete public/ s3://${{ secrets.PRODUCTION_BUCKET_NAME }}/

.github/workflows/deploy-staging.yml

@@ -25,7 +25,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          fetch-depth: 0
+          fetch-depth: 1
       - uses: actions/setup-node@v4
         with:
           node-version: 18
@@ -65,25 +65,36 @@ jobs:
       - run: npm install
       - run: npm run build
 
+      - name: Clean up node_modules
+        run: rm -rf node_modules
+
       - name: Configure AWS credentials from Staging account
         uses: aws-actions/configure-aws-credentials@v4
         with:
           role-to-assume: ${{ secrets.STAGING_IAM_ROLE }}
           aws-region: us-east-1
 
+      # - name: Sync all cacheable assets
+      #   run: aws s3 sync --cache-control "public, max-age=31536000, immutable" --include "*.css" --include="*.js" --include="*.gif" --include="*.png" --include="*.svg" --exclude "*.html" --exclude="sw.js" --exclude="*.json" --exclude="*.pdf" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
+
+      # - name: Sync all non-cacheable assets
+      #   # Don't cache any HTML or JSON file: they should always be up-to-dates
+      #   run: aws s3 sync --cache-control "public, max-age=0, must-revalidate" --include "*.html" --include="sw.js" --include="*.json" --include "*.css" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.pdf" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
+
+      # - name: Sync PDF
+      #   run: aws s3 sync --cache-control "public, max-age=86400, must-revalidate" --include "*.pdf" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.css" --exclude="*.html" --exclude="*.json" --exclude="sw.json" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
+
+      # - name: Purge cache on CloudFlare
+      #   run: |
+      #     curl -X POST "https://api.cloudflare.com/client/v4/zones/${{ secrets.CLOUDFLARE_ZONE }}/purge_cache" \
+      #       -H "Authorization: Bearer ${{ secrets.CLOUDFLARE_PURGE_API_TOKEN }}" \
+      #       -H "Content-Type: application/json" \
+      #       --data '{"prefixes":["${{ vars.DATASHEETS_BASE_URL }}"]}'
+
       - name: Sync all cacheable assets
-        run: aws s3 sync --cache-control "public, max-age=31536000, immutable" --include "*.css" --include="*.js" --include="*.gif" --include="*.png" --include="*.svg" --exclude "*.html" --exclude="sw.js" --exclude="*.json" --exclude="*.pdf" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
+        run: aws s3 sync --cache-control "public, max-age=31536000, immutable" --include "*.css" --include="*.js" --include="*.gif" --include="*.png" --include="*.svg" --exclude "*.html" --exclude="sw.js" --exclude="*.json" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
 
       - name: Sync all non-cacheable assets
         # Don't cache any HTML or JSON file: they should always be up-to-dates
-        run: aws s3 sync --cache-control "public, max-age=0, must-revalidate" --include "*.html" --include="sw.js" --include="*.json" --include "*.css" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.pdf" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
-
-      - name: Sync PDF
-        run: aws s3 sync --cache-control "public, max-age=86400, must-revalidate" --include "*.pdf" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --exclude="*.css" --exclude="*.html" --exclude="*.json" --exclude="sw.json" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
+        run: aws s3 sync --cache-control "public, max-age=0, must-revalidate" --include "*.html" --include="sw.js" --include="*.json" --include "*.css" --exclude="*.js" --exclude="*.gif" --exclude="*.png" --exclude="*.svg" --delete public/ s3://${{ secrets.STAGING_BUCKET_NAME }}/
 
-      - name: Purge cache on CloudFlare
-        run: |
-          curl -X POST "https://api.cloudflare.com/client/v4/zones/${{ secrets.CLOUDFLARE_ZONE }}/purge_cache" \
-            -H "Authorization: Bearer ${{ secrets.CLOUDFLARE_PURGE_API_TOKEN }}" \
-            -H "Content-Type: application/json" \
-            --data '{"prefixes":["${{ vars.DATASHEETS_BASE_URL }}"]}'

content/arduino-cloud/04.cloud-editor/embedding-create-iframes/assets/iframe-highlight.png

@@ -4,27 +4,27 @@ description: 'Learn about different methods when embedding your sketches in a we
 author: 'Karl Söderby'
 ---
 
-The Web Editor is a great tool for creating and uploading programs while also collecting all of your sketches in one place. Another great feature is embedding them as iframes, such as articles, blogposts or journals. 
+The Cloud Editor is a great tool for creating and uploading programs while also collecting all of your sketches in one place. Another great feature is embedding them as iframes, such as articles, blogposts or journals. 
 
-To embed an iframe is very easy, and we just need to copy and paste a link from our sketch in the Web Editor. But we can also do a series of modifications to that iframe, and in this tutorial we will take a look at how to do that.
+To embed an iframe is very easy, and we just need to copy and paste a link from our sketch in the Cloud Editor. But we can also do a series of modifications to that iframe, and in this tutorial we will take a look at how to do that.
 
 ## Let's start
 
-First of all, we need to navigate to the [Web Editor](https://create.arduino.cc/editor). If we do not have an account, we can register one with just a few simple steps.
+First of all, we need to navigate to the [Cloud Editor](https://create.arduino.cc/editor). If we do not have an account, we can register one with just a few simple steps.
 
-Then, we need to have a code. In this tutorial, we are just going to use the good old **blink** example. When we have our sketch ready, click on the **share** button next to the port selection tool. This will open up a new window, that will have two fields: **link** and **iframe**. Copy the iframe field.
+Then, we need to have a code. In this tutorial, we are just going to use the good old **blink** example. When we have our sketch ready, click on the **share** button next to the serial monitor tool. This will open up a new window, that will have two fields: **link** and **embed**. Copy the embed field.
 
-![iframe field](assets/iframe_highlight.png)
+![embed field](assets/iframe-highlight.png)
 
-It should look something like this, where `{YOUR_ACCOUNT}` and `{SKETCH_URL}` is replaced by your own credentials.
+It should look something like this:
 
 ```markup
-<iframe src="https://create.arduino.cc/editor/{YOUR_ACCOUNT}/{SKETCH_URL}/preview?embed" style="height:510px;width:100%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed" style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>
 ```
 
 This iframe can now simply be embedded in a HTML page, and it will look like this:
 
-<iframe src="https://create.arduino.cc/editor/FT-CONTENT/189d16e1-ba13-421a-9413-7de6e9e46ed7/preview?embed" style="height:510px;width:100%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed" style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>
 
 But there are many ways we can modify the iframe to look different. So let's take a look the available modifications we can make!
 
@@ -39,12 +39,12 @@ To do this, we just need to add the following code to the end of the URL:
 ```
 The result is the following:
 
-<iframe src="https://create.arduino.cc/editor/FT-CONTENT/189d16e1-ba13-421a-9413-7de6e9e46ed7/preview?embed&snippet" style="height:510px;width:100%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed&snippet" style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>
 
 And the full URL should look like this:
 
 ```markup
-<iframe src="https://create.arduino.cc/editor/{YOUR_ACCOUNT}/{SKETCH_URL}/preview?embed&snippet" style="height:510px;width:100%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed&snippet" style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>
 ```
 
 
@@ -58,12 +58,12 @@ Next is the highlighting feature. To use this, simply add the following lines to
 
 The result is that line 3 and 4 are highlighted:
 
-<iframe src="https://create.arduino.cc/editor/FT-CONTENT/189d16e1-ba13-421a-9413-7de6e9e46ed7/preview?embed&snippet#L3-L4" style="height:510px;width:100%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed&snippet#L3-L4" style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>
 
 And the full URL should look like this:
 
 ```markup
-<iframe src="https://create.arduino.cc/editor/{YOUR_ACCOUNT}/{SKETCH_URL}/preview?embed&amp;snippet#L3-L4" style="height:510px;width:100%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed&snippet#L3-L4" style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>
 ```
 
 You can highlight as many lines as you want, and it is easily configurable. For example, if we want to highlight line 1, 3 and 5-8, we simply need to add the following to the URL:
@@ -90,7 +90,7 @@ style="height:200px;width:50%;margin:10px 0"
 
 Which will look like this:
 
-<iframe src="https://create.arduino.cc/editor/FT-CONTENT/189d16e1-ba13-421a-9413-7de6e9e46ed7/preview?embed&snippet" style="height:200px;width:50%;margin:10px 0" frameborder="0"></iframe>
+<iframe src="https://app.arduino.cc/sketches/examples?eid=01.Basics%2FBlink&view-mode=embed&snippet" style="height:200px;width:50%;margin:10px 0" frameborder=0></iframe>
 
 ## Automatically re-sizing your sketches 
 
@@ -104,9 +104,9 @@ And then using the class `arduino-sketch-iframe` in your HTML element.
 
 ## Summary
 
-There are several cool ways of working with iframes from the Web Editor, and it is a really easy process that requires very little coding. 
+There are several cool ways of working with iframes from the Cloud Editor, and it is a really easy process that requires very little coding. 
 
-The Web Editor helps you keep track on all of your sketches, and with the iframes, including your projects on other pages has never been easier.
+The Cloud Editor helps you keep track on all of your sketches, and with the iframes, including your projects on other pages has never been easier.
 
 ### More tutorials
 

content/arduino-cloud/04.cloud-editor/embedding-create-iframes/assets/iframe_highlight.png

@@ -467,6 +467,11 @@ Lors de l’ installation et de l’ exploitation de ce dispositif, la distance
 
 Hereby, Arduino S.r.l. declares that this product is in compliance with essential requirements and other relevant provisions of Directive 201453/EU. This product is allowed to be used in all EU member states.
 
+## SRRC
+
+This equipment contains a radio transmitter module with model approval code: CMIIT ID: 24J993CLD252.
+
+
 ## Company Information
 
 | Company name    | Arduino S.r.l.                                |
@@ -497,6 +502,8 @@ Hereby, Arduino S.r.l. declares that this product is in compliance with essentia
 | 11/23/2023 | Added label to LP modes                                |
 | 23/02/2024 | Added antenna frequency to block diagram               |
 | 25/04/2024 | Updated link to new Cloud Editor                       |
+| 23/08/2024 | Added SRRC certification                                 |
+
 
 
 # 中文 (ZH)
@@ -954,6 +961,10 @@ Lors de l’ installation et de l’ exploitation de ce dispositif, la distance
 
 Arduino S.r.l. 特此声明，本产品符合 201453/EU 指令的基本要求和其他相关规定。本产品允许在所有欧盟成员国使用。
 
+## SRRC
+
+本设备包含型号核准代码为：CMIIT  ID: 24J993CLD252 的无线电发射模块。
+
 ## 公司信息
 
 | 公司名称    | Arduino S.r.l.                                |
@@ -973,13 +984,14 @@ Arduino S.r.l. 特此声明，本产品符合 201453/EU 指令的基本要求和
 
 ## 变更日志
 
-| **日期**   | **变更**                                            |
-| ---------- | ------------------------------------------------------ |
-| 2023/08/06 | 发布                                                |
-| 2023/09/01 | 更新电源树流程图。                           |
+| **日期**   | **变更**                               |
+| ---------- | -------------------------------------- |
+| 2023/08/06 | 发布                                   |
+| 2023/09/01 | 更新电源树流程图。                     |
 | 2023/09/11 | 更新 SPI 部分，更新模拟/数字引脚部分。 |
-| 2023/11/06 | 更正公司名称，更正 VBUS/VUSB                |
-| 2023/11/09 | 方框图更新，天线规格           |
-| 2023/11/15 | 环境温度更新                             |
-| 2023/11/23 | 为 LP 模式添加了标签                                |
+| 2023/11/06 | 更正公司名称，更正 VBUS/VUSB           |
+| 2023/11/09 | 方框图更新，天线规格                   |
+| 2023/11/15 | 环境温度更新                           |
+| 2023/11/23 | 为 LP 模式添加了标签                   |
 | 2024/02/23 | 在方框图中添加了天线频率               |
+| 2024/08/23 | SRRC 认证                              |

content/arduino-cloud/04.cloud-editor/embedding-create-iframes/embedding-create-iframes.md

@@ -1,6 +1,6 @@
 Board:
   Name: Arduino® Nano ESP32
-  SKU: ABX00083 / ABX00092
+  SKU: ABX00083 / ABX00092 / ABX00083_CN / ABX00092_CN
 Microcontroller: u-blox® NORA-W106 (ESP32-S3)
 USB connector: USB-C®
 Pins:

content/hardware/03.nano/boards/nano-esp32/datasheet/datasheet.md

@@ -25,7 +25,7 @@ Arduino Opta® is available in three variants:
 
 <Feature title="Connectivity" image="wifi-bluetooth">
 
-  Multiple choices are available for network connectivity, including USB, Ethernet, and Wi-Fi®/Bluetooth® Low Energy in addition to industry-specific protocols such as RS-485.
+  Multiple choices are available for network connectivity, including USB, Ethernet, and Wi-Fi®/Bluetooth® Low Energy, as well as industry-specific communication interfaces like RS-485.
 
 </Feature>
 

content/hardware/03.nano/boards/nano-esp32/tech-specs.yml

@@ -20,16 +20,17 @@ Relays:
   Relay maximum switching voltage: 400 VAC
   Maximum current per relay: 10 A
   Maximum peak current per relay: 15 A
-Connectivity:
-  USB Programming Port: Yes
-  Ethernet:
-    TCP/IP: Yes
-    ModBus TCP: Yes
-  Bluetooth® Low Energy: Arduino Opta® WiFi Only
-  Wi-Fi®: Arduino Opta® WiFi Only
-Communication protocols:
-  RS-485: Arduino Opta® RS485 & Arduino Opta® WiFi Only
-  Programmable Serial ports: RS-485
+Connectivity and communication:
+  USB-C®: 
+    For programming and data logging: All variants
+  Ethernet: 
+    TCP/IP or Modbus TCP: All variants
+  Bluetooth® Low Energy: 
+    Local sensor data acquisition: Arduino Opta® WiFi Only
+  Wi-Fi®:
+    Network connectivity: Arduino Opta® WiFi Only
+  RS-485: 
+    Modbus RTU: Arduino Opta® RS485 & Arduino Opta® WiFi Only
 Power:
   Input voltage: 12-24 VDC
 Memory:
@@ -46,7 +47,7 @@ Secure element: ATECC608B
 Programming:
   Arduino programming language: Via Arduino IDEs, Arduino CLI, Arduino Web Editor
   IEC-61131-3: Ladder Diagram (LD), Function Block Diagram (FBD), Sequential Function Chart (SFC), Structured Text (ST), Instruction List (IL)
-Wiring Specifications:
+Wiring specifications:
   Recommended torque: 0.80 Nm
   Recommended tool: "#1 Phillips-headscrewdriver"
   Stripping length: 9 mm