Ваш первый проект Pymakr

В этом руководстве вы узнаете, как настроить свой первый проект с помощью Pymakr и запустить встроенный светодиод RGB на мигание разными цветами.

Создание проекта в Pymakr

1. Во-первых, нужно создать новый пустой каталог на вашем компьютере. Для этого примера мы создадим папку с именем RGB-Blink.
2. Затем нужно открыть код Atom или Visual Studio в зависимости от того, который вы настроили ранее.
3. После загрузки текстового редактора необходимо нажать «Файл» > «Открыть» и открыть каталог, созданный на шаге 1.

Если вы используете Atom, убедитесь, что Atom успешно идентифицировал проект. Имя каталога, созданного на шаге 1 (в данном случае RGB-Blink), должно отображаться на панели Pymakr следующим образом:

Если это не так, вы можете нажать alt-ctrl-r в Windows / Linux или ctrl-alt-cmd-l в macOS, чтобы перезагрузить Atom и устранить проблему.

Теперь, когда у вас есть проект, нужно добавить в него несколько файлов. Стандартный проект MicroPython имеет следующую структуру:

RGB-Blink
|-lib
|  |- some_library.py
|-boot.py
|-main.py

• boot.py Это первый скрипт, который запускается на вашем модуле, когда он включается. Он часто используется для подключения модуля к сети WiFi, чтобы Telnet и FTP можно было использовать без подключения к точке доступа WiFi и не загромождать файл main.py. Не нужно использовать boot.py, если вы новичок.
• main.py Этот скрипт запускается сразу после boot.py и должен содержать основной код, который вы хотите запустить на устройстве.
• lib Часто хорошей идеей является разделение кода многократного использования на библиотеки. Если вы хотите создавать или использовать библиотеки, созданные другими пользователями, вам нужно будет создать каталог lib и поместить в него файлы библиотеки. Важно поместить файлы .py непосредственно в lib, а не создать каталог! По умолчанию MicroPython не обнаружит библиотеки внутри подкаталога.

Для этого примера вам нужно создать файл main.py.

Теперь, когда структура проекта настроена, вы можете настроить конкретные параметры для Pymakr, например, какой последовательный порт использовать. В Atom вам нужно нажать кнопку ^ на панели Pymakr, затем нажать «Настройки проекта». В Visual Studio Code необходимо нажать кнопку «Все команды» в нижней части окна, а затем нажать «Pymakr» > «Настройки проекта». Будет создан файл с именем pymakr.conf внутри вашего проекта с настройками по умолчанию, скопированными из ваших настроек. Подробное объяснение можно найти здесь.

Управление встроенным светодиодом

Теперь, когда вы настроили свой проект, мы можем перейти к программированию модуля. Первое, что нужно сделать, - импортировать некоторые библиотеки для взаимодействия со встроенным светодиодом. Прошивка Pycom поставляется с большим количеством встроенных стандартных библиотек. Вы можете узнать больше об этом в документации API. Для этого примера вам нужно открыть файл main.py и добавить следующий код:

import pycom
import time

При этом будут импортированы две библиотеки: Pycom, которая отвечает за специфические функции Pycom, такие как встроенный индикатор, и время, которое является стандартной библиотекой, используемой для синхронизации и задержек.

Возможно, вы заметили, что при включении модуля Pycom встроенный светодиодный индикатор регулярно мигает синим цветом. Это «сердцебиение» используется как способ убедиться, что ваш модуль включился и запустился правильно. Прежде чем мы сможем изменить цвет этого светодиода, нужно отключить это сердцебиение. Ниже предыдущего кода вам нужно будет добавить следующее:

pycom.heartbeat (False)

Теперь пришло время проверить код. На панели Pymakr / внизу окна вы увидите кнопку запуска. (Если вы еще не подключились к своему устройству, сначала нужно будет это сделать). Когда вы нажмете кнопку «Выполнить», код в текущем открытом файле будет выполнен на устройстве. После запуска этого кода вы увидите, что встроенный светодиод перестает мигать синим цветом.

Теперь, когда мы убедились, что устройство подключено и Pymakr может запустить на нем код, можем завершить скрипт, чтобы запустить мигание светодиода:

import pycom
import time

pycom.heartbeat(False)

while True:
    pycom.rgbled(0xFF0000)  # Красный
    time.sleep(1)
    pycom.rgbled(0x00FF00)  # Зеленый
    time.sleep(1)
    pycom.rgbled(0x0000FF)  # Синий
    time.sleep(1)

Как только вы запустите приведенный выше скрипт, он будет работать непрерывно. Его работа препятствует доступу к интерактивному REPL на устройстве (вы увидите >>> приглашение). Чтобы остановить скрипт, нажмите на терминал Pymakr и нажмите ctrl-c на клавиатуре. Эта команда должна остановить выполнение скрипта и вернуть вас к интерактивному REPL.

Загрузка в ваш модуль

В предыдущем разделе мы запустили код на вашем модуле Pycom, используя функцию запуска Pymakr. Эта функция полезна для быстрого тестирования, но имеет несколько недостатков. Во-первых, код не остается на устройстве. Если вы перезагрузите устройство, оно больше не будет запускать ваш код. Во-вторых, код будет работать только при использовании встроенных в прошивку библиотек. Если вам нужны дополнительные библиотеки, их нужно сначала скопировать на устройство. Именно здесь появляется функция загрузки. Если вместо запуска вы нажмете кнопку загрузки, Pymakr загрузит все файлы в проекте (если их тип указан в настройке sync_file_types для вашего проекта). Затем они сохранятся на вашем устройстве даже после перезагрузки и позволят вам использовать библиотеки из папки lib.

Если вам нужно удалить файлы с вашего устройства, у вас есть два варианта: подключиться через FTP и управлять своими файлами, либо отформатировать внутреннюю флэш-память устройства следующим образом:

import os
os.mkfs(′/flash′)