Merge pull request #1489 from arduino/Hannes7eicher/mpy-machine.adc-feature

[MKC-1263] Update digital-analog-pins.md

Author: Hannes7eicher

content/micropython/01.basics/05.digital-analog-pins/digital-analog-pins.md

@@ -7,23 +7,23 @@ micropython_type: basics
 
 In this chapter we will learn about managing digital and analog pins. 
 
-All the compatibles boards have a series of pins, most of these pins work as a general-purpose input/output (GPIO) pin. There are Digital Pins and Analog Pins depending by the signal. We will learn how to use the inputs and outputs.
+All the compatible boards have a series of pins, most of these pins work as a general-purpose input/output (GPIO) pin. There are Digital Pins and Analog Pins depending on the signal. We will learn how to use the inputs and outputs.
 
-There are essentially two types of pins, analog and digital pins. Digital pins can be set to either HIGH (usually 5V or 3.3V) or LOW (0V). You can use that to e.g. read a button state or to toggle an LED.
+There are essentially two types of pins, analog and digital pins. Digital pins can be set to either HIGH (usually 5V or 3.3V) or LOW (0V). You can use that to e.g. read a button state or toggle an LED.
 
 ***Important: unfortunately, the MicroPython implementation does not match the regular pinout of your board. This means, that if you want to use for example, digital pin (5), it might be digital pin (27) on one board, or digital pin (14) on another. Please visit the [Board API article](/micropython/basics/board-api) to see what the pin map for your board is.***
 
 ## Digital Pins
 
-Digital signals have two distinct values: HIGH (1) or LOW (0). You use digital signals in situations where the input or output will have one of those two values. For example you can use a digital signal to turn an LED on or off. 
+Digital signals have two distinct values: HIGH (1) or LOW (0). You use digital signals in situations where the input or output will have one of those two values. For example, you can use a digital signal to turn an LED on or off. 
 
 ### Digital Write
 
 In this section we will introduce the `machine` module to control the state of a pin. In this example, we will name the pin `myLED`.
 
 In MicroPython we can declare a `Pin` with two arguments: Pin number, such as `25`, which defines the number of the pin that you would like to control, and `Pin.OUT`, to declare a pin as output. 
 
-Finally, to turn set the pin to a high or low state, we set the `value` to either `1` or `0`.
+Finally, to turn the pin to a high or low state, we set the `value` to either `1` or `0`.
 
 ```python
 from machine import Pin #import pin function 
@@ -36,7 +36,7 @@ myLED.value(0) #set pin to a low state (0) / OFF
 
 To create the classic "blink" example, we can also import the `time` module, and create a `while` loop.
 
-The following examples blinks the onboard LED every second.
+The following example blinks the onboard LED every second.
 
 ```python
 from machine import Pin
@@ -90,13 +90,13 @@ while True:
 
 ## Analog Pins
 
-An example of analog pin is the ADC class, that supplies an interface to analog-to-digital converters, and figures a single endpoint that can sample a continuous voltage and convert it to a discretised value.
+An example of the analog pin is the ADC class, which supplies an interface to analog-to-digital converters, and figures a single endpoint that can sample a continuous voltage and convert it to a discretized value.
 
 There are four methods to use inside the ADC class: `ADC.init`, `ADC.block()`, `ADC.read_16()` and `ADC.read_uv()`.
 
 ### Analog Read
 
-To read an analog pin, we can use the `ADC.read_u16` command. This reads the specified analog pin, and return an integer in the range 0 - 65535. For this, we need to import `ADC` and `Pin` from the `machine` module.
+To read an analog pin, we can use the `ADC.read_u16` command. This reads the specified analog pin and returns an integer in the range 0 - 65535. For this, we need to import `ADC` and `Pin` from the `machine` module.
 
 ```python
 import machine
@@ -113,11 +113,13 @@ while True:
     time.sleep_ms(500)
 ```
 
+***If you are using an [Arduino Nano RP2040 Connect](https://store.arduino.cc/products/arduino-nano-rp2040-connect), you can also do the following: `adc = ADC("A4")`. For more information check out the example [here](http://docs.arduino.cc/micropython/basics/board-examples#analog-read).***
+
 ## PWM (Pulse Width Modulation)
 
 [PWM](/learn/microcontrollers/analog-output) is used to produce analog results with digital means, by switching ON/OFF a signal rapidly.
 
-As a result, you can simulate a specific voltage written to a pin. In the example below, we write `30000` in a range between 0 - 65535 (16 bits), which if you connect an LED to the pin, it will be on at about "half" capacity.
+As a result, you can simulate a specific voltage written to a pin. In the example below, we write `30000` in a range between 0 - 65535 (16 bits), which if you connect an LED to the pin, will be on at about "half" capacity.
 
 For this, we need to import `PWM` and `Pin` from the `machine` module.
 

content/micropython/01.basics/06.board-examples/board-examples.md

@@ -49,6 +49,20 @@ Before you start using the board's pins, it might be a good idea to check out th
 | D20/A6  | GPIO36 | ADC/NINA-W102 |
 | D21/A7  | GPIO35 | ADC/NINA-W102 |
 
+### Analog Read
+
+***Note: This is currently only available on the nightly build. Follow [this link](https://docs.arduino.cc/micropython/#firmware) to download it.***
+
+To read an analog pin, we can use the `ADC.read_u16` command. This reads the specified analog pin and returns an integer in the range 0 - 65535. For this, we need to import `ADC` from the `machine` module.
+
+```python
+from machine import ADC
+
+while True:
+    adc = ADC("A4")
+    adc.read_u16()
+```
+
 ### Sensors
 
 #### IMU (LSM6DSOX)
@@ -474,6 +488,10 @@ In the MicroPython port of the Nano 33 BLE board, the pinout is the same as the
 | D20/A6  | 28       |
 | D21/A7  | 3        |
 
+### Analog Read
+
+***The following example is currently only possible with the nightly build***
+
 ### LED Control
 
 There are 3 different LEDs that can be accessed on the Nano 33 BLE: **RGB, the built-in LED** and the **power LED**.