Руководство по миграции на MicroPython 2.0

MicroPython 2.0 — это следующий крупный выпуск MicroPython (в настоящее время находится в разработке, ещё не доступен).

После почти десятилетия поддержания совместимости API в серии 1.x, чтобы разблокировать ряд общепроектных улучшений, в MicroPython 2.0 будет внесено небольшое число несовместимых изменений API, которые потребуют обновления некоторых программ. Это руководство объясняет, как обновить ваш код Python с учётом этих изменений.

Этот документ находится в процессе доработки. По мере выполнения работы над MicroPython 2.0 в приведённые ниже списки будут добавляться новые пункты.

Примечание: В настоящее время сборки прошивки MicroPython 2.0 для загрузки недоступны. Вы можете собрать её самостоятельно, включив параметр конфигурации MICROPY_PREVIEW_VERSION_2. По мере приближения к готовности к выпуску будут предоставляться сборки как для 1.x.y, так и для 2.0.0-preview.

Аппаратное обеспечение и периферийные устройства

Обзор

Цель — повысить согласованность API machine между различными портами, чтобы было проще писать код, документацию и руководства, работающие на любом поддерживаемом микроконтроллере.

Это означает, что API некоторых портов должны измениться, чтобы соответствовать другим портам.

Изменения

Пока нет

ОС и файловая система

Обзор

Основная цель — обеспечить возможность выполнять файлы .mpy непосредственно из файловой системы без их предварительного копирования в ОЗУ. Это сокращает время развёртывания кода, уменьшает накладные расходы по памяти и фрагментацию.

Кроме того, ещё одна цель — обеспечить более гибкий способ настройки разделов, типов файловой системы и таких параметров, как USB-накопитель.

Изменения

Пока нет

Совместимость с CPython

Обзор

Цель — повысить совместимость с CPython за счёт удаления расширений MicroPython из API CPython. В большинстве случаев это означает перенос существующих функций или классов, специфичных для MicroPython, в новые модули.

Это упрощает написание кода, работающего как в CPython, так и в MicroPython, что полезно для разработки и тестирования.

Изменения

Введение нового модуля vfs. Следующие функции и классы перенесены из os в vfs:

  • os.mount

  • os.umount

  • os.VfsFat

  • os.VfsLfs1

  • os.VfsLfs2

  • os.VfsPosix