class USB_VCP – USB sanal iletişim portu

USB_VCP sınıfı, USB sanal iletişim portunu temsil eden stream benzeri bir nesnenin oluşturulmasını sağlar. Bağlı ana makineye USB üzerinden veri okumak ve yazmak için kullanılabilir.

Yapıcılar

class pyb.USB_VCP(id: int = 0)

Yeni bir USB_VCP nesnesi oluşturur. id argümanı, birden fazla port açığa çıkarıldığında hangi USB VCP portunun kullanılacağını seçer.

Yöntemler

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

USB VCP portunu yapılandırır. flow argümanı -1 değilse, akış kontrolünü ayarlar; USB_VCP.RTS ve USB_VCP.CTS değerlerinin bit düzeyinde OR işlemidir. RTS okuma davranışını kontrol eder; CTS yazma davranışını kontrol eder.

setinterrupt(chr: int) → None

Çalışan Python kodunu kesen karakteri ayarlar. Bu varsayılan olarak 3 (CTRL-C) olarak ayarlanmıştır ve USB VCP portu üzerinden bir CTRL-C karakteri alındığında bir KeyboardInterrupt istisnası fırlatılır.

Bu kesme özelliğini devre dışı bırakmak için -1 olarak ayarlayın. Bu, USB VCP portu üzerinden ham bayt göndermek istediğinizde kullanışlıdır.

isconnected() → bool

USB bir seri cihaz olarak bağlıysa True, aksi takdirde False döndürür.

debug_mode_enabled() → bool

OpenMV IDE, OpenMV Cam’e bağlıysa True döndürür.

any() → bool

Bekleyen herhangi bir karakter varsa True, aksi takdirde False döndürür.

close() → None

Bu yöntem hiçbir şey yapmaz. USB_VCP nesnesinin bir dosya gibi davranabilmesi için vardır.

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

Seri cihazdan en fazla nbytes okur ve bunları bir bytes nesnesi olarak döndürür. nbytes belirtilmezse, yöntem seri cihazdan mevcut tüm baytları okur. USB_VCP stream, dolaylı olarak bloklamasız (non-blocking) modda çalışır, dolayısıyla bekleyen veri yoksa bu yöntem hemen None değeriyle döner.

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

Seri cihazdan baytları okur ve bunları arabellek benzeri bir nesne olması gereken buf içine depolar. En fazla len(buf) bayt okunur. maxlen verilirse en fazla min(maxlen, len(buf)) bayt okunur.

Okunan ve buf içine depolanan bayt sayısını veya bekleyen veri yoksa None döndürür.

readline() → bytes | None

Seri cihazdan bütün bir satır okur.

Sondaki yeni satır karakteri de dahil olmak üzere veriyi içeren bir bytes nesnesi veya bekleyen veri yoksa None döndürür.

readlines() → List[bytes]

Seri cihazdan mümkün olduğunca çok veri okur ve bunu satırlara böler.

Her biri satırlardan biri olan bytes nesnelerinin bir listesini döndürür. Her satır yeni satır karakterini içerir.

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

buf içindeki baytları seri cihaza yazar.

Yazılan bayt sayısını döndürür.

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

Veri yolundan veri alır:

• data bir tamsayı olabilir (alınacak bayt sayısı) veya alınan baytlarla doldurulacak değiştirilebilir bir arabellek olabilir.

• timeout alma işlemi için beklenecek milisaniye cinsinden zaman aşımıdır.

Dönüş değeri: data bir tamsayıysa alınan baytları içeren yeni bir arabellek, aksi takdirde data içine okunan bayt sayısı döndürülür.

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

USB VCP üzerinden veri gönderir:

• data gönderilecek veridir (gönderilecek bir tamsayı veya bir arabellek nesnesi).

• timeout gönderme işlemi için beklenecek milisaniye cinsinden zaman aşımıdır.

Dönüş değeri: gönderilen bayt sayısı.

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

trigger tarafından belirtilen bir olay her gerçekleştiğinde çağrılacak handler fonksiyonunu kaydeder. handler fonksiyonu tam olarak bir argüman almalıdır; bu, USB VCP nesnesi olacaktır. Geri çağırmayı (callback) devre dışı bırakmak için None geçirin.

trigger için geçerli değerler şunlardır:

• USB_VCP.IRQ_RX: USB VCP nesnesinden okunmak üzere yeni veri mevcuttur.

Sabitler

RTS: int

init() için akış kontrolü bayrağı. RTS etkinleştirildiğinde, okuma arabelleği dolduğunda cihaz ana makinenin iletimini kısıtlar.

CTS: int

init() için akış kontrolü bayrağı. CTS etkinleştirildiğinde, cihaz yazma işlemleri sırasında ana makinenin akış kontrolüne uyar (ana makine almaya hazır olana kadar bloklar). RTS ile OR’lanabilir.

IRQ_RX: int

irq() tetikleyicisi: USB VCP nesnesinden okunmak üzere yeni veri mevcut olduğunda tetiklenir.