MicroPython:Библиотеки/pyb/pyb.usb mode(): различия между версиями
Myagkij (обсуждение | вклад) (Новая страница: «{{MicroPython/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =pyb.usb_mode()<ref>[http://docs.micropython.org/e...») |
Myagkij (обсуждение | вклад) Нет описания правки |
||
| Строка 8: | Строка 8: | ||
Если вызвать ее с аргументом ''modestr'', она попытается задать [[USB-режим]]. Вот доступные значения для этого аргумента: | Если вызвать ее с аргументом ''modestr'', она попытается задать [[USB-режим]]. Вот доступные значения для этого аргумента: | ||
* '''None''' – отключает [[USB]]. | |||
* ''''VCP'''' – включает [[USB]] с [[VCP-интерфейс]]ом (от англ. ''«virtual COM port»'', т.е. ''«виртуальный COM-порт»''). | |||
* ''''MSC'''' – включает [[USB]] с [[MSC-интерфейс]]ом (от англ. ''«mass storage device class»'', т.е. ''«устройство-накопитель»''). | |||
* ''''VCP+MSC'''' – включает [[USB]] с [[VCP]]- и [[MSC-интерфейс]]ами. | |||
* ''''VCP+HID'''' – включает [[USB]] с [[VCP]]- и [[HID-интерфейс]]ами (от англ. ''«human interface device»'', т.е. ''«человеко-машинный интерфейс»''). | |||
* ''''VCP+MSC+HID'''' – включает [[USB]] с [[VCP]]-, [[MSC]]- и [[HID-интерфейс]]ами (этот вариант доступен только на [[PYBD-плата]]х). | |||
В целях обратной совместимости под 'CDC' также подразумевается 'VCP' (то же самое касается режимов 'CDC+MSC' и 'CDC+HID'). | В целях обратной совместимости под '''CDC''' также подразумевается '''VCP''' (то же самое касается режимов '''CDC+MSC''' и '''CDC+HID'''). | ||
В аргументе port должно быть целое число («0», «1» и т.д.) – в нем задается, какой USB-порт использовать, если плата оснащена несколькими USB- | В аргументе port должно быть целое число (''«0»'', ''«1»'' и т.д.) – в нем задается, какой [[USB-порт]] использовать, если плата оснащена несколькими [[USB-порт]]ами. Если задать ''«-1»'', это выберет порт по умолчанию или автоматически выбранный порт. | ||
Если | В аргументах ''vid'' и ''pid'' задаются [[VID]] (ID поставщика) и ''PID'' (ID продукта). Если задать в ''pid'' значение ''«-1»'', то ''PID'' будет выбран в зависимости от значения в ''modestr''. | ||
Если вы выбрали | Если вы выбрали [[MSC-режим]], то также можете задать аргумент ''msc'', чтобы задать список адресов ''SCSI LUN'', которые можно использовать через [[MSC-интерфейс]]. Например, ''msc=(pyb.Flash(), pyb.SDCard())''. | ||
Если задать в аргументе high_speed значение True, это включит режим USB HS (если он поддерживается используемой платформой). | Если вы выбрали [[HID-режим]], то также можете задать дополнительные [[HID-данные]] при помощи аргумента ''hid''. В нем задается кортеж в формате ''(subclass, protocol, max packet length, polling interval, report descriptor)''. По умолчанию в нем задаются параметры для [[USB-мышки]]. Также есть константа pyb.hid_keyboard с кортежем для [[USB-клавиатуры]]. | ||
Если задать в аргументе ''high_speed'' значение ''True'', это включит режим ''USB HS'' (если он поддерживается используемой платформой). | |||
<syntaxhighlight lang="python" enclose="div"> | <syntaxhighlight lang="python" enclose="div"> | ||
Текущая версия от 15:31, 4 октября 2020
pyb.usb_mode()[1]
- pyb.usb_mode([modestr, ]port=-1, vid=0xf055, pid=-1, msc=(), hid=pyb.hid_mouse, high_speed=False) – если вызвать эту функцию без аргументов, она вернет строку, содержащую информацию о текущем USB-режиме.
Если вызвать ее с аргументом modestr, она попытается задать USB-режим. Вот доступные значения для этого аргумента:
- None – отключает USB.
- 'VCP' – включает USB с VCP-интерфейсом (от англ. «virtual COM port», т.е. «виртуальный COM-порт»).
- 'MSC' – включает USB с MSC-интерфейсом (от англ. «mass storage device class», т.е. «устройство-накопитель»).
- 'VCP+MSC' – включает USB с VCP- и MSC-интерфейсами.
- 'VCP+HID' – включает USB с VCP- и HID-интерфейсами (от англ. «human interface device», т.е. «человеко-машинный интерфейс»).
- 'VCP+MSC+HID' – включает USB с VCP-, MSC- и HID-интерфейсами (этот вариант доступен только на PYBD-платах).
В целях обратной совместимости под CDC также подразумевается VCP (то же самое касается режимов CDC+MSC и CDC+HID).
В аргументе port должно быть целое число («0», «1» и т.д.) – в нем задается, какой USB-порт использовать, если плата оснащена несколькими USB-портами. Если задать «-1», это выберет порт по умолчанию или автоматически выбранный порт.
В аргументах vid и pid задаются VID (ID поставщика) и PID (ID продукта). Если задать в pid значение «-1», то PID будет выбран в зависимости от значения в modestr.
Если вы выбрали MSC-режим, то также можете задать аргумент msc, чтобы задать список адресов SCSI LUN, которые можно использовать через MSC-интерфейс. Например, msc=(pyb.Flash(), pyb.SDCard()).
Если вы выбрали HID-режим, то также можете задать дополнительные HID-данные при помощи аргумента hid. В нем задается кортеж в формате (subclass, protocol, max packet length, polling interval, report descriptor). По умолчанию в нем задаются параметры для USB-мышки. Также есть константа pyb.hid_keyboard с кортежем для USB-клавиатуры.
Если задать в аргументе high_speed значение True, это включит режим USB HS (если он поддерживается используемой платформой).
<syntaxhighlight lang="python" enclose="div">
