Этот модуль работает только с Python 2.7 или 3.3+.
Утилита для прошивки BBC Micro: Bit с помощью сценариев Python и среды выполнения Micropython. Вы произносите название этой утилиты «Микро-плэш». ;-)
Он предоставляет три услуги:
Внедрены несколько важных операций:
Чтобы установить просто введите:
$ pip установить Uflash
... и пакет будет загружаться с PYPI. Если вы хотите перейти на последнюю версию, используйте следующую команду:
$ pip install-no-cache-Uprage uflash
NB: Вы должны использовать USB -кабель для подключения микро: бит к вашему компьютеру (некоторые кабели только питаются). Вы в хорошей форме, если при подключении Micro: BIT появляется в виде устройства хранения USB в вашей файловой системе.
Пользователи Linux: чтобы UFLASH работал, вы должны убедиться, что Micro: BIT монтируется как USB -устройство. Обычно это делается автоматически. Если нет, вы, вероятно, настроили Automounting, чтобы отключиться. Если это так, мы предполагаем, что у вас есть технические знания, чтобы установить устройство самостоятельно или установить необходимые модули ядра, если они отсутствуют. Установка по умолчанию популярного Linux Distros «должна просто работать» (TM) из коробки с учетом установки по умолчанию.
Чтобы прочитать помощь просто введите:
$ uflash -help
или:
$ uflash -h
Чтобы обнаружить тип информации о версии:
$ uflash -версия
Если вы напечатаете команду самостоятельно, то Uflash попытается найти подключенную BBC Micro: Bit и прошить немодифицированную версию по умолчанию времени выполнения Micropython:
$ uflash Мигающий Python по:/media/ntoll/microbit/micropython.hex
Чтобы пропустить версию времени выполнения MicropyThon с указанным сценарием, встроенным в него (так что этот скрипт запускается, когда BBC Micro: Bit Bouckes Up) затем передайте путь к сценарию Python в качестве первого аргумента команды:
$ uflash my_script.py Мигание my_script.py to: /media/ntoll/microbit/micropython.hex
Вы можете позволить Uflash наблюдать за изменениями вашего сценария. Он будет прошиваться автоматически каждый раз, когда вы его сохраняете:
$ uflash -w my_script.py
или:
$ uflash -смотрю my_script.py
На этом этапе Uflash попытается автоматически обнаружить путь к устройству. Однако, если у вас есть несколько устройств, подключенных и/или знаете, какой путь к файловой системе к BBC Micro: Bit уже есть, вы можете указать это как второй аргумент в команду:
$ uflash myscript.py/media/ntoll/microbit Мигающий myscript.py to:/media/ntoll/microbit/micropython.hex
Вы можете даже прошить несколько устройств одновременно:
$ uflash myscript.py/media/ntoll/microbit/media/ntoll/microbit1 Мигающий myscript.py to:/media/ntoll/microbit/micropython.hex Мигающий myscript.py to:/media/ntoll/microbit1/micropython.hex
Чтобы извлечь сценарий Python из шестнадцатеричного файла, используйте флаг «-e», как это:
$ uflash -e something.hex myscript.py
Это сохранит сценарий Python, восстановленного от «что -то.hex» в файл «myscript.py». Если вы не предоставите цель, восстановленный сценарий испускает в Stdout.
Если вы разрабатываете MicropyThon и имеете пользовательский шестнадцатеричный файл среды выполнения, вы можете указать, что Uflash использует его вместо встроенной версии MicropyThon следующим образом:
$ uflash -r прошивка.hex
или:
$ uflash -runtime = прошивка. Хекс
Для создания файлов output .hex в том же каталоге, что и файлы input .py:
$ py2hex tests/example.py Hexifing example.py as: tests/example.hex
Py2Hex включает в себя то же самое -R/-Средство выполнения и -m/-Minify Options в качестве Uflash и добавляет дополнительную опцию -o/-Outdir:
Для создания файлов output .hex в другом каталоге:
$ py2Hex example.py -o /tmp Hexifing example.py as: /tmp/example.hex
или:
$ py2Hex example.py -outdir /tmp Hexifing example.py as: /tmp/example.hex
PY2HEX может обрабатывать несколько входных файлов:
$ py2hex a.py b.py c.py Hexifing A.Py AS: A.HEX Hexifing B.py As: B.Hex Hexifing C.py As: C.HEX
или:
$ py2Hex *.py Hexifing A.Py AS: A.HEX Hexifing B.py As: B.Hex Hexifing C.py As: C.HEX
Исходный код размещен в GitHub. Пожалуйста, не стесняйтесь распаковать репозиторий. Предполагая, что у вас установлен GIT, вы можете загрузить код из канонического репозитория со следующей командой:
$ git clone https://github.com/ntoll/uflash.git
Убедитесь, что у вас есть правильные зависимости для разработки, установленные путем создания VirtualEnv и запуска:
$ pip install -r redtion.txt
Чтобы локально установить версию модуля разработки в VirtualENV, запустите следующую команду:
$ python setup.py Разработка
Существует макияж, который помогает с большинством общих рабочих процессов, связанных с развитием. Тип make
самостоятельно перечисляет варианты таким образом:
$ make Сейчас нет цели по умолчанию. Пытаться: Сделайте чистую - сбросьте проект и удалите автоматические активы. Сделайте Pyflakes - запустите проверку кода Pyflakes. Сделайте PEP8 - запустите PEP8 Style Checker. Сделайте тест - запустите тестовый набор. Сделать покрытие - просмотреть отчет о тестовом покрытии. Сделайте чек - запустите все шашки и тесты. Сделайте пакет - создайте развертываемый пакет для проекта. Сделайте RPM - создайте пакет RPM для проекта. Make Publish - опубликовать проект в PYPI. Сделайте документы - запустите Sphinx для создания документации проекта.