MicroPython:Содержание
Добро пожаловать в раздел по MicroPython |
|
|
|
|
Содержание ВведениеОсновыБиблиотеки[1]В этом руководстве описаны встроенные в MicroPython модули (библиотеки функций и классов). Эти модули подразделяются на несколько категорий:
Важное примечание о доступности модулей и их содержимом: задача этого справочника – описать все модули и функции/классы проекта MicroPython. Но MicroPython] – это очень гибкая и настраиваемая система, и отдельные MicroPython-порты для разных плат/систем включают в себя лишь часть общего функционала MicroPython. Поэтому, что касается официальных портов, во-первых, разработчики стараются отфильтровать неприменимые элементы, и во-вторых, в данном справочнике некоторые функции помечены предложением «Доступность: ...» с информацией о том, в каких портах они поддерживаются. Поэтому всегда помните, что некоторые функции/классы (или даже весь модуль), даже описанные в этом справочнике, могут быть недоступны в используемом вами MicroPython-порте на используемой вами платформе. Поиск общей информации о наличии/отсутствии функций лучше всего начать с раздела «Общая информация» об используемом вами MicroPython-порте. На некоторых MicroPython-портах список доступных, встроенных библиотек, которые можно импортировать в код, можно узнать, введя в REPL следующее: help('modules')
Помимо встроенных библиотек, описанных здесь, немало модулей из стандартного Python и несколько дополнительных MicroPython-расширений можно найти в проекте «micropython-lib». Стандартные библиотеки Python и микро-библиотекиБиблиотеки, описанные ниже – это стандартные библиотеки Python, «микрофицированные» с целью подогнать их под стандарты MicroPython. Они включают в себя ключевой функционал Python-модулей и служат упрощенной заменой стандартной библиотеки Python. Некоторые модули ниже используют стандартные Python-названия, но с префиксом u – например, ujson вместо json. Это необходимо для того, чтобы показать, что модуль является микро-библиотекой, т.е. в нем реализована только часть функционала CPython. Используя правильное название, пользователь может написать расширяющий Python’овский модуль – чтобы улучшить совместимость с CPython (именно такой метод используется в проекте «micropython-lib», о котором говорилось выше). В некоторых встраиваемых платформах, где может быть проблематично создавать Python’овский модуль-обертку для того, чтобы достичь совместимости названий с CPython, к микро-модулям можно обращаться и по «микро-названию» (с префиксом u), и по обычному названию (без префикса u). Обычное название можно переписать с помощью файла с перезаписанным названием, расположенным в sys.path (списке строк, указывающих пути для поиска модулей). К примеру, import json сначала будет искать файл json.py (или директорию json), и если найдет, то начнет его загрузку. А если не найдет, то перейдет к запасному варианту – загрузке встроенного модуля ujson.
Библиотеки MicroPythonВ библиотеках ниже реализован функционал, который есть только в MicroPython:
Библиотеки для портовВ некоторых портах библиотеки, описываемые ниже, имеют те же функции/классы, что и в библиотеке [[MicroPython:Библиотеки/machine.html#module-machine machine], но в то же время их функционал отличается, так как предназначен для работы с аппаратными элементами, специфичной для используемой платформы. Чтобы написать код для порта, используйте функции/классы из модуля [[MicroPython:Библиотеки/machine.html#module-machine machine]. Чтобы получить доступ к аппаратным элементам, специфичным для платформы, используйте соответствующую библиотеку – например, в случае с Pyboard это будет [[MicroPython:Библиотеки/pyb.html#module-pyb pyb]. Библиотеки для PyboardК числу специальных Pyboard-библиотек относятся:
Библиотеки для WiPyК числу специальных библиотек и классов WiPy относятся:
Библиотеки для ESP8266 и ESP32К числу специальных библиотек ESP8266 и ESP32 относятся: ПлатыESP8266
ESP32
WiPyПрограммыIDEПрошивки[2]Управление исходным кодом при разработке MicroPython осуществляется с помощью Git, и главный репозиторий проекта можно найти на GitHub по этой ссылке. Полную и последнюю версию исходного кода MicroPython можно загрузить отсюда:
Ежедневные «снимки» этого GitHub-репозитория (без подмодулей) можно найти по эти ссылкам: Прошивки для различных микроконтроллерных портов и плат создаются ежедневно, и найти их можно по ссылкам ниже. Кроме того, список всех доступных прошивок можно найти тут. PyBoard v1 и PyBoard серии DПлаты STM32Платы TI CC3200ESP-платы Espressif |