chrome.serial

Beschreibung

Mit der chrome.serial API können Sie Daten von einem Gerät lesen und auf ein Gerät schreiben, das mit einem seriellen Port verbunden ist.

Berechtigungen

serial

Verfügbarkeit

Nur ChromeOS

Typen

ConnectionInfo

Attribute

  • bitrate

    number optional

    ConnectionOptions.bitrate ansehen. Dieses Feld kann weggelassen werden oder ungenau sein, wenn eine nicht standardmäßige Bitrate verwendet wird oder ein Fehler beim Abfragen des zugrunde liegenden Geräts aufgetreten ist.

  • bufferSize

    Zahl

    ConnectionOptions.bufferSize ansehen

  • connectionId

    Zahl

    Die ID der Verbindung über den seriellen Port.

  • ctsFlowControl

    Boolesch optional

    ConnectionOptions.ctsFlowControl ansehen. Dieses Feld kann weggelassen werden, wenn beim Abfragen des zugrunde liegenden Geräts ein Fehler aufgetreten ist.

  • dataBits

    DataBits optional

    ConnectionOptions.dataBits ansehen. Dieses Feld kann weggelassen werden, wenn beim Abfragen des zugrunde liegenden Geräts ein Fehler aufgetreten ist.

  • name

    String

    ConnectionOptions.name ansehen

  • parityBit

    ParityBit optional

    ConnectionOptions.parityBit ansehen. Dieses Feld kann weggelassen werden, wenn beim Abfragen des zugrunde liegenden Geräts ein Fehler aufgetreten ist.

  • pausiert

    boolean

    Flag, das angibt, ob die Verbindung daran gehindert wird, onReceive-Ereignisse auszulösen.

  • nichtflüchtige

    boolean

    ConnectionOptions.persistent ansehen

  • receiveTimeout

    Zahl

    ConnectionOptions.receiveTimeout ansehen

  • sendTimeout

    Zahl

    ConnectionOptions.sendTimeout ansehen

  • stopBits

    StopBits optional

    ConnectionOptions.stopBits ansehen. Dieses Feld kann weggelassen werden, wenn beim Abfragen des zugrunde liegenden Geräts ein Fehler aufgetreten ist.

ConnectionOptions

Attribute

  • bitrate

    number optional

    Die angeforderte Bitrate der zu öffnenden Verbindung. Für die Kompatibilität mit einer möglichst großen Bandbreite an Hardware sollte diese Zahl mit einer der gängigen Bitraten übereinstimmen, z. B. 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200. Es gibt natürlich keine Garantie dafür, dass das mit dem seriellen Port verbundene Gerät die angeforderte Bitrate unterstützt, auch wenn der Port selbst diese Bitrate unterstützt. 9600 wird standardmäßig übergeben.

  • bufferSize

    number optional

    Die Größe des Puffers, der zum Empfangen von Daten verwendet wird. Der Standardwert ist 4096.

  • ctsFlowControl

    Boolesch optional

    Flag, das angibt, ob die RTS/CTS-Hardware-Flusssteuerung aktiviert werden soll. Die Standardeinstellung ist "false".

  • dataBits

    DataBits optional

    "eight" wird standardmäßig übergeben.

  • name

    String optional

    Ein anwendungsdefinierter String, der der Verbindung zugeordnet werden soll.

  • parityBit

    ParityBit optional

    "no" wird standardmäßig übergeben.

  • nichtflüchtige

    Boolesch optional

    Flag, das angibt, ob die Verbindung offen bleiben soll, wenn die Anwendung angehalten wird (siehe App-Lebenszyklus verwalten). Der Standardwert ist „false“. Wenn die Anwendung geladen wird, können alle zuvor mit „persistent=true“ geöffneten seriellen Verbindungen mit getConnections abgerufen werden.

  • receiveTimeout

    number optional

    Die maximale Zeit (in Millisekunden), die auf neue Daten gewartet wird, bevor ein onReceiveError-Ereignis mit einem „Zeitüberschreitung“-Fehler ausgelöst wird. Wenn der Wert „0“ ist, werden für die Verbindung keine Zeitüberschreitungsfehler beim Empfang ausgelöst. Die Standardeinstellung ist 0.

  • sendTimeout

    number optional

    Die maximale Zeit (in Millisekunden), die auf den Abschluss eines send-Vorgangs gewartet wird, bevor der Callback mit einem „Timeout“-Fehler aufgerufen wird. Wenn der Wert „0“ ist, werden keine Fehler bei Zeitüberschreitungen beim Senden ausgelöst. Die Standardeinstellung ist 0.

  • stopBits

    StopBits optional

    "one" wird standardmäßig übergeben.

DataBits

Enum

"seven"

"eight"

DeviceControlSignals

Attribute

  • cts

    boolean

    CTS (Clear To Send).

  • dcd

    boolean

    DCD (Data Carrier Detect) oder RLSD (Receive Line Signal/Detect).

  • dsr

    boolean

    DSR (Data Set Ready).

  • ri

    boolean

    RI (Ring Indicator).

DeviceInfo

Attribute

  • displayName

    String optional

    Ein menschenlesbarer Anzeigename für das zugrunde liegende Gerät, wenn einer vom Hosttreiber abgefragt werden kann.

  • Pfad

    String

    Der Systempfad des Geräts. Dies sollte als path-Argument an chrome.serial.connect übergeben werden, um eine Verbindung zu diesem Gerät herzustellen.

  • productId

    number optional

    Eine USB-Produkt-ID, falls eine für das zugrunde liegende Gerät ermittelt werden kann.

  • vendorId

    number optional

    Eine PCI- oder USB-Anbieter-ID, falls eine für das zugrunde liegende Gerät ermittelt werden kann.

HostControlSignals

Attribute

  • dtr

    Boolesch optional

    DTR (Data Terminal Ready).

  • rts

    Boolesch optional

    RTS (Request To Send).

ParityBit

Enum

"no"

"odd"

"even"

ReceiveError

Enum

"disconnected"
Die Verbindung wurde getrennt.

"timeout"
Seit receiveTimeout Millisekunden wurden keine Daten empfangen.

"device_lost"
Die Verbindung des Geräts zum Host wurde wahrscheinlich getrennt.

"break"
Das Gerät hat eine Unterbrechung erkannt.

"frame_error"
Das Gerät hat einen Framing-Fehler erkannt.

"overrun"
Ein Zeichenpufferüberlauf ist aufgetreten. Das nächste Zeichen geht verloren.

"buffer_overflow"
Ein Eingabepufferüberlauf ist aufgetreten. Entweder ist im Eingabepuffer kein Platz mehr oder nach dem EOF-Zeichen (End of File) wurde ein Zeichen empfangen.

"parity_error"
Das Gerät hat einen Paritätsfehler erkannt.

"system_error"
Ein Systemfehler ist aufgetreten und die Verbindung kann möglicherweise nicht wiederhergestellt werden.

ReceiveErrorInfo

Attribute

  • connectionId

    Zahl

    Die Verbindungskennung.

  • Fehler

    ReceiveError

    Ein Fehlercode, der angibt, was schiefgelaufen ist.

ReceiveInfo

Attribute

  • connectionId

    Zahl

    Die Verbindungskennung.

  • Daten

    ArrayBuffer

    Die empfangenen Daten.

SendError

Enum

"disconnected"
Die Verbindung wurde getrennt.

„pending“
Ein Sendevorgang war bereits ausstehend.

"timeout"
Zeitüberschreitung beim Senden.

"system_error"
Ein Systemfehler ist aufgetreten und die Verbindung kann möglicherweise nicht wiederhergestellt werden.

SendInfo

Attribute

  • bytesSent

    Zahl

    Die Anzahl der gesendeten Bytes.

  • Fehler

    SendError optional

    Ein Fehlercode, wenn ein Fehler aufgetreten ist.

StopBits

Enum

"one"

"two"

Methoden

clearBreak()

Promise Chrome 45 und höher 
chrome.serial.clearBreak(
  connectionId: number,
  callback?: function,
): Promise<boolean>

Stellt die Zeichenübertragung auf einer bestimmten Verbindung wieder her und versetzt die Übertragungsleitung in einen Zustand ohne Unterbrechung.

Parameter

  • connectionId

    Zahl

    Die ID der Verbindung.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: boolean) => void

    • Ergebnis

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

connect()

Promise 
chrome.serial.connect(
  path: string,
  options?: ConnectionOptions,
  callback?: function,
): Promise<ConnectionInfo>

Stellt eine Verbindung zu einem bestimmten seriellen Port her.

Parameter

  • Pfad

    String

    Der Systempfad des zu öffnenden seriellen Ports.

  • Optionen

    ConnectionOptions optional

    Optionen für die Portkonfiguration.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (connectionInfo: ConnectionInfo) => void

Ausgabe

  • Promise<ConnectionInfo>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

disconnect()

Promise 
chrome.serial.disconnect(
  connectionId: number,
  callback?: function,
): Promise<boolean>

Trennt die Verbindung zu einem seriellen Port.

Parameter

  • connectionId

    Zahl

    Die ID der geöffneten Verbindung.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: boolean) => void

    • Ergebnis

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

flush()

Promise 
chrome.serial.flush(
  connectionId: number,
  callback?: function,
): Promise<boolean>

Löscht alle Byte in den Eingabe- und Ausgabepuffern der angegebenen Verbindung.

Parameter

  • connectionId

    Zahl

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: boolean) => void

    • Ergebnis

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getConnections()

Promise 
chrome.serial.getConnections(
  callback?: function,
): Promise<ConnectionInfo[]>

Ruft die Liste der aktuell geöffneten seriellen Portverbindungen ab, die der Anwendung gehören.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (connectionInfos: ConnectionInfo[]) => void

Ausgabe

  • Promise<ConnectionInfo[]>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getControlSignals()

Promise 
chrome.serial.getControlSignals(
  connectionId: number,
  callback?: function,
): Promise<DeviceControlSignals>

Ruft den Status der Steuersignale für eine bestimmte Verbindung ab.

Parameter

Ausgabe

  • Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDevices()

Promise 
chrome.serial.getDevices(
  callback?: function,
): Promise<DeviceInfo[]>

Gibt Informationen zu verfügbaren seriellen Geräten im System zurück. Die Liste wird bei jedem Aufruf dieser Methode neu generiert.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (ports: DeviceInfo[]) => void

Ausgabe

  • Promise<DeviceInfo[]>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getInfo()

Promise 
chrome.serial.getInfo(
  connectionId: number,
  callback?: function,
): Promise<ConnectionInfo>

Ruft den Status einer bestimmten Verbindung ab.

Parameter

  • connectionId

    Zahl

    Die ID der geöffneten Verbindung.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (connectionInfo: ConnectionInfo) => void

Ausgabe

  • Promise<ConnectionInfo>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

send()

Promise 
chrome.serial.send(
  connectionId: number,
  data: ArrayBuffer,
  callback?: function,
): Promise<SendInfo>

Schreibt Daten in die angegebene Verbindung.

Parameter

  • connectionId

    Zahl

    Die ID der Verbindung.

  • Daten

    ArrayBuffer

    Die zu sendenden Daten.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (sendInfo: SendInfo) => void

Ausgabe

  • Promise<SendInfo>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setBreak()

Promise Chrome 45 und höher 
chrome.serial.setBreak(
  connectionId: number,
  callback?: function,
): Promise<boolean>

Unterbricht die Zeichenübertragung für eine bestimmte Verbindung und versetzt die Übertragungsleitung in einen Unterbrechungszustand, bis „clearBreak“ aufgerufen wird.

Parameter

  • connectionId

    Zahl

    Die ID der Verbindung.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: boolean) => void

    • Ergebnis

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setControlSignals()

Promise 
chrome.serial.setControlSignals(
  connectionId: number,
  signals: HostControlSignals,
  callback?: function,
): Promise<boolean>

Legt den Status der Steuersignale für eine bestimmte Verbindung fest.

Parameter

  • connectionId

    Zahl

    Die ID der Verbindung.

  • Die Gruppe von Signaländerungen, die an das Gerät gesendet werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: boolean) => void

    • Ergebnis

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setPaused()

Promise 
chrome.serial.setPaused(
  connectionId: number,
  paused: boolean,
  callback?: function,
): Promise<void>

Pausiert eine offene Verbindung oder hebt die Pausierung auf.

Parameter

  • connectionId

    Zahl

    Die ID der geöffneten Verbindung.

  • pausiert

    boolean

    Flag, das angibt, ob die Pausierung aktiviert oder aufgehoben werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

update()

Promise 
chrome.serial.update(
  connectionId: number,
  options: ConnectionOptions,
  callback?: function,
): Promise<boolean>

Aktualisieren Sie die Optionseinstellungen für eine offene serielle Portverbindung.

Parameter

  • connectionId

    Zahl

    Die ID der geöffneten Verbindung.

  • Optionen für die Portkonfiguration.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: boolean) => void

    • Ergebnis

      boolean

Ausgabe

  • Promise<boolean>

    Chrome 117 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onReceive

chrome.serial.onReceive.addListener(
  callback: function,
)

Ereignis, das ausgelöst wird, wenn Daten aus der Verbindung gelesen wurden.

Parameter

onReceiveError

chrome.serial.onReceiveError.addListener(
  callback: function,
)

Ereignis, das ausgelöst wird, wenn ein Fehler auftritt, während die Laufzeit auf Daten am seriellen Port wartet. Sobald dieses Ereignis ausgelöst wird, kann die Verbindung auf paused gesetzt werden. Ein "timeout"-Fehler führt nicht dazu, dass die Verbindung pausiert wird.

Parameter