class USB_VCP – USB-virtuaalisarjaportti#

USB_VCP-luokka mahdollistaa stream-tyyppisen objektin luomisen, joka edustaa USB-virtuaalisarjaporttia. Sitä voidaan käyttää datan lukemiseen ja kirjoittamiseen USB:n kautta kytkettyyn isäntäkoneeseen.

Konstruktorit#

class pyb.USB_VCP(id: int = 0)#

Luo uuden USB_VCP-objektin. id-argumentti valitsee, mitä USB VCP -porttia käytetään, kun useampi kuin yksi on tuotu ulos.

Metodit#

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

Määrittää USB VCP -portin. Jos flow-argumentti ei ole -1, se asettaa vuonohjauksen, joka on bittikohtainen OR arvoista USB_VCP.RTS ja USB_VCP.CTS. RTS portittaa lukukäyttäytymistä; CTS portittaa kirjoituskäyttäytymistä.

setinterrupt(chr: int) → None#

Asettaa merkin, joka keskeyttää suorituksessa olevan Python-koodin. Tämä on oletuksena 3 (CTRL-C), ja kun CTRL-C-merkki vastaanotetaan USB VCP -portin kautta, nostetaan KeyboardInterrupt-poikkeus.

Aseta arvoon -1 poistaaksesi tämän keskeytysominaisuuden käytöstä. Tämä on hyödyllistä, kun haluat lähettää raakatavuja USB VCP -portin kautta.

isconnected() → bool#

Palauttaa True, jos USB on kytketty sarjalaitteena, muutoin False.

debug_mode_enabled() → bool#

Palauttaa True, jos OpenMV IDE on kytketty OpenMV Camiin.

any() → bool#

Palauttaa True, jos merkkejä on odottamassa, muutoin False.

close() → None#

Tämä metodi ei tee mitään. Se on olemassa, jotta USB_VCP-objekti voi toimia tiedostona.

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

Lukee enintään nbytes tavua sarjalaitteelta ja palauttaa ne bytes-objektina. Jos nbytes ei ole määritetty, metodi lukee kaikki saatavilla olevat tavut sarjalaitteelta. USB_VCP stream toimii implisiittisesti ei-estävässä tilassa, joten jos odottavaa dataa ei ole saatavilla, tämä metodi palaa välittömästi arvolla None.

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

Lukee tavuja sarjalaitteelta ja tallentaa ne puskuriin buf, jonka tulee olla puskurinkaltainen objekti. Luetaan enintään len(buf) tavua. Jos maxlen on annettu, luetaan enintään min(maxlen, len(buf)) tavua.

Palauttaa puskuriin buf luettujen ja tallennettujen tavujen määrän tai None, jos odottavaa dataa ei ole saatavilla.

readline() → bytes | None#

Lukee kokonaisen rivin sarjalaitteelta.

Palauttaa bytes-objektin, joka sisältää datan, mukaan lukien lopussa olevan rivinvaihtomerkin, tai None, jos odottavaa dataa ei ole saatavilla.

readlines() → List[bytes]#

Lukee niin paljon dataa kuin mahdollista sarjalaitteelta jakaen sen riveihin.

Palauttaa listan bytes-objekteja, joista kukin objekti on yksi riveistä. Kukin rivi sisältää rivinvaihtomerkin.

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

Kirjoittaa puskurin buf tavut sarjalaitteelle.

Palauttaa kirjoitettujen tavujen määrän.

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

Vastaanottaa dataa väylältä:

  • data voi olla kokonaisluku, joka on vastaanotettavien tavujen määrä, tai muokattava puskuri, joka täytetään vastaanotetuilla tavuilla.

  • timeout on aikakatkaisu millisekunteina, jonka verran vastaanottoa odotetaan.

Paluuarvo: jos data on kokonaisluku, palautetaan uusi puskuri vastaanotetuista tavuista, muutoin palautetaan kohteeseen data luettujen tavujen määrä.

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

Lähettää dataa USB VCP:n kautta:

  • data on lähetettävä data (lähetettävä kokonaisluku tai puskuriobjekti).

  • timeout on aikakatkaisu millisekunteina, jonka verran lähetystä odotetaan.

Paluuarvo: lähetettyjen tavujen määrä.

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

Rekisteröi handler kutsuttavaksi aina, kun trigger-arvon määrittämä tapahtuma esiintyy. handler-funktion täytyy ottaa täsmälleen yksi argumentti, joka on USB VCP -objekti. Anna arvoksi None poistaaksesi takaisinkutsun käytöstä.

trigger-arvon kelvolliset arvot ovat:

  • USB_VCP.IRQ_RX: uutta dataa on saatavilla luettavaksi USB VCP -objektista.

Vakiot#

RTS: int#

Vuonohjauslippu metodille init(). RTS:n käyttöön ottaminen saa laitteen rajoittamaan isäntäkoneen lähetystä, kun lukupuskuri on täynnä.

CTS: int#

Vuonohjauslippu metodille init(). CTS:n käyttöön ottaminen saa laitteen noudattamaan isäntäkoneen vuonohjausta kirjoitusten aikana (estäen suorituksen, kunnes isäntäkone on valmis vastaanottamaan). Voidaan yhdistää OR-operaatiolla arvoon RTS.

IRQ_RX: int#

irq()-laukaisin: laukeaa, kun uutta dataa on saatavilla luettavaksi USB VCP -objektista.