MicroPython:Библиотеки/esp32: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
 
(не показаны 4 промежуточные версии 1 участника)
Строка 51: Строка 51:
Модуль ''RMT'' (от ''«remote control»'', т.е. ''«дистанционное управление»''), использующийся исключительно для [[ESP32]], изначально был создан для отправки и получения инфракрасных сигналов дистанционного управления. Но благодаря гибкой структуре и генерированию импульсов высокой точности (вплоть ''до [[12.5 нс]]'') его также можно использовать для передачи и получения многих других типов цифровых сигналов:
Модуль ''RMT'' (от ''«remote control»'', т.е. ''«дистанционное управление»''), использующийся исключительно для [[ESP32]], изначально был создан для отправки и получения инфракрасных сигналов дистанционного управления. Но благодаря гибкой структуре и генерированию импульсов высокой точности (вплоть ''до [[12.5 нс]]'') его также можно использовать для передачи и получения многих других типов цифровых сигналов:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
import esp32
import esp32
from machine import Pin
from machine import Pin
Строка 79: Строка 79:
Более подробно читайте в [https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/rmt.html документации к модулю RMT для ESP-IDF от Espressif].
Более подробно читайте в [https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/rmt.html документации к модулю RMT для ESP-IDF от Espressif].


{{Спойлер|Внимание! В реализации модуля ''RMT'' в [[MicroPython]] нет некоторых функций оригинала (самая заметная из которых – это получение импульсов). Рассматривайте ''RMT'' как бета-инструмент, интерфейс которого в будущем может поменяться.}}
{{Блок/Инфо4
|1=Внимание
|2=В реализации модуля ''RMT'' в [[MicroPython]] нет некоторых функций оригинала (самая заметная из которых – это получение импульсов). Рассматривайте ''RMT'' как бета-инструмент, интерфейс которого в будущем может поменяться.}}


=== Конструктор ===
=== Конструктор ===
Строка 92: Строка 94:
* [[MicroPython:Библиотеки/esp32/RMT/RMT.loop()|RMT.loop(enable_loop)]]
* [[MicroPython:Библиотеки/esp32/RMT/RMT.loop()|RMT.loop(enable_loop)]]
* [[MicroPython:Библиотеки/esp32/RMT/RMT.write_pulses()|RMT.write_pulses(pulses, start)]]
* [[MicroPython:Библиотеки/esp32/RMT/RMT.write_pulses()|RMT.write_pulses(pulses, start)]]
• RMT.source_freq() – возвращает исходную тактовую частоту. В данный момент поменять ее нельзя, поэтому этот метод будет всегда возвращать 80 МГц.
• RMT.clock_div() – возвращает делитель частоты. Разрешение канала рассчитывается с помощью формулы 1 / (source_freq / clock_div).
• RMT.wait_done(timeout=0) – возвращает True, если канал в данный момент передает поток импульсов, запущенный с помощью вызова RMT.write_pulses().
Если задать аргумент timeout (единица измерения здесь – это число, рассчитанное с помощью source_freq / clock_div), метод подождет период времени, заданный в этом аргументе, или пока передача импульсов не будет завершена, и вернет False, если канал продолжает передачу импульсов. Если на канале при помощи RMT.loop() включена повторяющаяся передача импульсов, а поток импульсов был уже запущен, этот метод всегда будет (ждать и) возвращать False.
• RMT.loop(enable_loop) – включает и выключает повторяющуюся передачу импульсов на канале. В аргументе enable_loop задается булево значение, и если задать в нем True, это включит повторяющуюся передачу импульсов при следующем вызове RMT.write_pulses(). Если вызвать этот метод со значением False во время повторяющейся передачи импульсов, то текущая группа символов будет передана, после чего их передача будет остановлена.
• RMT.write_pulses(pulses, start) – запускает отправку импульсов pulses (поток импульсов задается с помощью списка или кортежа). Длина каждого импульса задается умножением на разрешение канала (1 / (source_freq / clock_div)). В аргументе start задается, будет ли поток начинаться на нуле или единице.
Если на этом канале в данный момент уже ведется отправка потока импульсов, запуск этого метода будет заблокирован, пока этот поток не завершится, после чего начнется отправка потока в pulses.
Если включена повторяющаяся передача импульсов с помощью RMT.loop(), поток импульсов будет повторяться бесконечно. Последующий вызов RMT.write_pulses() остановит предыдущий поток (но перед этим подождет, пока не будет отправлена последняя группа импульсов), а затем начнет новый поток.


== ULP-сопроцессор ==
== ULP-сопроцессор ==


Класс esp32.ULP – этот класс предоставляет доступ к ULP-сопроцессору.
* [[MicroPython:Библиотеки/esp32/Класс ULP|Класс ULP]]
ULP.set_wakeup_period(period_index, period_us) – задает период пробуждения.
* [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.set_wakeup_period()|ULP.set_wakeup_period(period_index, period_us)]]
ULP.load_binary(load_addr, program_binary) – загружает program_binary в ULP-процессор на заданный адрес load_addr.
* [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.load_binary()|ULP.load_binary(load_addr, program_binary)]]
ULP.run(entry_point) – запускает ULP-сопроцессор на заданной entry_point.
* [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.run()|ULP.run(entry_point)]]


=== Константы ===
=== Константы ===


esp32.WAKEUP_ALL_LOW, esp32.WAKEUP_ANY_HIGH – задают логический уровень, на котором будет происходить выход из режима сна.
* [[MicroPython:Библиотеки/esp32/Класс ULP/esp32.WAKEUP_ALL_LOW|esp32.WAKEUP_ALL_LOW]]
 
* [[MicroPython:Библиотеки/esp32/Класс ULP/esp32.WAKEUP_ANY_HIGH|esp32.WAKEUP_ANY_HIGH]]
 
 
 
 
 
 
<syntaxhighlight lang="python" enclose="div">


=См.также=
=См.также=

Текущая версия от 18:13, 14 мая 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Модуль esp32 – функционал ESP32[1]

Модуль esp32 содержит функции и классы, предназначенные исключительно для работы с микроконтроллерами ESP32.

Функции

Класс Partition – разделы flash-памяти

Этот класс предоставляет доступ к разделам flash-памяти устройства и содержит методы для беспроводных (over-the-air или OTA) обновлений.

Конструктор

Методы

Константы

Модуль RMT

Модуль RMT (от «remote control», т.е. «дистанционное управление»), использующийся исключительно для ESP32, изначально был создан для отправки и получения инфракрасных сигналов дистанционного управления. Но благодаря гибкой структуре и генерированию импульсов высокой точности (вплоть до 12.5 нс) его также можно использовать для передачи и получения многих других типов цифровых сигналов:

import esp32
from machine import Pin

r = esp32.RMT(0, pin=Pin(18), clock_div=8)
r  # RMT(channel=0, pin=18, source_freq=80000000, clock_div=8)

# для использования несущей частоты:
r = esp32.RMT(0, pin=Pin(18), clock_div=8, carrier_freq=38000)
r  # RMT(channel=0, pin=18, source_freq=80000000, clock_div=8, carrier_freq=38000, carrier_duty_percent=50)

# разрешение канала – 100 нс (1/(source_freq/clock_div)):
r.write_pulses((1, 20, 2, 40), start=0)  # отправьте «0» для 100 нс,
                                         # «1» для 2000 нс,
                                         # «0» для 200 нс,
                                         # «1» для 4000 нс

Входящая частота модуля RMT составляет 80 МГц (возможно, в будущем ее можно будет менять, но сейчас она фиксированная). Значение в clock_div – это делитель входной частоты, который задает разрешение RMT-канала. Число, заданное в write_pulses, умножается на разрешение – результат задает, какими будут импульсы.

Значение в clock_div – это 8-битный делитель (0-255), и каждый импульс можно задать, умножив разрешение, полученное с помощью делителя, на 15-битное число (0-32,768). Всего каналов восемь (0-7), и у каждого из них может быть свой делитель частоты.

Чтобы активировать у ESP32 функцию несущей частоты, задайте в carrier_freq что-то вроде «38000» – это стандартная несущая ИК-частота.

Итак, в примере выше частота 80 МГц делится на 8. В результате получается разрешение (1/(80МГц/8)) 100 нс. Поскольку начальный уровень (start) – это «0», и с каждым новым «тиком» сигнал переключается, получается битовый поток 0101 с сигналами продолжительностью 100 нс, 2000 нс, 200 нс, 4000 нс.

Более подробно читайте в документации к модулю RMT для ESP-IDF от Espressif.

Внимание

В реализации модуля RMT в MicroPython нет некоторых функций оригинала (самая заметная из которых – это получение импульсов). Рассматривайте RMT как бета-инструмент, интерфейс которого в будущем может поменяться.

Конструктор

Методы

ULP-сопроцессор

Константы

См.также

Внешние ссылки