MicroPython:Библиотеки/esp32 - История изменений

EducationBot в 14:13, 14 мая 2023

2023-05-14T14:13:39Z

← Предыдущая версия		Версия от 18:13, 14 мая 2023
Строка 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

Myagkij в 16:33, 7 мая 2022

2022-05-07T16:33:55Z

← Предыдущая версия		Версия от 20:33, 7 мая 2022
Строка 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'' как бета-инструмент, интерфейс которого в будущем может поменяться.}}

	=== Конструктор ===		=== Конструктор ===

Myagkij в 15:54, 26 октября 2020

2020-10-26T15:54:36Z

@@ Строка 99: / Строка 99: @@
 * [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.load_binary()|ULP.load_binary(load_addr, program_binary)]]
 * [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.run()|ULP.run(entry_point)]]
 === Константы ===
@@ Строка 109: / Строка 104: @@
 * [[MicroPython:Библиотеки/esp32/Класс ULP/esp32.WAKEUP_ALL_LOW|esp32.WAKEUP_ALL_LOW]]
 * [[MicroPython:Библиотеки/esp32/Класс ULP/esp32.WAKEUP_ANY_HIGH|esp32.WAKEUP_ANY_HIGH]]
 =См.также=

Myagkij в 15:48, 26 октября 2020

2020-10-26T15:48:47Z

← Предыдущая версия		Версия от 19:48, 26 октября 2020
Строка 94:		Строка 94:

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

			* [[MicroPython:Библиотеки/esp32/Класс ULP\|Класс ULP]]
			* [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.set_wakeup_period()\|ULP.set_wakeup_period(period_index, period_us)]]
			* [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.load_binary()\|ULP.load_binary(load_addr, program_binary)]]
			* [[MicroPython:Библиотеки/esp32/Класс ULP/ULP.run()\|ULP.run(entry_point)]]

	• Класс esp32.ULP – этот класс предоставляет доступ к ULP-сопроцессору.		• Класс esp32.ULP – этот класс предоставляет доступ к ULP-сопроцессору.
Строка 101:		Строка 106:

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

			* [[MicroPython:Библиотеки/esp32/Класс ULP/esp32.WAKEUP_ALL_LOW\|esp32.WAKEUP_ALL_LOW]]
			* [[MicroPython:Библиотеки/esp32/Класс ULP/esp32.WAKEUP_ANY_HIGH\|esp32.WAKEUP_ANY_HIGH]]

	• esp32.WAKEUP_ALL_LOW, esp32.WAKEUP_ANY_HIGH – задают логический уровень, на котором будет происходить выход из режима сна.		• esp32.WAKEUP_ALL_LOW, esp32.WAKEUP_ANY_HIGH – задают логический уровень, на котором будет происходить выход из режима сна.

Myagkij: /* Методы */

2020-10-26T15:46:31Z

Методы

@@ Строка 92: / Строка 92: @@
 * [[MicroPython:Библиотеки/esp32/RMT/RMT.loop()|RMT.loop(enable_loop)]]
 * [[MicroPython:Библиотеки/esp32/RMT/RMT.write_pulses()|RMT.write_pulses(pulses, start)]]
 == ULP-сопроцессор ==

Myagkij в 15:40, 26 октября 2020

2020-10-26T15:40:45Z

← Предыдущая версия		Версия от 19:40, 26 октября 2020
Строка 85:		Строка 85:
	* [[MicroPython:Библиотеки/esp32/RMT/esp32.RMT()\|esp32.RMT(channel, *, pin=None, clock_div=8, carrier_freq=0, carrier_duty_percent=50)]]		* [[MicroPython:Библиотеки/esp32/RMT/esp32.RMT()\|esp32.RMT(channel, *, pin=None, clock_div=8, carrier_freq=0, carrier_duty_percent=50)]]

	• esp32.RMT(~~channel,~~ *~~, pin=None,~~ clock_div~~=8, carrier_freq=0, carrier_duty_percent=50~~) ~~– этот класс предоставляет доступ к одному из восьми~~ RMT~~-каналов~~. ~~Аргумент channel нужен обязательно – в нем задается, какой именно~~ RMT~~-канал~~ (0-7) ~~нужно настроить~~. ~~Аргумент pin тоже обязателен – в нем задается, какой именно контакт нужно привязать к~~ RMT~~-каналу~~. ~~Значение в clock_div – это 8-битный делитель входящей частоты~~ (~~80 МГц~~)~~, позволяющий задать разрешение~~ RMT~~-канала~~. Аргумент carrier_freq используется, чтобы активировать функцию несущей частоты и задать ее частоту; значение по умолчанию – «0» (~~не включена~~). ~~Чтобы включить ее~~, ~~задайте в этом аргументе положительное целое число. Значение по умолчанию в аргументе carrier_duty_percent – «50».~~		=== Методы ===

			* [[MicroPython:Библиотеки/esp32/RMT/RMT.source_freq()\|RMT.source_freq()]]
			* [[MicroPython:Библиотеки/esp32/RMT/RMT.clock_div()\|RMT.clock_div()]]
			* [[MicroPython:Библиотеки/esp32/RMT/RMT.wait_done()\|RMT.wait_done(timeout=0)]]
			* [[MicroPython:Библиотеки/esp32/RMT/RMT.loop()\|RMT.loop(enable_loop)]]
			* [[MicroPython:Библиотеки/esp32/RMT/RMT.write_pulses()\|RMT.write_pulses(pulses, start)]]

	~~=== Методы ===~~

	• RMT.source_freq() – возвращает исходную тактовую частоту. В данный момент поменять ее нельзя, поэтому этот метод будет всегда возвращать 80 МГц.		• RMT.source_freq() – возвращает исходную тактовую частоту. В данный момент поменять ее нельзя, поэтому этот метод будет всегда возвращать 80 МГц.

Myagkij: /* Модуль RMT */

2020-10-26T15:37:59Z

Модуль RMT

← Предыдущая версия		Версия от 19:37, 26 октября 2020
Строка 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'' как бета-инструмент, интерфейс которого в будущем может поменяться.}}		{{Спойлер\|Внимание! В реализации модуля ''RMT'' в [[MicroPython]] нет некоторых функций оригинала (самая заметная из которых – это получение импульсов). Рассматривайте ''RMT'' как бета-инструмент, интерфейс которого в будущем может поменяться.}}

	=== Конструктор ===		=== Конструктор ===

			* [[MicroPython:Библиотеки/esp32/RMT/esp32.RMT()\|esp32.RMT(channel, *, pin=None, clock_div=8, carrier_freq=0, carrier_duty_percent=50)]]

	• esp32.RMT(channel, *, pin=None, clock_div=8, carrier_freq=0, carrier_duty_percent=50) – этот класс предоставляет доступ к одному из восьми RMT-каналов. Аргумент channel нужен обязательно – в нем задается, какой именно RMT-канал (0-7) нужно настроить. Аргумент pin тоже обязателен – в нем задается, какой именно контакт нужно привязать к RMT-каналу. Значение в clock_div – это 8-битный делитель входящей частоты (80 МГц), позволяющий задать разрешение RMT-канала. Аргумент carrier_freq используется, чтобы активировать функцию несущей частоты и задать ее частоту; значение по умолчанию – «0» (не включена). Чтобы включить ее, задайте в этом аргументе положительное целое число. Значение по умолчанию в аргументе carrier_duty_percent – «50».		• esp32.RMT(channel, *, pin=None, clock_div=8, carrier_freq=0, carrier_duty_percent=50) – этот класс предоставляет доступ к одному из восьми RMT-каналов. Аргумент channel нужен обязательно – в нем задается, какой именно RMT-канал (0-7) нужно настроить. Аргумент pin тоже обязателен – в нем задается, какой именно контакт нужно привязать к RMT-каналу. Значение в clock_div – это 8-битный делитель входящей частоты (80 МГц), позволяющий задать разрешение RMT-канала. Аргумент carrier_freq используется, чтобы активировать функцию несущей частоты и задать ее частоту; значение по умолчанию – «0» (не включена). Чтобы включить ее, задайте в этом аргументе положительное целое число. Значение по умолчанию в аргументе carrier_duty_percent – «50».

Myagkij в 15:36, 26 октября 2020

2020-10-26T15:36:48Z

← Предыдущая версия		Версия от 19:36, 26 октября 2020
Строка 46:		Строка 46:
	* [[MicroPython:Библиотеки/esp32/Класс Partition/esp32.HEAP_DATA\|esp32.HEAP_DATA]]		* [[MicroPython:Библиотеки/esp32/Класс Partition/esp32.HEAP_DATA\|esp32.HEAP_DATA]]
	* [[MicroPython:Библиотеки/esp32/Класс Partition/esp32.HEAP_EXEC\|esp32.HEAP_EXEC]]		* [[MicroPython:Библиотеки/esp32/Класс Partition/esp32.HEAP_EXEC\|esp32.HEAP_EXEC]]

	• Partition.BOOT, Partition.RUNNING – используются в конструкторе Partition, чтобы вызвать разделы разных типов: BOOT – это раздел, который будет загружен при следующем сбросе, а RUNNING – это раздел, запущенный в данный момент.
	• Partition.TYPE_APP, Partition.TYPE_DATA – используются в методе Partition.find(), чтобы задать тип раздела: APP – это загружаемые прошивочные разделы (обычно имеют метки factory, ota_0, ota_1), а DATA – это другие разделы (например, nvs, otadata, phy_init, vfs).
	~~• esp32.HEAP_DATA, esp32.HEAP_EXEC – используются в idf_heap_info().~~

	== Модуль RMT ==		== Модуль RMT ==

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

	<syntaxhighlight lang="python" enclose="div">		<syntaxhighlight lang="python" enclose="div">
Строка 73:		Строка 69:
	</syntaxhighlight>		</syntaxhighlight>

	Входящая частота модуля RMT составляет 80 МГц (возможно, в будущем ее можно будет менять, но сейчас она фиксированная). Значение в clock_div – это делитель входной частоты, который задает разрешение RMT-канала. Число, заданное в write_pulses, умножается на разрешение – результат задает, какими будут импульсы.		Входящая частота модуля ''RMT'' составляет ''80 МГц'' (возможно, в будущем ее можно будет менять, но сейчас она фиксированная). Значение в ''clock_div'' – это делитель входной частоты, который задает разрешение ''RMT-канала''. Число, заданное в ''write_pulses'', умножается на разрешение – результат задает, какими будут импульсы.
	Значение в clock_div – это 8-битный делитель (0-255), и каждый импульс можно задать, умножив разрешение, полученное с помощью делителя, на 15-битное число (0-32,768). Всего каналов восемь (0-7), и у каждого из них может быть свой делитель частоты.
	Чтобы активировать у ESP32 функцию несущей частоты, задайте в carrier_freq что-то вроде «38000» – это стандартная несущая ИК-частота.		Значение в ''clock_div'' – это ''8''-битный делитель (''0-255''), и каждый импульс можно задать, умножив разрешение, полученное с помощью делителя, на ''15''-битное число (''0-32,768''). Всего каналов восемь (''0-7''), и у каждого из них может быть свой делитель частоты.
	Итак, в примере выше частота 80 МГц делится на 8. В результате получается разрешение (1/(80МГц/8)) 100 нс. Поскольку начальный уровень (start) – это «0», и с каждым новым «тиком» сигнал переключается, получается битовый поток 0101 с сигналами продолжительностью 100 нс, 2000 нс, 200 нс, 4000 нс.
			Чтобы активировать у [[ESP32]] функцию несущей частоты, задайте в ''carrier_freq'' что-то вроде ''«38000»'' – это стандартная несущая ''ИК-частота''.

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

	Более подробно читайте в [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 как бета-инструмент, интерфейс которого в будущем может поменяться.
			{{Спойлер\|Внимание! В реализации модуля ''RMT'' в ''MicroPython'' нет некоторых функций оригинала (самая заметная из которых – это получение импульсов). Рассматривайте ''RMT'' как бета-инструмент, интерфейс которого в будущем может поменяться.}}

	=== Конструктор ===		=== Конструктор ===

Myagkij в 15:27, 26 октября 2020

2020-10-26T15:27:16Z

← Предыдущая версия		Версия от 19:27, 26 октября 2020
Строка 39:		Строка 39:

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

			* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.BOOT\|Partition.BOOT]]
			* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.RUNNING\|Partition.RUNNING]]
			* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.TYPE_APP\|Partition.TYPE_APP]]
			* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.TYPE_DATA\|Partition.TYPE_DATA]]
			* [[MicroPython:Библиотеки/esp32/Класс Partition/esp32.HEAP_DATA\|esp32.HEAP_DATA]]
			* [[MicroPython:Библиотеки/esp32/Класс Partition/esp32.HEAP_EXEC\|esp32.HEAP_EXEC]]

	• Partition.BOOT, Partition.RUNNING – используются в конструкторе Partition, чтобы вызвать разделы разных типов: BOOT – это раздел, который будет загружен при следующем сбросе, а RUNNING – это раздел, запущенный в данный момент.		• Partition.BOOT, Partition.RUNNING – используются в конструкторе Partition, чтобы вызвать разделы разных типов: BOOT – это раздел, который будет загружен при следующем сбросе, а RUNNING – это раздел, запущенный в данный момент.

Myagkij: /* Методы */

2020-10-26T15:24:30Z

Методы

← Предыдущая версия		Версия от 19:24, 26 октября 2020
Строка 37:		Строка 37:
	* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.get_next_update()\|Partition.get_next_update()]]		* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.get_next_update()\|Partition.get_next_update()]]
	* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.mark_app_valid_cancel_rollback()\|Partition.mark_app_valid_cancel_rollback()]]		* [[MicroPython:Библиотеки/esp32/Класс Partition/Partition.mark_app_valid_cancel_rollback()\|Partition.mark_app_valid_cancel_rollback()]]

	• Метод класса Partition.find(type=TYPE_APP, subtype=255, label=None) – находит раздел при помощи типа (type), подтипа (subtype) и метки (label). Возвращает (возможно, пустой) список объектов Partition. Примечание: subtype=0xff соответствует всем подтипам, а label=None соответствует всем меткам.
	~~• Partition.info() – возвращает 6-элементный кортеж: (type, subtype, addr, size, label, encrypted).~~
	• Partition.readblocks(block_num, buf), Partition.readblocks(block_num, buf, offset), Partition.writeblocks(block_num, buf), Partition.writeblocks(block_num, buf, offset), Partition.ioctl(cmd, arg) – в этих методах реализованы простой и [http://docs.micropython.org/en/latest/library/uos.html#block-device-interface расширенный] блочные протоколы, определенные в [http://docs.micropython.org/en/latest/library/uos.html#uos.AbstractBlockDev классе uos.AbstractBlockDev].
	~~• Partition.set_boot() – делает раздел разделом загрузки.~~
	• Partition.get_next_update() – возвращает раздел, который будет обновлен следующим (соответственно, возвращает новый объект Partition). Обычно используется как Partition(Partition.RUNNING).get_next_update(), что вернет раздел, который будет обновлен следующим (с учетом того, что запущен в данный момент).
	• Метод класса Partition.mark_app_valid_cancel_rollback() – сигнализирует о том, что текущая загрузка прошла успешно. Вызов этого метода требуется при первой загрузке нового раздела, чтобы избежать автоматического отката во время следующей загрузки. Этот метод при помощи CONFIG_BOOTLOADER_APP_ROLLBACK_ENABLE использует функцию «отката приложения» (app rollback) ESP-IDF, и если этот метод будет вызван на прошивке, у которой этой функции нет, это выдаст ошибку OSError(-261). Этот метод можно вызывать при каждой загрузке, и не имеет значения, была ли эта прошивка загружена при помощи esptool или нет.

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