Установка программного обеспечения

Поскольку разработка этих устройств использует дополнительные функции, очень важно следить за обновлениями Pytrack / Pysense / Pyscan еженедельно. Помимо обновления прошивки, важно проверить репозиторий GitHub (https://github.com/pycom/pycom-libraries) на наличие обновлений файлов библиотек, чтобы включить дополнительные функции / функциональные возможности.

Обновление прошивки

Чтобы обновить прошивку на плате Pysense / Pytrack / Pyscan / Expansion Board v3, см. Инструкции ниже. Прошивка Pysense / Pytrack / Pyscan / Expansion Board v3 может быть обновлена через порт USB с помощью инструмента терминала DFU-util.

Последнюю версию прошивки DFU можно скачать по ссылкам ниже:

• Pytrack DFU
• Pysense DFU
• Плата расширения DFU v3.0
• Плата расширения DFU v3.1

Убедитесь, что вы выбрали правильную версию прошивки для платы расширения: версии 3.0 и 3.1 имеют номера версий на шелкографии на задней панели, смотрите изображение ниже.

В обычном режиме приложений для Pysense / Pytrack / Pyscan / Expansion Board v3 требуется драйвер Serial USB CDC, в режиме загрузчика DFU - драйвер DFU. USB идентификатор продукта (Device ID) для каждого случая изображен ниже:

Примечание. USB идентификатор производителя (Vendor ID) всегда 0x04D8.

Установка инструментов DFU-util

MacOS

При использовании homebrew:

$ brew install dfu-util

При использовании MacPorts:

port install libusb dfu-util

Linux

Ubuntu или Debian:

$ sudo apt-get install dfu-util

Fedora:

$ sudo yum install dfu-util

Arch:

$ sudo pacman -Sy dfu-util

Windows

• DFU-util v0.9 - инструмент для загрузки прошивки в Pytrack / Pysense
• Zadig - инструмент для установки прошивки DFU платы Pytrack / Pysense 

Чтобы загрузить последнюю версию прошивки DFU на Pytrack / Pysense, сначала установите драйверы DFU на хост-компьютер. Откройте Zadig и выберите libusbK в качестве драйвера.

Для установки драйверов плата Pytrack / Pysense должна быть в DFU-режиме:

1. Отключите USB-кабель
2. Удерживайте кнопку на пластине
3. Подключите USB-кабель
4. Удерживайте кнопку нажатой не менее одной секунды
5. Отпустите кнопку. Когда плата подключена в режиме DFU, она будет оставаться в этом состоянии в течение 7 секунд.
6. Тут же нажмите кнопку «Установить драйвер». Если попытка будет неудачной, повторите с шага 1.

• USB ID должен быть загрузчиком DFU (0xF014 для Pytrack или 0xF011 для Pysense).
• Результат успешной установки драйвера DFU для Pytrack:

Откройте командную строку и перейдите в директорию, куда был загружен DFU-util и встроенное программное обеспечение (должно находиться в одном месте). Повторите процедуру, чтобы перевести плату в режим DFU, и выполните команду ниже, но замените X.X.X версией прошивки и замените Pysense на Pytrack, если это Pytrack (например, pytrack_0.0.8.dfu):

dfu-util-static.exe -D pysense_X.X.X.dfu

Если обновление прошло успешно, появится сообщение «Done!» в нижней части командной строки.

Дважды проверьте драйвер последовательного USB (CDC) в режиме приложения: если по ошибке был установлен драйвер libusbk, а USB ID находится в режиме приложения (0xF013 для Pytrack или 0xF012 для Pysense), то Serial USB (CDC) драйвер должен быть установлен в режим приложения. Это позволит Windows определить COM-порт, который необходим для консоли REPL.

Использование DFU-util с Pytrack, Pysense и Expansion Board v3

Чтобы войти в режим обновления, выполните следующие действия:

1. Отключите устройство
2. Нажмите и удерживайте кнопку (на плате расширения кнопка S1)
3. Подключите USB-кабель к главному компьютеру и подождите 1 секунду, прежде чем отпустить кнопку
4. После этого у вас будет примерно 7 секунд для запуска утилиты DFU-util.

macOS и Linux:

$ dfu-util -D pytrack_0.0.8.dfu

Вам может потребоваться запустить dfu-util как sudo. В этом случае вам нужно будет ввести свой пароль.

После успешной установки появится вывод, аналогичный приведенному ниже:

dfu-util 0.9

Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/

Match vendor ID from file: 04d8
Match product ID from file: f014
Opening DFU capable USB device...
ID 04d8:f014
Run-time device DFU version 0100
Claiming USB DFU Runtime Interface...
Determining device status: state = dfuIDLE, status = 0
dfu-util: WARNING: Runtime device already in DFU state ?!?
Claiming USB DFU Interface...
Setting Alternate Setting #0 ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
DFU mode device DFU version 0100
Device returned transfer size 64
Copying data from PC to DFU device
Download    [=========================] 100%        16384 bytes
Download done.
state(2) = dfuIDLE, status(0) = No error condition is present
Done!

Отладка

При использовании команды lsusb, устройство Pytrack / Pysense должно отображаться как в обычном режиме, так и в режиме загрузчика.

Например, плата Pytrack видна как один из двух вариантов:

• Bus 020 Device 004: ID 04d8:f014 Microchip Technology Inc. Application Specific Device
  • это режим загрузчика (f014 - USB PID), который активен в течение 7-8 секунд, если кнопка сброса была нажата перед подключением USB-разъема.
• Bus 020 Device 005: ID 04d8:f013 Microchip Technology Inc. Pytrack Serial: Pyabcde0
  • это нормальный режим приложения (f013 - USB PID): означает, что загрузчик проверяет раздел приложения, и загрузка идёт правильно.

Установка драйверов - Windows 7

Pytrack и Pysense будут работать "из коробки" для Windows 8/10 / +, macOS и Linux. При использовании Windows 7 необходимо установить драйверы.

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

Загрузка

Пожалуйста, загрузите программное обеспечение драйвера по ссылке ниже.

Драйвер Pytrack / Pysense / Pyscan / Плата расширения 3

Установка

Откройте меню Пуск Windows и перейдите в Диспетчер устройств. Вы должны увидеть свой Pytrack / Pysense в списке под другими устройствами.

Щелкните правой кнопкой мыши на устройство и выберите «Обновить драйвер».

Выберите «Просмотреть мой компьютер для программного обеспечения драйвера»

Затем вам нужно будет перейти в директорию, куда вы скачали драйвер (например, Папка Загрузки).

Укажите папку, в которой содержатся драйверы. Если вы не распаковали ZIP-файл, сделайте это, прежде чем выбрать папку.

Вы можете получить предупреждение о том, что Windows не может проверить издателя этого драйвера. Нажмите Install this software anyway, так как эта ссылка указывает на нашего официального драйвера.

Если установка прошла успешно, вы увидите окно, указывающее, что драйвер был установлен корректно.

Чтобы убедиться, что установка прошла успешно, вернитесь обратно к диспетчеру устройств и щелкните раскрывающийся список других устройств. Предупреждающая этикетка должна быть удалена, и Pytrack / Pysense должен быть установлен.

Установка библиотек

Чтобы использовать датчики на Pytrack и Pysense, Pycom создал библиотеки, чтобы сделать чтение с различных датчиков доступным через API. Эти библиотеки находятся в репозитории Pycom GitHub:

GitHub Repository

Загрузите репозиторий в виде файла .zip, перейдите к нужному устройству (Pysense / Pytrack), извлеките файлы и затем загрузите нужные файлы на устройство, следуя приведенным ниже инструкциям.

Загрузка библиотек на устройство

Эти библиотеки должны быть загружены на устройство (LoPy, SiPy, WiPy 2.0 и т. д.) аналогично стандартной библиотеке MicroPython. Файлы .py должны быть помещены в папку / lib на устройстве. Например, если вы используете Pysense хотите включить только акселерометр и датчик освещенности, поместите следующие файлы .py в папку устройства / lib:

- pysense.py
- LIS2HH12.py
- LTR329ALS01.py

Добавьте столько библиотек, сколько требуется.

В дополнение к библиотекам Pysense или Pytrack также необходимо загрузить файл pycoproc.py из папки _lib/pycoproc_ в архиве библиотек.

Платы Pytrack и Pysense ведут себя так же, как плата расширения. Upload, Run и загрузка кода в модули Pycom через плагин Pymakr – одинаковые процессы.

Импорт / Использование библиотек

Как только библиотеки загружены на устройство, их можно использовать / импортировать так, как это делает стандартная библиотека MicroPython. Например, импорт и использование датчика освещенности на Pysense:

from pysense import Pysense
from LTR329ALS01 import LTR329ALS01

py = Pysense()
lt = LTR329ALS01(py)

print(lt.light())