Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Dec 11, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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.

Expand Down
18 changes: 18 additions & 0 deletions content/micropython/01.basics/06.board-examples/board-examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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**.
Expand Down