class USB_VCP -- منفذ اتصال افتراضي عبر USB

تتيح فئة USB_VCP إنشاء كائن شبيه بـ stream يمثّل منفذ الاتصال الافتراضي عبر USB. يمكن استخدامه لقراءة وكتابة البيانات عبر USB إلى المضيف الموصول.

المُنشئات

class pyb.USB_VCP(id: int = 0)

إنشاء كائن USB_VCP جديد. يحدد معامل id أي منفذ USB VCP يُستخدم عند الكشف عن أكثر من منفذ واحد.

الأساليب

init(*, flow: int = -1) → None

تهيئة منفذ USB VCP. إذا لم يكن معامل flow بقيمة -1 فإنه يضبط التحكم في التدفق، وهو عامل OR بتي بين USB_VCP.RTS وUSB_VCP.CTS. يتحكم RTS في سلوك القراءة؛ ويتحكم CTS في سلوك الكتابة.

setinterrupt(chr: int) → None

تعيين الحرف الذي يقاطع تنفيذ كود Python. يُضبط افتراضيًا على 3 (CTRL-C)، وعند استقبال حرف CTRL-C عبر منفذ USB VCP، يُطلق استثناء KeyboardInterrupt.

اضبطه على -1 لتعطيل ميزة المقاطعة هذه. هذا مفيد عندما تريد إرسال بايتات خام عبر منفذ USB VCP.

isconnected() → bool

يُرجع True إذا كان USB موصولًا كجهاز تسلسلي، وإلا False.

debug_mode_enabled() → bool

يُرجع True إذا كان OpenMV IDE موصولًا بـ OpenMV Cam.

any() → bool

يُرجع True إذا كانت هناك أي أحرف منتظرة، وإلا False.

close() → None

لا يفعل هذا الأسلوب شيئًا. وهو موجود حتى يتمكن كائن USB_VCP من التصرف كملف.

read(nbytes: int | None = None) → bytes | None

قراءة ما لا يزيد عن nbytes من الجهاز التسلسلي وإرجاعها ككائن bytes. إذا لم يُحدَّد nbytes فإن الأسلوب يقرأ جميع البايتات المتاحة من الجهاز التسلسلي. يعمل stream الخاص بـ USB_VCP ضمنيًا في الوضع غير الحاجب، لذا إذا لم تتوفر بيانات معلّقة، فسيعود هذا الأسلوب فورًا بالقيمة None.

readinto(buf: bytearray, maxlen: int | None = None) → int | None

قراءة البايتات من الجهاز التسلسلي وتخزينها في buf، الذي ينبغي أن يكون كائنًا شبيهًا بمخزن مؤقت. تُقرأ على الأكثر len(buf) بايت. وإذا أُعطي maxlen فتُقرأ على الأكثر min(maxlen, len(buf)) بايت.

يُرجع عدد البايتات المقروءة والمخزّنة في buf أو None إذا لم تتوفر بيانات معلّقة.

readline() → bytes | None

قراءة سطر كامل من الجهاز التسلسلي.

يُرجع كائن bytes يحتوي على البيانات، بما في ذلك حرف السطر الجديد الختامي أو None إذا لم تتوفر بيانات معلّقة.

readlines() → List[bytes]

قراءة أكبر قدر ممكن من البيانات من الجهاز التسلسلي، مع تقسيمها إلى أسطر.

يُرجع قائمة من كائنات bytes، يمثّل كل كائن أحد الأسطر. وسيتضمّن كل سطر حرف السطر الجديد.

write(buf: bytes | bytearray | str) → int

كتابة البايتات من buf إلى الجهاز التسلسلي.

يُرجع عدد البايتات المكتوبة.

recv(data: int | bytearray, *, timeout: int = 5000) → bytes | int

استقبال البيانات على الناقل:

• data يمكن أن يكون عددًا صحيحًا، وهو عدد البايتات المراد استقبالها، أو مخزنًا مؤقتًا قابلًا للتعديل سيُملأ بالبايتات المستقبَلة.

• timeout هو زمن الانتظار بالميلي ثانية لانتظار الاستقبال.

القيمة المُرجَعة: إذا كان data عددًا صحيحًا فيُرجَع مخزن مؤقت جديد بالبايتات المستقبَلة، وإلا يُرجَع عدد البايتات المقروءة في data.

send(data: int | bytes | bytearray, *, timeout: int = 5000) → int

إرسال البيانات عبر USB VCP:

• data هي البيانات المراد إرسالها (عدد صحيح للإرسال، أو كائن مخزن مؤقت).

• timeout هو زمن الانتظار بالميلي ثانية لانتظار الإرسال.

القيمة المُرجَعة: عدد البايتات المُرسَلة.

irq(handler: Callable[[USB_VCP], None] | None = None, trigger: int = IRQ_RX, hard: bool = False) → None

تسجيل handler ليُستدعى كلما وقع حدث محدد بواسطة trigger. يجب أن تأخذ دالة handler وسيطًا واحدًا بالضبط، وهو كائن USB VCP. مرّر None لتعطيل دالة رد النداء.

القيم الصالحة لـ trigger هي:

• USB_VCP.IRQ_RX: تتوفر بيانات جديدة للقراءة من كائن USB VCP.

الثوابت

RTS: int

علم التحكم في التدفق لـ init(). تمكين RTS يجعل الجهاز يخنق إرسال المضيف عندما يكون مخزن القراءة المؤقت ممتلئًا.

CTS: int

علم التحكم في التدفق لـ init(). تمكين CTS يجعل الجهاز يحترم التحكم في تدفق المضيف أثناء عمليات الكتابة (مع الحجب حتى يكون المضيف جاهزًا للاستقبال). يمكن دمجه بعامل OR مع RTS.

IRQ_RX: int

مُطلِق irq(): يُطلَق عندما تتوفر بيانات جديدة للقراءة من كائن USB VCP.