## MicroPython

中文页 | [English](README.md)

## 1. Введение

Это портирование MicroPython на RT-Thread, которое может работать на **RT-Thread версии 3.0** и выше. С помощью этого пакета программного обеспечения можно запустить MicroPython во встраиваемых системах с RT-Thread.

Если вы впервые сталкиваетесь с RT-Thread MicroPython, рекомендуется начать с использования официально поддерживаемых плат разработки от RT-Thread для быстрого старта. Эти платы имеют полноценное встроенное ПО и предоставляют исходный код, что подходит для начинающих. Вы можете скачать встроенное ПО с официального сайта поддержки плат [здесь](https://www.rt-thread.org/qa/forum.php?mod=viewthread&tid=12305&extra=page%3D1%26filter%3Dtypeid%26typeid%3D20).

### 1.1 Структура каталогов
| Название | Описание |
| --- | --- |
| docs  | Каталог документов, включая руководство по началу работы и руководства по разработке |
| drivers | Каталог исходного кода MicroPython |
| extmod | Каталог исходного кода MicroPython |
| lib | Каталог исходного кода MicroPython |
| py | Каталог исходного кода MicroPython |
| port | Каталог портированного кода |
| LICENSE | Лицензия MIT для Micropython |

### 1.2 Лицензия

RT-Thread MicroPython следует лицензии MIT, см. файл LICENSE.

### 1.3 Зависимости

- RT-Thread 3.0+

## 2. Как открыть RT-Thread MicroPython

Чтобы использовать пакет MicroPython, выберите его в менеджере пакетов RT-Thread. Путь следующий:

![elect_micropytho](./docs/assets/select_micropython.png)

Затем позвольте менеджеру пакетов RT-Thread автоматически обновить пакеты или используйте команду `pkgs --update`, чтобы обновить пакеты до BSP.

## 3. Использование RT-Thread MicroPython

### 3.1 Добавление пакета в проект

После выбора пакета MicroPython при повторной компиляции bsp он будет добавлен в проект bsp для компиляции.

* Для разработки встроенного ПО обратитесь к руководству по разработке встроенного ПО для MicroPython [в документации](https://www.rt-thread.org/document/site/submodules/micropython/docs/introduction/).

* Чтобы просмотреть дополнительные документы по MicroPython, посетите центр документации RT-Thread [по ссылке](https://www.rt-thread.org/document/site/submodules/micropython/docs/introduction/)

### 3.2 Использование MicroPython IDE

[MicroPython IDE от RT-Thread](https://marketplace.visualstudio.com/items?itemName=RT-Thread.rt-thread-micropython) предоставляет мощную среду разработки для MicroPython. Его можно найти и загрузить через магазин приложений VScode. Пример показан ниже:

![08_direct_run_files](docs/assets/08_direct_run_files.gif)

### 3.3 Добавление C-расширений в MicroPython

Для удобства пользователей, которые хотят добавить свои собственные функции C в Python-скрипты MicroPython, RT-Thread предоставляет генератор кода для привязки C к MicroPython [по этой ссылке](https://summerlife.github.io/RT-MicroPython-Generator/). С помощью этого инструмента пользователи могут легко расширить C-функции. Форма автоматически сгенерированного C-кода показана ниже:

![08_direct_run_files](docs/assets/c-gen.png)

## 4. Замечания

- Требуется версия RT-Thread **3.0 или выше**.
- В меню конфигурации выберите последнюю версию Micropython.
- На данный момент модуль System Module поддерживает только GCC. Также необходимо добавить соответствующую информацию в скрипт компоновщика.

## 5. Ресурсы для разработчиков

* [Форум RT-Thread MicroPython](https://www.rt-thread.org/qa/forum.php)
* [Центр документации RT-Thread MicroPython](https://www.rt-thread.org/document/site/submodules/micropython/docs/introduction/)
* [Присоединяйтесь к группе обсуждения RT-Thread MicroPython](https://jq.qq.com/?_wv=1027&k=5EhyEjx)