diff --git a/README.md b/README.md index 5b6f06b05b..8ea3e47c2f 100644 --- a/README.md +++ b/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 diff --git a/content/arduino-cloud/01.getting-started/02.technical-reference/iot-cloud-tech-ref.md b/content/arduino-cloud/01.getting-started/02.technical-reference/iot-cloud-tech-ref.md index 40f4de9fa9..f07d91a0f7 100644 --- a/content/arduino-cloud/01.getting-started/02.technical-reference/iot-cloud-tech-ref.md +++ b/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. diff --git a/content/arduino-cloud/01.getting-started/08.arduino-iot-api/arduino-iot-api.md b/content/arduino-cloud/01.getting-started/08.arduino-iot-api/arduino-iot-api.md index 6126ea242e..954c80a9eb 100644 --- a/content/arduino-cloud/01.getting-started/08.arduino-iot-api/arduino-iot-api.md +++ b/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). diff --git a/content/hardware/03.nano/boards/nano-33-ble-sense/features.md b/content/hardware/03.nano/boards/nano-33-ble-sense/features.md index 8564669af3..85424420b3 100644 --- a/content/hardware/03.nano/boards/nano-33-ble-sense/features.md +++ b/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 - + - 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. diff --git a/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/ble-sense-python-api/ble-sense-python-api.md b/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/ble-sense-python-api/ble-sense-python-api.md index b4acd97d8c..99688f22e4 100644 --- a/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/ble-sense-python-api/ble-sense-python-api.md +++ b/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/ble-sense-python-api/ble-sense-python-api.md @@ -1,7 +1,7 @@ --- author: 'Karl Söderby' -title: 'Nano 33 BLE Sense Python Guide' -description: 'Discover how to access the features on the Nano 33 BLE Sense using Python scripts.' +title: 'Nano 33 BLE Sense Python® Guide' +description: 'Discover how to access the features on the Nano 33 BLE Sense using Python® scripts.' compatible-products: [nano-33-ble-sense] tags: - MicroPython @@ -10,9 +10,9 @@ tags: ![The Nano 33 BLE Sense](assets/hero.png) -The [Nano 33 BLE Sense board](https://store.arduino.cc/arduino-nano-33-ble-sense) board can be programmed using the popular **Python** programming language. More specifically, it supports [OpenMV's fork of MicroPython](https://github.com/openmv/micropython), where MicroPython is an implementation of the Python language, designed to run on microcontrollers. In this article, you will find a lot of sample scripts that will work directly with your Nano 33 BLE Sense, such as general GPIO control, reading onboard sensors and Wi-Fi/BLE communication! +The [Nano 33 BLE Sense board](https://store.arduino.cc/arduino-nano-33-ble-sense) board can be programmed using the popular **Python®** programming language. More specifically, it supports [OpenMV's fork of MicroPython](https://github.com/openmv/micropython), where MicroPython is an implementation of the Python® language, designed to run on microcontrollers. In this article, you will find a lot of sample scripts that will work directly with your Nano 33 BLE Sense, such as general GPIO control, reading onboard sensors and Wi-Fi/BLE communication! -- If you want to read more about Arduino & Python, you can visit the [Python with Arduino](/learn/programming/arduino-and-python) article. Here you will find a lot of useful examples, such as how to use delays, interrupts, reading pins and more general functions. +- If you want to read more about Arduino & Python®, you can visit the [Python® with Arduino](/learn/programming/arduino-and-python) article. Here you will find a lot of useful examples, such as how to use delays, interrupts, reading pins and more general functions. ## Hardware & Software Needed @@ -25,7 +25,7 @@ The [Nano 33 BLE Sense board](https://store.arduino.cc/arduino-nano-33-ble-sense Below you will find a lot of useful examples that can be loaded to your Nano 33 BLE Sense board. Many of these examples were extracted from the [OpenMV repository](https://github.com/openmv/openmv), where you can find many useful examples for other boards as well. -***In this article, you will only find examples for the Nano 33 BLE Sense board. For more information on how to use delays, read and write to pins, please refer to the [Python with Arduino](/learn/programming/arduino-and-python) main article.*** +***In this article, you will only find examples for the Nano 33 BLE Sense board. For more information on how to use delays, read and write to pins, please refer to the [Python® with Arduino](/learn/programming/arduino-and-python) main article.*** ## Pin Control @@ -415,4 +415,4 @@ while (True): ## Summary -In this article we have gone through a selection of scripts that will help you control your Nano BLE Sense board, via the OpenMV IDE. Feel free to check out our [Python with Arduino boards article](/learn/programming/arduino-and-python), where you can find guides to other boards, useful links to learn Python and more. +In this article we have gone through a selection of scripts that will help you control your Nano BLE Sense board, via the OpenMV IDE. Feel free to check out our [Python® with Arduino boards article](/learn/programming/arduino-and-python), where you can find guides to other boards, useful links to learn Python® and more. diff --git a/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/get-started-with-machine-learning/get-started-with-machine-learning.md b/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/get-started-with-machine-learning/get-started-with-machine-learning.md index d65c714bf7..59af1282a1 100644 --- a/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/get-started-with-machine-learning/get-started-with-machine-learning.md +++ b/content/hardware/03.nano/boards/nano-33-ble-sense/tutorials/get-started-with-machine-learning/get-started-with-machine-learning.md @@ -289,7 +289,7 @@ We’re going to use [Google Colab](https://colab.research.google.com/) to train ![Arduino gesture recognition training colab.](assets/colab.png) -- Set up Python environment +- Set up Python® environment - Upload the punch.csv and flex.csv data - Parse and prepare the data - Build and train the model diff --git a/content/hardware/03.nano/boards/nano-33-ble/features.md b/content/hardware/03.nano/boards/nano-33-ble/features.md index 933a498b72..245e235055 100644 --- a/content/hardware/03.nano/boards/nano-33-ble/features.md +++ b/content/hardware/03.nano/boards/nano-33-ble/features.md @@ -26,9 +26,9 @@ The Arduino Nano 33 BLE is a great choice for any beginner, maker or professiona - + - 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. diff --git a/content/hardware/03.nano/boards/nano-33-ble/tutorials/ble-python-api/ble-python-api.md b/content/hardware/03.nano/boards/nano-33-ble/tutorials/ble-python-api/ble-python-api.md index c85d39cab9..2b1c9cd3cb 100644 --- a/content/hardware/03.nano/boards/nano-33-ble/tutorials/ble-python-api/ble-python-api.md +++ b/content/hardware/03.nano/boards/nano-33-ble/tutorials/ble-python-api/ble-python-api.md @@ -1,7 +1,7 @@ --- author: 'Karl Söderby' -title: 'Nano 33 BLE Python Guide' -description: 'Discover how to access the features on the Nano 33 BLE using Python scripts.' +title: 'Nano 33 BLE Python® Guide' +description: 'Discover how to access the features on the Nano 33 BLE using Python® scripts.' compatible-products: [nano-33-ble] tags: - MicroPython @@ -11,11 +11,11 @@ featuredImage: 'board' ![The Nano 33 BLE](assets/hero.png) -The [Nano 33 BLE](https://store.arduino.cc/arduino-nano-33-ble-sense) board can be programmed using the popular **Python** programming language. More specifically, it supports [OpenMV's fork of MicroPython](https://github.com/openmv/micropython), where MicroPython is an implementation of the Python language, designed to run on microcontrollers. In this article, you will find a lot of sample scripts that will work directly with your Nano 33 BLE, such as general GPIO control, reading data from the IMU module and testing Bluetooth® Low Energy connection. +The [Nano 33 BLE](https://store.arduino.cc/arduino-nano-33-ble-sense) board can be programmed using the popular **Python®** programming language. More specifically, it supports [OpenMV's fork of MicroPython](https://github.com/openmv/micropython), where MicroPython is an implementation of the Python® language, designed to run on microcontrollers. In this article, you will find a lot of sample scripts that will work directly with your Nano 33 BLE, such as general GPIO control, reading data from the IMU module and testing Bluetooth® Low Energy connection. -- If you want to read more about Arduino & Python, you can visit the [Python with Arduino](/learn/programming/arduino-and-python) article. Here you will find a lot of useful examples, such as how to use delays, interrupts, reading pins and more general functions. +- If you want to read more about Arduino & Python®, you can visit the [Python® with Arduino](/learn/programming/arduino-and-python) article. Here you will find a lot of useful examples, such as how to use delays, interrupts, reading pins and more general functions. -***If you are looking for information related to the similar Nano 33 BLE Sense board, you can refer to the [Nano 33 BLE Sense Python Guide](/tutorials/nano-33-ble-sense/ble-sense-python-api).*** +***If you are looking for information related to the similar Nano 33 BLE Sense board, you can refer to the [Nano 33 BLE Sense Python® Guide](/tutorials/nano-33-ble-sense/ble-sense-python-api).*** ## Hardware & Software Needed @@ -28,7 +28,7 @@ The [Nano 33 BLE](https://store.arduino.cc/arduino-nano-33-ble-sense) board can Below you will find a lot of useful examples that can be loaded to your Nano 33 BLE board. Many of these examples were extracted from the [OpenMV repository](https://github.com/openmv/openmv), where you can find many useful examples for other boards as well. -***In this article, you will only find examples for the Nano 33 BLE board. For more information on how to use delays, read and write to pins, please refer to the [Python with Arduino](/learn/programming/arduino-and-python) main article.*** +***In this article, you will only find examples for the Nano 33 BLE board. For more information on how to use delays, read and write to pins, please refer to the [Python® with Arduino](/learn/programming/arduino-and-python) main article.*** ## Pin Control @@ -265,4 +265,4 @@ while (True): ## Summary -In this article we have gone through a selection of scripts that will help you control your Nano BLE board, via the OpenMV IDE. Feel free to check out our [Python with Arduino boards article](/learn/programming/arduino-and-python), where you can find guides to other boards, useful links to learn Python and more. +In this article we have gone through a selection of scripts that will help you control your Nano BLE board, via the OpenMV IDE. Feel free to check out our [Python® with Arduino boards article](/learn/programming/arduino-and-python), where you can find guides to other boards, useful links to learn Python® and more. diff --git a/content/hardware/03.nano/boards/nano-rp2040-connect/essentials.md b/content/hardware/03.nano/boards/nano-rp2040-connect/essentials.md index 2d54176f2e..73786343ae 100644 --- a/content/hardware/03.nano/boards/nano-rp2040-connect/essentials.md +++ b/content/hardware/03.nano/boards/nano-rp2040-connect/essentials.md @@ -5,7 +5,7 @@ Learn about the Nano RP2040 Connect's onboard sensors, supported serial & wireless protocols, pins and much more. - + Learn how to install MicroPython and how to load scripts to your Nano RP2040 Connect. diff --git a/content/hardware/03.nano/boards/nano-rp2040-connect/features.md b/content/hardware/03.nano/boards/nano-rp2040-connect/features.md index b6350fb020..f6fb24340d 100644 --- a/content/hardware/03.nano/boards/nano-rp2040-connect/features.md +++ b/content/hardware/03.nano/boards/nano-rp2040-connect/features.md @@ -13,9 +13,9 @@ The feature packed **Arduino Nano RP2040 Connect** brings the new **Raspberry Pi - + - 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. diff --git a/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-data-logger/rp2040-data-logger.md b/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-data-logger/rp2040-data-logger.md index 8c8e03d184..4f9c14b0d9 100644 --- a/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-data-logger/rp2040-data-logger.md +++ b/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-data-logger/rp2040-data-logger.md @@ -21,7 +21,7 @@ In order to utilize this feature, we need to install the latest release of [Open This tutorial can be completed with only the Nano RP2040 Connect board and open-source software. -***If you are unfamiliar with Arduino & Python, you can learn more by reading the [Python with Arduino](/learn/programming/arduino-and-python) and the [Nano RP2040 Connect Python API Guide](/tutorials/nano-rp2040-connect/rp2040-python-api) articles.*** +***If you are unfamiliar with Arduino & Python®, you can learn more by reading the [Python® with Arduino](/learn/programming/arduino-and-python) and the [Nano RP2040 Connect Python® API Guide](/tutorials/nano-rp2040-connect/rp2040-python-api) articles.*** ## Goals diff --git a/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-python-api/rp2040-python-api.md b/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-python-api/rp2040-python-api.md index 0cbeaf3f74..71d192f4ec 100644 --- a/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-python-api/rp2040-python-api.md +++ b/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-python-api/rp2040-python-api.md @@ -1,7 +1,7 @@ --- author: 'Karl Söderby' -title: 'Nano RP2040 Connect Python API Guide' -description: 'Discover how to access the features Nano RP2040 Connect using Python scripts.' +title: 'Nano RP2040 Connect Python® API Guide' +description: 'Discover how to access the features Nano RP2040 Connect using Python® scripts.' compatible-products: [nano-rp2040-connect] difficulty: intermediate tags: @@ -11,11 +11,11 @@ tags: ![The Nano RP2040 Connect](assets/hero.png) -The [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect) board can be programmed using the popular **Python** programming language. The board is supported by upstream [MicroPython](https://github.com/micropython/micropython) and [OpenMV's fork of MicroPython](https://github.com/openmv/micropython), where **MicroPython** is an implementation of the Python language, designed to run on microcontrollers. +The [Nano RP2040 Connect](https://store.arduino.cc/nano-rp2040-connect) board can be programmed using the popular **Python®** programming language. The board is supported by upstream [MicroPython](https://github.com/micropython/micropython) and [OpenMV's fork of MicroPython](https://github.com/openmv/micropython), where **MicroPython** is an implementation of the Python® language, designed to run on microcontrollers. In this article, you will find a lot of sample scripts that will work directly with your Nano RP2040 Connect, such as general GPIO control, reading onboard sensors and Wi-Fi/BLE communication! -- If you want to read more about Arduino & Python, you can visit the [Python with Arduino](/learn/programming/arduino-and-python) article. Here you will find a lot of useful examples, such as how to use delays, interrupts, reading pins and more general functions. +- If you want to read more about Arduino & Python®, you can visit the [Python® with Arduino](/learn/programming/arduino-and-python) article. Here you will find a lot of useful examples, such as how to use delays, interrupts, reading pins and more general functions. ## Hardware Requirements @@ -54,7 +54,7 @@ To install upstream MicroPython and load scripts to your board, you will need to ![Select the port.](assets/thonny-select-com.png) -**8.** Write a Python script (or select any example from the list below), and click on the **Green Play Button (F5)** to run it on your board. +**8.** Write a Python® script (or select any example from the list below), and click on the **Green Play Button (F5)** to run it on your board. Congratulations! You can now run MicroPython scripts on your Nano RP2040 Connect board! @@ -64,7 +64,7 @@ Congratulations! You can now run MicroPython scripts on your Nano RP2040 Connect Below you will find a lot of useful examples that can be loaded to your Nano RP2040 Connect board. Many of these examples were extracted from the [OpenMV repository](https://github.com/openmv/openmv), where you can find many useful examples for other boards as well. -***In this article, you will only find examples for the Nano RP2040 Connect board. For more information on how to use delays, read and write to pins, please refer to the [Python with Arduino](/learn/programming/arduino-and-python) main article.*** +***In this article, you will only find examples for the Nano RP2040 Connect board. For more information on how to use delays, read and write to pins, please refer to the [Python® with Arduino](/learn/programming/arduino-and-python) main article.*** ## GPIO Map @@ -535,4 +535,4 @@ if __name__ == "__main__": ## Summary -In this article we have gone through a selection of scripts that will help you control your Nano RP2040 Connect board, via the OpenMV IDE. Feel free to check out our [Python with Arduino boards article](/learn/programming/arduino-and-python), where you can find guides to other boards, useful links to learn Python and more. +In this article we have gone through a selection of scripts that will help you control your Nano RP2040 Connect board, via the OpenMV IDE. Feel free to check out our [Python® with Arduino boards article](/learn/programming/arduino-and-python), where you can find guides to other boards, useful links to learn Python® and more. diff --git a/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-upgrading-nina-firmware/rp2040-upgrading-nina-firmware.md b/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-upgrading-nina-firmware/rp2040-upgrading-nina-firmware.md index 70ef4abc6c..1d4c860942 100644 --- a/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-upgrading-nina-firmware/rp2040-upgrading-nina-firmware.md +++ b/content/hardware/03.nano/boards/nano-rp2040-connect/tutorials/rp2040-upgrading-nina-firmware/rp2040-upgrading-nina-firmware.md @@ -19,7 +19,7 @@ software: ## Introduction -In some cases you might need to upgrade your NINA-W102 module's firmware. There is for example a need to upgrade your firmware if you wish to [use the NINA-W102 module via Python](https://docs.arduino.cc/tutorials/nano-rp2040-connect/rp2040-python-api#wireless). +In some cases you might need to upgrade your NINA-W102 module's firmware. There is for example a need to upgrade your firmware if you wish to [use the NINA-W102 module via Python®](https://docs.arduino.cc/tutorials/nano-rp2040-connect/rp2040-python-api#wireless). ***If you are using the [Arduino Cloud IoT](https://create.arduino.cc/iot/things), manual firmware upgrades are not necessary, as it is done automatically while configuring your board.*** diff --git a/content/hardware/04.pro/boards/portenta-h7/tutorials/getting-started-openmv-micropython/content.md b/content/hardware/04.pro/boards/portenta-h7/tutorials/getting-started-openmv-micropython/content.md index 5221b48e70..6dc9188c86 100644 --- a/content/hardware/04.pro/boards/portenta-h7/tutorials/getting-started-openmv-micropython/content.md +++ b/content/hardware/04.pro/boards/portenta-h7/tutorials/getting-started-openmv-micropython/content.md @@ -85,7 +85,7 @@ Create a new script by clicking the "New File" button in the toolbar on the left import pyb # Import module for board related functions ``` -A module in Python is a confined bundle of functionality. By importing it into the script, it gets made available. For this example, you only need `pyb`, which is a module that contains board related functionality such as PIN handling. You can read more about its functions [here](https://docs.micropython.org/en/latest/library/pyb.html). +A module in Python® is a confined bundle of functionality. By importing it into the script, it gets made available. For this example, you only need `pyb`, which is a module that contains board related functionality such as PIN handling. You can read more about its functions [here](https://docs.micropython.org/en/latest/library/pyb.html). Now you can create the variables that will control our built-in RGB LED. With `pyb` you can easily control each color. diff --git a/content/hardware/04.pro/boards/portenta-h7/tutorials/setting-up-portenta/content.md b/content/hardware/04.pro/boards/portenta-h7/tutorials/setting-up-portenta/content.md index 738c4d683a..d1f10641cd 100644 --- a/content/hardware/04.pro/boards/portenta-h7/tutorials/setting-up-portenta/content.md +++ b/content/hardware/04.pro/boards/portenta-h7/tutorials/setting-up-portenta/content.md @@ -24,7 +24,7 @@ Congratulations on your purchase of one of our most powerful microcontroller boa One of the benefits of the Portenta H7 is that it supports different types of software cores. A core is the software API for a particular set of processors. It is the API that provides functions such as digitalRead(), analogWrite(), millis() etc. which directly operate on the hardware. -At the moment of writing the tutorial, there is an Arduino core and a MicroPython core available for working with Portenta. The latter one allows you to write sketches in the popular programming language Python rather than C or C++ and run them on the Portenta H7. +At the moment of writing the tutorial, there is an Arduino core and a MicroPython core available for working with Portenta. The latter one allows you to write sketches in the popular programming language Python® rather than C or C++ and run them on the Portenta H7. This tutorial focuses on the Arduino core which allows you to benefit from the thousands of existing Arduino libraries and code examples written in C and C++ which are compatible with the Arduino core. A tutorial about setting the Portenta H7 up for development with the MicroPython core will be released soon. diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/custom-container/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/custom-container/content.md index 72fa4a509e..e5d74c00a3 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/custom-container/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/custom-container/content.md @@ -1,7 +1,7 @@ --- title: Create and Upload a Custom Container to the Portenta X8 difficulty: intermediate -tags: [Linux, Python, Containers, ADB] +tags: [Linux, Python®, Containers, ADB] description: This tutorial will show you how to create and upload your custom container to your Portenta X8 author: Benjamin Dannegård hardware: diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/multi-protocol-gateway/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/multi-protocol-gateway/content.md index 96f6b5d24e..5f1381dee7 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/multi-protocol-gateway/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/multi-protocol-gateway/content.md @@ -64,7 +64,7 @@ Foremost, you will get to know how the multi-protocol gateway will be implemente The Arduino layer is extended within the M4 Core and it is the layer dedicated to the development of real time operations. Thus, you can use the Arduino layer to perform PID tasks and make the RPC calls to exchange data with the Linux layer. -***To learn about how to exchange data using RPC between Arduino and Linux layer, please read ["Data Exchange Between Python on Linux and an Arduino Sketch"](https://docs.arduino.cc/tutorials/portenta-x8/python-arduino-data-exchange)*** +***To learn about how to exchange data using RPC between Arduino and Linux layer, please read ["Data Exchange Between Python® on Linux and an Arduino Sketch"](https://docs.arduino.cc/tutorials/portenta-x8/python-arduino-data-exchange)*** We will go through how to use RPC to expose data received from the Arduino layer to the Linux layer, if further development requires you to feed data to devices interfaced communicating with the M4 core. We will leave the tasks running and open to be interfaced with for expanding the capability of the Portenta X8 and Max Carrier. It will let you develop a gateway system where: @@ -79,7 +79,7 @@ It is important to understand that **all networking processes are made within th The Portenta X8 provides Wi-Fi connectivity and the Portenta Max Carrier provides a LoRaWAN® module that can help us communicate with The Things Network. We will use the MQTT protocol to receive sensor data transmitted by an end device. -We will use a Python script that will configure and handle the connectivity modules and its sensor data. The RPC calls will be used to expose the received sensor data to the Arduino layer, setting up data exchange configuration to further expand the capability of the Portenta X8 and Max Carrier. The process can also be done vice-versa and makes use of the Arduino layer to transmit the data to the Linux layer from the local end-device. +We will use a Python® script that will configure and handle the connectivity modules and its sensor data. The RPC calls will be used to expose the received sensor data to the Arduino layer, setting up data exchange configuration to further expand the capability of the Portenta X8 and Max Carrier. The process can also be done vice-versa and makes use of the Arduino layer to transmit the data to the Linux layer from the local end-device. Now that we know the roles of Arduino and Linux layer, we will need a clear picture on how the multi-protocol gateway should look. The next diagram illustrates the in-depth multi-protocol gateway architecture, showing how each layer and module will cooperate. @@ -132,7 +132,7 @@ To access the logs of `py-serialrpc` service, while maintaining the same directo sudo docker-compose logs -f --tail 20 ``` -***For more details about how data exchange between Arduino and Linux layer works and to understand how to debug, please read [Data Exchange Between Python on Linux and an Arduino Sketch](https://docs.arduino.cc/tutorials/portenta-x8/python-arduino-data-exchange)*** +***For more details about how data exchange between Arduino and Linux layer works and to understand how to debug, please read [Data Exchange Between Python® on Linux and an Arduino Sketch](https://docs.arduino.cc/tutorials/portenta-x8/python-arduino-data-exchange)*** In case you have not configured internal Wi-Fi connectivity within the system, please use following command line. @@ -190,9 +190,9 @@ pycayennelpp paho-mqtt ``` -### Multi-Protocol Python Application +### Multi-Protocol Python® Application -This is the main Python script that will handle overall networking process. We will highlight important fragments of the code to help you understand how these codes pieces work together to build a gateway based on multiple protocols. For full Python script please refer to the files [here](assets/Multi_Protocol_Gateway_X8.zip). +This is the main Python® script that will handle overall networking process. We will highlight important fragments of the code to help you understand how these codes pieces work together to build a gateway based on multiple protocols. For full Python® script please refer to the files [here](assets/Multi_Protocol_Gateway_X8.zip). First up, the configuration for the M4 Proxy Server, which are the parameters that handles communication with the M4 core that extends the Arduino layer. The `m4_proxy_port` is configured to `5001`, as it is the port used by clients to send the data to the M4. @@ -207,7 +207,7 @@ m4_proxy_address = 'm4-proxy' m4_proxy_port = 5001 ``` -The next function is dedicated to retrieve data from the M4 (Arduino layer). It will help you set the variables, such as sensor data, to then be pulled and be exposed to the Linux layer. With this, you will have the information available to be used within the Python script. +The next function is dedicated to retrieve data from the M4 (Arduino layer). It will help you set the variables, such as sensor data, to then be pulled and be exposed to the Linux layer. With this, you will have the information available to be used within the Python® script. ```python def get_data_from_m4(): @@ -486,7 +486,7 @@ You will be able to see following results when the image is built successfully. ***If you have created the Docker container previously and want to re-create it with new changes made outside the shell, please check that the container and its build directory is stopped and removed. This is for the convenience of having a clean working environment*** -After a successful container build, you will have to make the image run. To do that, you can use the following command. This command will immediately give an output in your terminal, telling you how the Python script is running. If you wish to have it running in the background, please add `-d` flag at the end of the command. +After a successful container build, you will have to make the image run. To do that, you can use the following command. This command will immediately give an output in your terminal, telling you how the Python® script is running. If you wish to have it running in the background, please add `-d` flag at the end of the command. ``` #Multi_Protocol_Gateway_X8 sudo docker-compose up diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md index 327954cd26..a64e2573c9 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md @@ -36,7 +36,7 @@ Once the Portenta X8 is plugged in via USB, you can open your browser and go to * [Configure Wi-Fi](#connecting-to-your-wi-fi) * [Add your device to FoundriesFactory (OTA)](#add-a-new-device-to-your-factory) * Board details -* Shell (alpine python) +* Shell (alpine Python®) ## Connecting to Your Wi-Fi diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/python-arduino-data-exchange/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/python-arduino-data-exchange/content.md index 2b6d2c37dd..d4733f15a3 100644 --- a/content/hardware/04.pro/boards/portenta-x8/tutorials/python-arduino-data-exchange/content.md +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/python-arduino-data-exchange/content.md @@ -1,9 +1,9 @@ --- -title: 'Data Exchange Between Python on Linux and an Arduino Sketch' -description: 'This tutorial will show you how to run a python application that exchanges data with an Arduino Sketch.' +title: 'Data Exchange Between Python® on Linux and an Arduino Sketch' +description: 'This tutorial will show you how to run a Python® application that exchanges data with an Arduino Sketch.' tags: - RPC - - Python + - Python® author: 'Sebastian Romero' hardware: - hardware/04.pro/boards/portenta-x8 @@ -11,7 +11,7 @@ hardware: ## Overview -The container infrastructure provided by Arduino contains a pre-built Python image that you can use to run python applications on the Portenta X8. In this tutorial we're going to build a container based on a provided one. While all the peripherals can be accessed from the iMX8 processor running the Linux environment, it can be useful to let the onboard microcontroller take care of certain peripheral handling and just exchange the required data between the microcontroller and the Python application. In this tutorial you will learn how to do that. If you haven't done so, read through the [foundations article](/tutorials/portenta-x8/x8-fundamentals) to understand the fundamental concepts of the X8 and the provided infrastructure. +The container infrastructure provided by Arduino contains a pre-built Python® image that you can use to run Python® applications on the Portenta X8. In this tutorial we're going to build a container based on a provided one. While all the peripherals can be accessed from the iMX8 processor running the Linux environment, it can be useful to let the onboard microcontroller take care of certain peripheral handling and just exchange the required data between the microcontroller and the Python® application. In this tutorial you will learn how to do that. If you haven't done so, read through the [foundations article](/tutorials/portenta-x8/x8-fundamentals) to understand the fundamental concepts of the X8 and the provided infrastructure. ## Goals @@ -26,13 +26,13 @@ The container infrastructure provided by Arduino contains a pre-built Python ima - [Portenta breakout](https://docs.arduino.cc/hardware/portenta-breakout) board - Any sensor (in this example we'll use an [BME680](https://www.bosch-sensortec.com/products/environmental-sensors/gas-sensors/bme680/) I2C module) -## Python on the X8 +## Python® on the X8 -Python is a modern and powerful scripting language that can be used for all sorts of use cases. In this tutorial we only read sensor data from an Arduino sketch without doing anything interesting with it, but you could extend the example and process the data further. +Python® is a modern and powerful scripting language that can be used for all sorts of use cases. In this tutorial we only read sensor data from an Arduino sketch without doing anything interesting with it, but you could extend the example and process the data further. ### Communication Between Linux and Arduino Sketches -The python script will run on the Linux side and therefore on the iMX8 processor. The Arduino sketch on the other hand will run on the STM32H747 microcontroller. That allows for real-time processing on the Arduino side while running a fully fledged operating system on iMX8. However the two processors need a communication mechanism to exchange data with one another. The communication mechanism that is being used is referred to as RPC (Remote Procedure Call). To facilitate the communication the M7 core on the STM32H747 microcontroller is used which hands over any data / request to the M4 core. That means your Arduino sketch will solely run on the M4 core. Dual core processing on the Arduino side is currently not supported. +The Python® script will run on the Linux side and therefore on the iMX8 processor. The Arduino sketch on the other hand will run on the STM32H747 microcontroller. That allows for real-time processing on the Arduino side while running a fully fledged operating system on iMX8. However the two processors need a communication mechanism to exchange data with one another. The communication mechanism that is being used is referred to as RPC (Remote Procedure Call). To facilitate the communication the M7 core on the STM32H747 microcontroller is used which hands over any data / request to the M4 core. That means your Arduino sketch will solely run on the M4 core. Dual core processing on the Arduino side is currently not supported. On the Linux side there is a service that takes care of sending data between the two worlds. It's called `m4-proxy`. You can check if the service is running by logging into the X8 via `adb shell` and then executing `sudo journalctl -fu m4-proxy`. If, for whatever reason, the service has stopped, you can restart it with `sudo systemctl restart m4-proxy` @@ -73,9 +73,9 @@ Log into the X8 shell with `adb shell` and navigate into the `serialrpc` folder. Check if the container is running by executing `sudo docker ps`. You can then access the log of this service at any time by executing `sudo docker-compose logs -f --tail 20` from the **same directory**. If you don't run the container in the background (skip the `-d` flag), you will get the console output directly in the executing shell. Once the container is running you will see the messages that are being sent from the M4. -## The Python Application +## The Python® Application -The Python application requests the sensor data from the M4 over RPC and unpacks the message. Data can be requested by calling the function exposed over RPC on the M4 e.g.: +The Python® application requests the sensor data from the M4 over RPC and unpacks the message. Data can be requested by calling the function exposed over RPC on the M4 e.g.: ```python m4_proxy_address = 'm4-proxy' @@ -85,7 +85,7 @@ rpc_client = RpcClient(rpc_address) temperature = rpc_client.call('temperature') ``` -The files for the complete Python application can be found in the same package as the Arduino sketch (see above). Upload the `python-sensor-rpc` folder to the X8 via `adb push python-sensor-rpc /home/fio`. Log into the X8 via `adb shell`. Then navigate into the `python-sensor-rpc` folder and execute `sudo docker build . -t python-sensor-rpc`. When it's done you can run the container with `sudo docker-compose up`. After a few seconds you should see the output from the Python application featuring the sensor readings on the M4 that were piped through the RPC mechanism. The output should look similar to the following: +The files for the complete Python® application can be found in the same package as the Arduino sketch (see above). Upload the `python-sensor-rpc` folder to the X8 via `adb push python-sensor-rpc /home/fio`. Log into the X8 via `adb shell`. Then navigate into the `python-sensor-rpc` folder and execute `sudo docker build . -t python-sensor-rpc`. When it's done you can run the container with `sudo docker-compose up`. After a few seconds you should see the output from the Python® application featuring the sensor readings on the M4 that were piped through the RPC mechanism. The output should look similar to the following: ``` python-sensor-rpc_1 | ============================================ @@ -99,7 +99,7 @@ python-sensor-rpc_1 | Gas: 136.496 python-sensor-rpc_1 | Altitude: 311.0769348144531 ``` - Keep in mind that, whenever you change anything in the Python script on your computer you will have to sync it back to the X8 and re-build the container: + Keep in mind that, whenever you change anything in the Python® script on your computer you will have to sync it back to the X8 and re-build the container: ``` # On your computer @@ -111,11 +111,11 @@ sudo docker build . -t python-sensor-rpc sudo docker-compose up ``` -Alternatively you could modify the files directly on the X8 using an editor such as VIM so you don't need to upload the files all the time. Re-building the container will be necessary in any case though. In case you wonder how to specify the python script that is executed when running a container, have a look at the `Dockerfile` file. There you'll find the `ENTRYPOINT` command that takes multiple arguments. In our example: `ENTRYPOINT [ "python3", "m4_to_python.py"]` +Alternatively you could modify the files directly on the X8 using an editor such as VIM so you don't need to upload the files all the time. Re-building the container will be necessary in any case though. In case you wonder how to specify the Python® script that is executed when running a container, have a look at the `Dockerfile` file. There you'll find the `ENTRYPOINT` command that takes multiple arguments. In our example: `ENTRYPOINT [ "python3", "m4_to_python.py"]` ## Conclusion -In this tutorial you learned how to use the docker infrastructure to build a container that runs a python application. You have also learned how to use the RPC mechanism to exchange data between the microcontroller and the iMX8 which runs the Linux operating system. +In this tutorial you learned how to use the docker infrastructure to build a container that runs a Python® application. You have also learned how to use the RPC mechanism to exchange data between the microcontroller and the iMX8 which runs the Linux operating system. ### Next Steps diff --git a/content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/x8-getting-started/content.md b/content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/x8-getting-started/content.md index d8edea6848..9f5bdbcb57 100644 --- a/content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/x8-getting-started/content.md +++ b/content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/x8-getting-started/content.md @@ -17,7 +17,7 @@ software: ## Introduction -Using the Portenta X8 with the Portenta Max Carrier enables a large suite of peripherals and features. With the Portenta X8 it is possible to use Linux containers and python scripts, it is also possible to use the M4 core on the board to interface with the Portenta Max Carrier. In this tutorial we will focus on the peripherals and features that are available to us. +Using the Portenta X8 with the Portenta Max Carrier enables a large suite of peripherals and features. With the Portenta X8 it is possible to use Linux containers and Python® scripts, it is also possible to use the M4 core on the board to interface with the Portenta Max Carrier. In this tutorial we will focus on the peripherals and features that are available to us. ## Goals @@ -85,7 +85,7 @@ The Portenta Max Carrier carries a cellular modem SARA-R412M-02B to carry out ta ![LoRa® and GSM peripherals on the Max Carrier](assets/lora-on-max-carrier.svg) -If you want to use this feature with python scripts, have a look at the [Modem Manager api](https://github.com/freedesktop/ModemManager). +If you want to use this feature with Python® scripts, have a look at the [Modem Manager api](https://github.com/freedesktop/ModemManager). ### LoRa® @@ -116,7 +116,7 @@ The Portenta Max Carrier and the Portenta X8 are connected with High Density con If you wish to use the Portenta X8 and Max Carrier with the Arduino IDE, please follow our [Uploading sketches to Arduino Portenta X8 tutorial](./tutorials/uploading-sketches-m4). Also, make sure that you have the latest version of the Portenta Core installed. Go to **Tools > Boards > board manager...** and search for **Arduino Mbed OS Portenta boards**. When this is installed and your Portenta X8 board is connected to the computer, the board should be assigned a port in the Arduino IDE. -If you want to use the Portenta X8 and Max Carrier with a FoundriesFactory, python scripts and Linux containers, Please take a look at our [Portenta X8 Getting started tutorial](./tutorials/portenta-x8/out-of-the-box). You may also find our tutorial on how to [manage dockers on the Portenta X8](https://docs.arduino.cc/tutorials/portenta-x8/docker-container) useful. +If you want to use the Portenta X8 and Max Carrier with a FoundriesFactory, Python® scripts and Linux containers, Please take a look at our [Portenta X8 Getting started tutorial](./tutorials/portenta-x8/out-of-the-box). You may also find our tutorial on how to [manage dockers on the Portenta X8](https://docs.arduino.cc/tutorials/portenta-x8/docker-container) useful. ## Quick Reference Tables for the Portenta Max Carrier diff --git a/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/blob-detection/content.md b/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/blob-detection/content.md index b2f8b69834..f5ae63ee1e 100644 --- a/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/blob-detection/content.md +++ b/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/blob-detection/content.md @@ -104,7 +104,7 @@ import image # Import module containing machine vision algorithms import time # Import module for tracking elapsed time ``` -A module in Python is a confined bundle of functionality. By importing it into the script, it gets made available. +A module in Python® is a confined bundle of functionality. By importing it into the script, it gets made available. ### 2. Preparing the Sensor diff --git a/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/ethernet-with-ide/content.md b/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/ethernet-with-ide/content.md index a42a6dbd9f..4893c93f91 100644 --- a/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/ethernet-with-ide/content.md +++ b/content/hardware/04.pro/shields/portenta-vision-shield/tutorials/ethernet-with-ide/content.md @@ -123,7 +123,7 @@ First, some connection tests are made and printed in the Serial Monitor. After t ## Conclusion -This tutorial showed how to connect the Portenta H7 with a Vision Shield Ethernet to the Internet, with an example sketch in the Arduino IDE. The sketch allowed the board to connect to a website and print its content in the Serial Monitor. The Portenta H7 and Vision Shield can also be used with OpenMV, have a look at the [OpenMV Ethernet tutorial](https://docs.arduino.cc/tutorials/portenta-vision-shield/ethernet-with-openmv) if you want to see a similar example with python. +This tutorial showed how to connect the Portenta H7 with a Vision Shield Ethernet to the Internet, with an example sketch in the Arduino IDE. The sketch allowed the board to connect to a website and print its content in the Serial Monitor. The Portenta H7 and Vision Shield can also be used with OpenMV, have a look at the [OpenMV Ethernet tutorial](https://docs.arduino.cc/tutorials/portenta-vision-shield/ethernet-with-openmv) if you want to see a similar example with Python®. ### Next Steps diff --git a/content/hardware/06.nicla/boards/nicla-vision/tutorials/blob-detection/content.md b/content/hardware/06.nicla/boards/nicla-vision/tutorials/blob-detection/content.md index 77b2e2686c..54e5d327c9 100644 --- a/content/hardware/06.nicla/boards/nicla-vision/tutorials/blob-detection/content.md +++ b/content/hardware/06.nicla/boards/nicla-vision/tutorials/blob-detection/content.md @@ -78,7 +78,7 @@ import image # Import module containing machine vision algorithms import time # Import module for tracking elapsed time ``` -A module in Python is a confined bundle of functionality. By importing it into the script it gets made available. +A module in Python® is a confined bundle of functionality. By importing it into the script it gets made available. ### 2. Preparing the Sensor diff --git a/content/hardware/06.nicla/boards/nicla-vision/tutorials/getting-started/content.md b/content/hardware/06.nicla/boards/nicla-vision/tutorials/getting-started/content.md index f902b1a80e..ebe9c7dc91 100644 --- a/content/hardware/06.nicla/boards/nicla-vision/tutorials/getting-started/content.md +++ b/content/hardware/06.nicla/boards/nicla-vision/tutorials/getting-started/content.md @@ -73,7 +73,7 @@ Create a new script by clicking the "New File" button in the toolbar on the left import pyb # Import module for board related functions ``` -A module in Python is a confined bundle of functionality. By importing it into the script, it becomes available. For this example you will only need `pyb`, which is a module that contains board related functionality such as PIN handling. You can read more about its functions [here](https://docs.micropython.org/en/latest/library/pyb.html). +A module in Python® is a confined bundle of functionality. By importing it into the script, it becomes available. For this example you will only need `pyb`, which is a module that contains board related functionality such as PIN handling. You can read more about its functions [here](https://docs.micropython.org/en/latest/library/pyb.html). Now you can create the variables that will control our built-in RGB LED. With `pyb` you can easily control each color. diff --git a/content/hardware/_unlisted/old-datasheets/portenta-h7-full/datasheet.md b/content/hardware/_unlisted/old-datasheets/portenta-h7-full/datasheet.md index b93658613a..bd0a2841c8 100644 --- a/content/hardware/_unlisted/old-datasheets/portenta-h7-full/datasheet.md +++ b/content/hardware/_unlisted/old-datasheets/portenta-h7-full/datasheet.md @@ -248,7 +248,7 @@ Both processors can share all the peripherals and resources and both can run the * MicroPython/Javascript interpreter * TensorFlow Lite -In all combinations of applications it is possible to invoke synchronous or asynchronous API calls. For example it is possible to extend Python language with functions implemented as Arduino sketches that are executed in parallel to other python functions by the opposite core. +In all combinations of applications it is possible to invoke synchronous or asynchronous API calls. For example it is possible to extend Python® language with functions implemented as Arduino sketches that are executed in parallel to other Python® functions by the opposite core. Processor’s various power modes allow quickly switching between high performance and very low power configurations, optimizing power consumption whenever cores are idle. diff --git a/content/hardware/_unlisted/old-datasheets/portenta-h7-lite-connected/datasheet.md b/content/hardware/_unlisted/old-datasheets/portenta-h7-lite-connected/datasheet.md index 682b9023b2..42300bad03 100644 --- a/content/hardware/_unlisted/old-datasheets/portenta-h7-lite-connected/datasheet.md +++ b/content/hardware/_unlisted/old-datasheets/portenta-h7-lite-connected/datasheet.md @@ -235,7 +235,7 @@ Both processors can share all the peripherals and resources and both can run the * MicroPython/Javascript interpreter * TensorFlow Lite -In all combinations of applications it is possible to invoke synchronous or asynchronous API calls. For example it is possible to extend Python language with functions implemented as Arduino sketches that are executed in parallel to other python functions by the opposite core. +In all combinations of applications it is possible to invoke synchronous or asynchronous API calls. For example it is possible to extend Python® language with functions implemented as Arduino sketches that are executed in parallel to other Python® functions by the opposite core. Processor’s various power modes allow quickly switching between high performance and very low power configurations, optimizing power consumption whenever cores are idle. diff --git a/content/hardware/_unlisted/old-datasheets/portenta-h7-lite/datasheet.md b/content/hardware/_unlisted/old-datasheets/portenta-h7-lite/datasheet.md index 1f8d1eaa23..c43668cda6 100644 --- a/content/hardware/_unlisted/old-datasheets/portenta-h7-lite/datasheet.md +++ b/content/hardware/_unlisted/old-datasheets/portenta-h7-lite/datasheet.md @@ -199,7 +199,7 @@ Both processors can share all the peripherals and resources and both can run the * MicroPython/Javascript interpreter * TensorFlow Lite -In all combinations of applications it is possible to invoke synchronous or asynchronous API calls. For example it is possible to extend Python language with functions implemented as Arduino sketches that are executed in parallel to other python functions by the opposite core. +In all combinations of applications it is possible to invoke synchronous or asynchronous API calls. For example it is possible to extend Python® language with functions implemented as Arduino sketches that are executed in parallel to other Python® functions by the opposite core. Processor’s various power modes allow quickly switching between high performance and very low power configurations, optimizing power consumption whenever cores are idle. diff --git a/content/learn/03.programming/01.variables/variables.md b/content/learn/03.programming/01.variables/variables.md index 3bab640a29..2ac6392610 100644 --- a/content/learn/03.programming/01.variables/variables.md +++ b/content/learn/03.programming/01.variables/variables.md @@ -93,4 +93,4 @@ Why, you might be wondering, wouldn't you make all your variables global? After [block scope] [size of variables] -[1] In some languages, like Python, types are associated with values, not variable names, and you can assign values of any type to a variable. This is referred to as *dynamic typing*. \ No newline at end of file +[1] In some languages, like Python®, types are associated with values, not variable names, and you can assign values of any type to a variable. This is referred to as *dynamic typing*. \ No newline at end of file diff --git a/content/learn/03.programming/05.arduino-and-python/arduino-and-python.md b/content/learn/03.programming/05.arduino-and-python/arduino-and-python.md index e717ae5c4d..67091d6af4 100644 --- a/content/learn/03.programming/05.arduino-and-python/arduino-and-python.md +++ b/content/learn/03.programming/05.arduino-and-python/arduino-and-python.md @@ -11,7 +11,7 @@ hero_position: 1 ***To download the firmware required to run MicroPython on your Arduino board, visit the [Arduino MicroPython downloads page](/micropython).*** -[MicroPython](https://micropython.org/) is an implementation of the [Python programming language](https://www.python.org/) that comes with a subset of the Python standard library, and is designed **to run on microcontrollers**. +[MicroPython](https://micropython.org/) is an implementation of the [Python® programming language](https://www.python.org/) that comes with a subset of the Python® standard library, and is designed **to run on microcontrollers**. A great advantage of using MicroPython is that it is easy to learn and has [great documentation](http://docs.micropython.org/en/latest/) for a number of boards. At the moment, there are four boards that can be used together with MicroPython, you can read more about them in the [compatible boards section](#compatible-boards). @@ -82,7 +82,7 @@ If you need help getting started with MicroPython on the **Nano 33 BLE** board, - [Install MicroPython on your Nano BLE](/tutorials/nano-33-ble-sense/micropython-installation#arduino-nano-33-ble). - [Getting started with OpenMV and Nano 33 BLE](/tutorials/nano-33-ble/getting-started-omv) -- [Nano 33 BLE Python API guide](/tutorials/nano-33-ble/ble-python-api) (a collection of useful scripts). +- [Nano 33 BLE Python® API guide](/tutorials/nano-33-ble/ble-python-api) (a collection of useful scripts). ***To reset the bootloader on the Nano 33 BLE board, double tap the reset button quickly. This will reset your board to factory setting.*** @@ -94,7 +94,7 @@ If you need help getting started with MicroPython on the **Nano 33 BLE Sense** b - [Install MicroPython on your Nano BLE Sense](/tutorials/nano-33-ble-sense/micropython-installation#arduino-nano-33-ble). - [Getting started with OpenMV and Nano 33 BLE Sense](/tutorials/nano-33-ble-sense/getting-started-omv) -- [Nano 33 BLE Sense Python guide](/tutorials/nano-33-ble-sense/ble-sense-python-api) (a collection of useful scripts). +- [Nano 33 BLE Sense Python® guide](/tutorials/nano-33-ble-sense/ble-sense-python-api) (a collection of useful scripts). ***To reset the bootloader on the Nano 33 BLE Sense board, double tap the reset button quickly. This will reset your board to factory setting.*** @@ -105,7 +105,7 @@ If you need help getting started with MicroPython on the **Nano 33 BLE Sense** b If you need help getting started with MicroPython on the **Nano RP2040 Connect** board, you can check out the tutorials below: - [Install MicroPython on your Nano RP2040 Connect](/tutorials/nano-rp2040-connect/micropython-installation#arduino-nano-rp2040-connect) -- [Nano RP2040 Connect Python guide](/tutorials/nano-rp2040-connect/rp2040-python-api) +- [Nano RP2040 Connect Python® guide](/tutorials/nano-rp2040-connect/rp2040-python-api) - [Getting Started with OpenMV and MicroPython on Nano RP2040 Connect](/tutorials/nano-rp2040-connect/rp2040-openmv-setup) @@ -120,9 +120,9 @@ If you need help getting started with MicroPython on the **Portenta H7** board, - [Install MicroPython on Portenta H7](/tutorials/portenta-h7/micropython-installation#arduino-portenta-h7). - [Getting Started with OpenMV and MicroPython on Portenta H7](https://docs.arduino.cc/tutorials/portenta-h7/por-openmv-gs) -## Learn Python +## Learn Python® -As MicroPython is an implementation of the Python language, you can also run a lot of Python scripts directly on the board. For example, running this python script on your computer also works when running it on your board. +As MicroPython is an implementation of the Python® language, you can also run a lot of Python® scripts directly on the board. For example, running this Python® script on your computer also works when running it on your board. ```python value1 = 2 @@ -131,23 +131,23 @@ value2 = 5 print(value1 + value2) ``` -This means it's time to learn the **Python** language, which there is a lot of resources for. We recommend taking a look at the following resources to better understand the Python language: +This means it's time to learn the **Python®** language, which there is a lot of resources for. We recommend taking a look at the following resources to better understand the Python® language: - [python.org](https://www.python.org/) - [learnpython.org](https://www.learnpython.org/) -- [w3schools guide to Python](https://www.w3schools.com/python/default.asp) +- [w3schools guide to Python®](https://www.w3schools.com/python/default.asp) ### MicroPython Docs -Visit the [MicroPython documentation](https://docs.micropython.org/en/latest/) for an understanding on how Python runs on microcontrollers. +Visit the [MicroPython documentation](https://docs.micropython.org/en/latest/) for an understanding on how Python® runs on microcontrollers. -***Note that many examples in the MicroPython Docs will not work directly with Arduino boards, but will provide an understanding of how Python can run on your board.*** +***Note that many examples in the MicroPython Docs will not work directly with Arduino boards, but will provide an understanding of how Python® can run on your board.*** ## API Below you will find some useful examples that can be used by any Arduino board. For more specific features, such as on-board sensors, connectivity and communication, please refer to the individual guides: -- [Nano RP2040 Connect Python API guide](/tutorials/nano-rp2040-connect/rp2040-python-api) +- [Nano RP2040 Connect Python® API guide](/tutorials/nano-rp2040-connect/rp2040-python-api) - [Nano BLE API guide](/tutorials/nano-33-ble/ble-python-api) - [Nano BLE Sense API guide](/tutorials/nano-33-ble-sense/ble-sense-python-api) diff --git a/content/retired/01.boards/arduino-yun-with-poe/content.md b/content/retired/01.boards/arduino-yun-with-poe/content.md index 5dcd5c24f2..24e3709868 100644 --- a/content/retired/01.boards/arduino-yun-with-poe/content.md +++ b/content/retired/01.boards/arduino-yun-with-poe/content.md @@ -13,7 +13,7 @@ The **Arduino Yún** is a microcontroller board based on the ATmega32u4 and the NB : In some countries, it is prohibited to sell WiFi enabled devices without government approval. While waiting for proper certification, some local distributors are disabling WiFi functionality. Check with your dealer before purchasing a Yún if you believe you may live in such a country. If you wish to disable WiFi, run this sketch. -The Yún distinguishes itself from other Arduino boards by its ability to communicate with the Linux distribution onboard, offering a powerful networked computer with the ease of an Arduino. In addition to Linux commands like the cURL, you can write your own shell and python scripts for robust interactions. The Yún is similar to the Leonardo with the ATmega32u4, except that it has Linux on board. (has built-in USB communication, eliminating the need for a secondary processor). +The Yún distinguishes itself from other Arduino boards by its ability to communicate with the Linux distribution onboard, offering a powerful networked computer with the ease of an Arduino. In addition to Linux commands like the cURL, you can write your own shell and Python® scripts for robust interactions. The Yún is similar to the Leonardo with the ATmega32u4, except that it has Linux on board. (has built-in USB communication, eliminating the need for a secondary processor). NB: Yun Release 5 The new Arduino Yun R5 differs substantially from the previous release in these features: @@ -36,7 +36,7 @@ This board version comes with the PoE module on board.The **Arduino Yún** is a NB : In some countries, it is prohibited to sell WiFi enabled devices without government approval. While waiting for proper certification, some local distributors are disabling WiFi functionality. Check with your dealer before purchasing a Yún if you believe you may live in such a country. If you wish to disable WiFi, run this sketch. -The Yún distinguishes itself from other Arduino boards by its ability to communicate with the Linux distribution onboard, offering a powerful networked computer with the ease of an Arduino. In addition to Linux commands like the cURL, you can write your own shell and python scripts for robust interactions. The Yún is similar to the Leonardo with the ATmega32u4, except that it has Linux on board. (has built-in USB communication, eliminating the need for a secondary processor). +The Yún distinguishes itself from other Arduino boards by its ability to communicate with the Linux distribution onboard, offering a powerful networked computer with the ease of an Arduino. In addition to Linux commands like the cURL, you can write your own shell and Python® scripts for robust interactions. The Yún is similar to the Leonardo with the ATmega32u4, except that it has Linux on board. (has built-in USB communication, eliminating the need for a secondary processor). NB: Yun Release 5 The new Arduino Yun R5 differs substantially from the previous release in these features: diff --git a/content/retired/01.boards/arduino-yun/content.md b/content/retired/01.boards/arduino-yun/content.md index aad9557bb9..424a07e181 100644 --- a/content/retired/01.boards/arduino-yun/content.md +++ b/content/retired/01.boards/arduino-yun/content.md @@ -13,7 +13,7 @@ The **Arduino Yún** is a microcontroller board based on the ATmega32u4 and the NB : In some countries, it is prohibited to sell WiFi enabled devices without government approval. While waiting for proper certification, some local distributors are disabling WiFi functionality. Check with your dealer before purchasing a Yún if you believe you may live in such a country. -The Yún distinguishes itself from other Arduino boards by its ability to communicate with the Linux distribution onboard, offering a powerful networked computer with the ease of an Arduino. In addition to Linux commands like the cURL, you can write your own shell and python scripts for robust interactions. The Yún is similar to the Leonardo with the ATmega32u4, except that it has Linux on board. (has built-in USB communication, eliminating the need for a secondary processor). +The Yún distinguishes itself from other Arduino boards by its ability to communicate with the Linux distribution onboard, offering a powerful networked computer with the ease of an Arduino. In addition to Linux commands like the cURL, you can write your own shell and Python® scripts for robust interactions. The Yún is similar to the Leonardo with the ATmega32u4, except that it has Linux on board. (has built-in USB communication, eliminating the need for a secondary processor). NB: Yun Release 5 The new Arduino Yun R5 differs substantially from the previous release in these features: diff --git a/content/retired/05.archived-libraries/Ciao/Ciao.md b/content/retired/05.archived-libraries/Ciao/Ciao.md index e827705899..cc978dae84 100644 --- a/content/retired/05.archived-libraries/Ciao/Ciao.md +++ b/content/retired/05.archived-libraries/Ciao/Ciao.md @@ -13,7 +13,7 @@ Arduino Ciao - from now-on simply "Ciao" has been designed and developed to be m Ciao is made of two main parts: - Ciao Library: developed in C; -- Ciao Core: developed in Python; +- Ciao Core: developed in Python®; ![](assets/CiaoArchitecture.png) @@ -25,7 +25,7 @@ This architecture is currently available on the following products: - [Arduino Yún Mini](https://www.arduino.cc/en/Main/ArduinoBoardYunMini) ## Ciao Core -To communicate with the "outside world" the Ciao Library interacts with Ciao Core: the key component of the Ciao technology on the MPU (microprocessor) side. Ciao Core runs over Linino OS, it is developed in python and it has been designed to enable communication with "outside world" via several modules called Connectors. Such connectors communicate with Ciao Core using JSON strings sent over a TCP socket. +To communicate with the "outside world" the Ciao Library interacts with Ciao Core: the key component of the Ciao technology on the MPU (microprocessor) side. Ciao Core runs over Linino OS, it is developed in Python® and it has been designed to enable communication with "outside world" via several modules called Connectors. Such connectors communicate with Ciao Core using JSON strings sent over a TCP socket. Ciao Core, thanks to this smart and effective design, is able to: diff --git a/content/retired/05.archived-libraries/YunBridgeLibrary/YunBridgeLibrary.md b/content/retired/05.archived-libraries/YunBridgeLibrary/YunBridgeLibrary.md index ee892d3f1d..91fa123d67 100644 --- a/content/retired/05.archived-libraries/YunBridgeLibrary/YunBridgeLibrary.md +++ b/content/retired/05.archived-libraries/YunBridgeLibrary/YunBridgeLibrary.md @@ -10,7 +10,7 @@ author: Arduino The [Yún](https://www.arduino.cc/en/Products/ArduinoYUN) has two processors on board. One is an ATmega32U4 like on the [Leonardo](https://www.arduino.cc/en/Main/ArduinoBoardLeonardo). The other is an Atheros 9331, running Linux and the OpenWRT wireless stack, which enables the board to connect to WiFi and Ethernet networks. It is possible to call programs or custom scripts on the Linux system through the Arduino to connect with various internet services. The [Yún Shield](https://www.arduino.cc/en/Main/ArduinoYunShield) shares the same architecture and features, but it is a shield and needs to be attached to a board, where the microcontroller is interfaced with the Atheros processor through hardware Serial port. -The Bridge library simplifies communication between the ATmega32U4 - or the board attached if you use the shield - and the AR9331. Bridge commands from the board microcontroller are interpreted by Python on the AR9331. Its role is to execute programs on the GNU/Linux side when asked by Arduino, provide a shared storage space for sharing data like sensor readings between the Arduino and the Internet, and receiving commands from the Internet and passing them directly to the Arduino. +The Bridge library simplifies communication between the ATmega32U4 - or the board attached if you use the shield - and the AR9331. Bridge commands from the board microcontroller are interpreted by Python® on the AR9331. Its role is to execute programs on the GNU/Linux side when asked by Arduino, provide a shared storage space for sharing data like sensor readings between the Arduino and the Internet, and receiving commands from the Internet and passing them directly to the Arduino. Bridge allows communication in both directions, acting as an interface to the the Linux command line. For a brief explanations of the terminal and executing commands on Linux [see here](https://www.arduino.cc/en/Tutorial/LinuxCLI). diff --git a/content/retired/06.getting-started-guides/ArduinoTian/ArduinoTian.md b/content/retired/06.getting-started-guides/ArduinoTian/ArduinoTian.md index cccb2c39d4..8e2f32df31 100644 --- a/content/retired/06.getting-started-guides/ArduinoTian/ArduinoTian.md +++ b/content/retired/06.getting-started-guides/ArduinoTian/ArduinoTian.md @@ -136,20 +136,20 @@ There are eight status LEDs on the Tian that indicate:TX UART SAMD21, RX UART SA LininoOS is based on OpenWRT distribution with about 3000 package built and available. LininoOS provides a fully writable filesystem with package management with GPG signature. Integrated with LininoIO it is a complete linux system for IoT space. LininoOS features many innovations for your Arduino Tian. -LininoIO is a software framework able to integrate microcontroller features inside the microprocessor environment. You can simply write your application using Node.js, Python, Bash, etc., on linux side using LininoOS to control completely the board and all the devices attacched. +LininoIO is a software framework able to integrate microcontroller features inside the microprocessor environment. You can simply write your application using Node.js, Python®, Bash, etc., on linux side using LininoOS to control completely the board and all the devices attacched. Node.js with Ideino Node.js is a platform built on Chrome's JavaScript runtime for easily building fast, scalable network applications. Node.js uses an event-driven, non-blocking I/O model that makes it lightweight and efficient, perfect for data-intensive real-time applications that run across distributed devices. Ideino is an embedded editor to write and debug your node.js application. All Joyn supported, which is an open source project which provides a universal software framework and core set of system services that enable interoperability among connected products and software applications to create dynamic proximal networks. -#### Python +#### Python® -An installation of Python 2.7 is included with LininoOS, which you can use to write applications or scripts. -For more on Python, visit the Python 2.7 [documentation pages](https://docs.python.org/2/). +An installation of Python® 2.7 is included with LininoOS, which you can use to write applications or scripts. +For more on Python®, visit the Python® 2.7 [documentation pages](https://docs.python.org/2/). #### Install additional software on Linux -The Tian comes with several pieces of software pre-installed on LininoOS, including "curl" and "python". You may want to install other software on the Tian. On Linux systems, additional software can be installed using a tool called the "opkg". +The Tian comes with several pieces of software pre-installed on LininoOS, including `curl` and `python`. You may want to install other software on the Tian. On Linux systems, additional software can be installed using a tool called the `opkg`. You can find pre-compiled packages for LininoOS on their latest version, [here](http://download.linino.org/linino_distro/lininoIO/latest/packages/). #### Resetting the processors (AR9342, WiFi, and SAMD21) diff --git a/content/retired/06.getting-started-guides/ArduinoUnoWiFiChangeFw/ArduinoUnoWiFiChangeFw.md b/content/retired/06.getting-started-guides/ArduinoUnoWiFiChangeFw/ArduinoUnoWiFiChangeFw.md index 5b399ce957..af3758c894 100644 --- a/content/retired/06.getting-started-guides/ArduinoUnoWiFiChangeFw/ArduinoUnoWiFiChangeFw.md +++ b/content/retired/06.getting-started-guides/ArduinoUnoWiFiChangeFw/ArduinoUnoWiFiChangeFw.md @@ -83,7 +83,7 @@ This procedure is **recommended** for all **Operating System** and it is usable **5** - Test the esptool, for example, inserting the below command to read the MAC address: -- python esptool.py -p your port -b baudrate read_mac +- `python esptool.py -p your port -b baudrate read_mac` - Set the baudrate at **9600**. diff --git a/content/retired/06.getting-started-guides/ArduinoYun/ArduinoYun.md b/content/retired/06.getting-started-guides/ArduinoYun/ArduinoYun.md index 98b290eea7..261b951798 100644 --- a/content/retired/06.getting-started-guides/ArduinoYun/ArduinoYun.md +++ b/content/retired/06.getting-started-guides/ArduinoYun/ArduinoYun.md @@ -58,7 +58,7 @@ Now that you have set up and programmed your Yún board, you may find inspiratio ![](./assets/YunParts.png) -In addition to the 32U4 chip, the Yún has an additional processor, an Atheros AR9331, which runs a distribution of Linux for embedded systems named OpenWrt-Yun, based on OpenWrt. A full install of Python 2.7 is included as well. +In addition to the 32U4 chip, the Yún has an additional processor, an Atheros AR9331, which runs a distribution of Linux for embedded systems named OpenWrt-Yun, based on OpenWrt. A full install of Python® 2.7 is included as well. The Yún has a number of different physical characteristics and connectors than the Leonardo. There is an on-board SD slot, Ethernet jack, and a USB-A Host connector. There is no power barrel connector on the Yún; it can be powered from the micro-USB connector. @@ -90,11 +90,11 @@ When interfacing with the OpenWrt-Yun system, you have to use a command line, ei Due to continuous improvements and suggestions coming from both the OpenWrt community and the Arduino community, **version of OpenWrt-Yun installed on your Yún may be out of date**. Please check the [upgrade tutorial](http://arduino.cc/en/Tutorial/YunSysupgrade) and be sure you're running the latest version available. -#### Python +#### Python® -An installation of Python 2.7 is included with OpenWrt-Yun, with which you can write applications or scripts. For more on Python, visit the [Python 2.7 documentation pages](http://docs.python.org/2/). +An installation of Python® 2.7 is included with OpenWrt-Yun, with which you can write applications or scripts. For more on Python®, visit the [Python® 2.7 documentation pages](http://docs.python.org/2/). -If you're getting started with Python for the first time, there are a number of excellent resources on-line. ["Learn Python the Hard Way"](http://learnpythonthehardway.org/book/) will cover everything you need to know to get up and running with your own scripts. +If you're getting started with Python® for the first time, there are a number of excellent resources on-line. ["Learn Python® the Hard Way"](http://learnpythonthehardway.org/book/) will cover everything you need to know to get up and running with your own scripts. #### External storage on the Yún @@ -675,7 +675,7 @@ You can find more details on this example on the [Bridge Example](/en/Tutorial/B #### Install additional software on Linux -The Yún comes with several pieces of software pre-installed on OpenWrt-Yun, including "curl" and "python". You may want to install other software on the Yún. On Linux systems, additional software can be installed using a tool called the "package management system". For more information, refer to the [package manager tutorial](/en/Tutorial/YunPackageManager). +The Yún comes with several pieces of software pre-installed on OpenWrt-Yun, including `curl` and `python`. You may want to install other software on the Yún. On Linux systems, additional software can be installed using a tool called the "package management system". For more information, refer to the [package manager tutorial](/en/Tutorial/YunPackageManager). The text of the Arduino getting started guide is licensed under a [Creative Commons Attribution-ShareAlike 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/). Code samples in the guide are released into the public domain. diff --git a/content/retired/06.getting-started-guides/ArduinoYunLin/ArduinoYunLin.md b/content/retired/06.getting-started-guides/ArduinoYunLin/ArduinoYunLin.md index 9c25e9670a..835e3b30af 100644 --- a/content/retired/06.getting-started-guides/ArduinoYunLin/ArduinoYunLin.md +++ b/content/retired/06.getting-started-guides/ArduinoYunLin/ArduinoYunLin.md @@ -77,7 +77,7 @@ or you can dig in deeper with the [Bridge library and examples](/en/Reference/Yu ![](./assets/YunParts.png) -In addition to the 32U4 chip, the Yún or Yún mini has an additional processor, an Atheros AR9331, which runs a distribution of Linux for embedded systems named LininoOS, based on OpenWrt. A full install of Python 2.7 is included as well. +In addition to the 32U4 chip, the Yún or Yún mini has an additional processor, an Atheros AR9331, which runs a distribution of Linux for embedded systems named LininoOS, based on OpenWrt. A full install of Python® 2.7 is included as well. The Yún or Yún mini has a number of different physical characteristics and connectors than the Leonardo. There is an on-board SD slot, Ethernet jack, and a USB-A Host connector. There is no power barrel connector on the Yún; it can be powered from the micro-USB connector. @@ -101,7 +101,7 @@ There are several status LEDs on the Yún, indicating power, WLAN connection, WA LininoOS is based on OpenWRT distribution with about 3000 package built and available. LininoOS provides a fully writable filesystem with package management with GPG signature. Integrated with LininoIO it is a complete linux system for IoT space. LininoOS features many innovations for your Arduino Yun. -- LininoIO is a software framework able to integrate microcontroller features inside the microprocessor environment. You can simply write your application using Node.js, Python, Bash, etc., on linux side using LininoOS to control completely the board and all the devices attacched. +- LininoIO is a software framework able to integrate microcontroller features inside the microprocessor environment. You can simply write your application using Node.js, Python®, Bash, etc., on linux side using LininoOS to control completely the board and all the devices attacched. - Node.js with Ideino Node.js is a platform built on Chrome's JavaScript runtime for easily building fast, scalable network applications. Node.js uses an event-driven, non-blocking I/O model that makes it lightweight and efficient, perfect for data-intensive real-time applications that run across distributed devices. Ideino is an embedded editor to write and debug your node.js application. @@ -113,16 +113,16 @@ Accessing the web interface is described below. #### Install additional software on Linux -The Yún comes with several pieces of software pre-installed on LininoOS, including "curl" and "python". You may want to install other software on the Yún. On Linux systems, additional software can be installed using a tool called the "opkg". +The Yún comes with several pieces of software pre-installed on LininoOS, including `curl` and `python`. You may want to install other software on the Yún. On Linux systems, additional software can be installed using a tool called the "opkg". You can find pre-compiled packages for LininoOS on their latest version, [here](http://download.linino.org/linino_distro/lininoIO/latest/packages/). When interfacing with the LininoOS system, you have to use a command line, either accessing it through the Arduino's Bridge library, or via SSH. If you are unfamiliar with the command line, you may want to [read about some basics](/en/Tutorial/LinuxCLI) about it and some of the programs that are frequently used. -#### Python +#### Python® -An installation of Python 2.7 is included with LininoOS, with which you can write applications or scripts. For more on Python, visit the [Python 2.7 documentation pages](http://docs.python.org/2/). +An installation of Python® 2.7 is included with LininoOS, with which you can write applications or scripts. For more on Python®, visit the [Python® 2.7 documentation pages](http://docs.python.org/2/). -If you're getting started with Python for the first time, there are a number of excellent resources on-line. ["Learn Python the Hard Way"](http://learnpythonthehardway.org/book/) will cover everything you need to know to get up and running with your own scripts. +If you're getting started with Python® for the first time, there are a number of excellent resources on-line. ["Learn Python® the Hard Way"](http://learnpythonthehardway.org/book/) will cover everything you need to know to get up and running with your own scripts. #### External storage on the Yún diff --git a/content/retired/06.getting-started-guides/ArduinoYunShield/ArduinoYunShield.md b/content/retired/06.getting-started-guides/ArduinoYunShield/ArduinoYunShield.md index 6d0cb12ee2..d49278d6cb 100644 --- a/content/retired/06.getting-started-guides/ArduinoYunShield/ArduinoYunShield.md +++ b/content/retired/06.getting-started-guides/ArduinoYunShield/ArduinoYunShield.md @@ -167,11 +167,11 @@ When interfacing with the OpenWRT system, you have to use a command line, either Due to continuous improvements and suggestions coming from both the OpenWrt community and the Arduino community, **version of OpenWRT installed on your Yún Shield may be out of date**. Please check the [upgrade tutorial](http://arduino.cc/en/Tutorial/YunSysupgrade) and be sure you're running the latest version available. -#### Python +#### Python® -An installation of Python 2.7 is included with OpenWRT, with which you can write applications or scripts. For more on Python, visit the [Python 2.7 documentation pages](http://docs.python.org/2/). +An installation of Python® 2.7 is included with OpenWRT, with which you can write applications or scripts. For more on Python®, visit the [Python® 2.7 documentation pages](http://docs.python.org/2/). -If you're getting started with Python for the first time, there are a number of excellent resources on-line. ["Learn Python the Hard Way"](http://learnpythonthehardway.org/book/) will cover everything you need to know to get up and running with your own scripts. +If you're getting started with Python® for the first time, there are a number of excellent resources on-line. ["Learn Python® the Hard Way"](http://learnpythonthehardway.org/book/) will cover everything you need to know to get up and running with your own scripts. #### Web services @@ -649,7 +649,7 @@ You can find more details on this example on the [Bridge Example](/en/Tutorial/B #### Install additional software on Linux -The Yún Shield comes with several pieces of software pre-installed on OpenWRT, including "curl" and "python". You may want to install other software on the Yún. On Linux systems, additional software can be installed using a tool called the "package management system". For more information, refer to the [package manager tutorial](/en/Tutorial/YunPackageManager). +The Yún Shield comes with several pieces of software pre-installed on OpenWRT, including `curl` and `python`. You may want to install other software on the Yún. On Linux systems, additional software can be installed using a tool called the "package management system". For more information, refer to the [package manager tutorial](/en/Tutorial/YunPackageManager). #### See also diff --git a/content/software/ide-v2/tutorials/ide-v2-fw-cert-uploader/ide-v2-fw-cert-uploader.md b/content/software/ide-v2/tutorials/ide-v2-fw-cert-uploader/ide-v2-fw-cert-uploader.md index e2f7932884..737b574583 100644 --- a/content/software/ide-v2/tutorials/ide-v2-fw-cert-uploader/ide-v2-fw-cert-uploader.md +++ b/content/software/ide-v2/tutorials/ide-v2-fw-cert-uploader/ide-v2-fw-cert-uploader.md @@ -45,9 +45,9 @@ You can read the full changelog of the NINA firmware through the link below: When you are using the [Arduino Cloud](https://create.arduino.cc/iot/things), during the device configuration, your board's firmware is automatically updated so that it can utilize features such as **OTA (Over The Air)** upload. -### Python & Wi-Fi +### Python® & Wi-Fi -To access the Wi-Fi module on the [Nano RP2040 Connect board](https://store.arduino.cc/products/arduino-nano-rp2040-connect) using Python (through [OpenMV](/tutorials/nano-rp2040-connect/rp2040-openmv-setup)), you will need to update the NINA firmware to the latest version. +To access the Wi-Fi module on the [Nano RP2040 Connect board](https://store.arduino.cc/products/arduino-nano-rp2040-connect) using Python® (through [OpenMV](/tutorials/nano-rp2040-connect/rp2040-openmv-setup)), you will need to update the NINA firmware to the latest version. ## Firmware Updater diff --git a/scripts/spell-check.cmd b/scripts/spell-check.cmd index 860d4215c4..ec1ee9f8e6 100644 --- a/scripts/spell-check.cmd +++ b/scripts/spell-check.cmd @@ -3,7 +3,7 @@ pip --version || pip3 --version IF %ERRORLEVEL% NEQ 0 ( cls - ECHO Please install Python from https://www.python.org/downloads/ and Pip following https://pip.pypa.io/en/stable/installation/ + ECHO Please install Python® from https://www.python.org/downloads/ and Pip following https://pip.pypa.io/en/stable/installation/ EXIT /B )