chrome.serial

Açıklama

Seri bağlantı noktasına bağlı bir cihazdan okuma ve yazma işlemleri yapmak için chrome.serial API'yi kullanın.

İzinler

serial

Türler

ConnectionInfo

Özellikler

  • bitrate

    numara isteğe bağlı

    Şu sayfaya göz atın: ConnectionOptions.bitrate. Standart olmayan bir bit hızı kullanılıyorsa ya da alttaki cihaz sorgulanırken hata oluştuysa bu alan atlanabilir veya yanlış olabilir.

  • bufferSize

    sayı

    Göz atın: ConnectionOptions.bufferSize

  • connectionId

    sayı

    Seri bağlantı noktası bağlantısının kimliği.

  • ctsFlowControl

    boole isteğe bağlı

    Şu sayfaya göz atın: ConnectionOptions.ctsFlowControl. Temel cihaz sorgulanırken hata oluşursa bu alan atlanabilir.

  • dataBits

    DataBits isteğe bağlı

    Şu sayfaya göz atın: ConnectionOptions.dataBits. Temel cihaz sorgulanırken hata oluşursa bu alan atlanabilir.

  • ad

    dize

    Göz atın: ConnectionOptions.name

  • parityBit

    ParityBit isteğe bağlı

    Şu sayfaya göz atın: ConnectionOptions.parityBit. Temel cihaz sorgulanırken hata oluşursa bu alan atlanabilir.

  • duraklatıldı

    boolean

    Bağlantının onreceive etkinliklerini tetiklemesinin engellenip engellenmediğini gösteren işaret.

  • inatçı

    boolean

    Göz atın: ConnectionOptions.persistent

  • receiveTimeout

    sayı

    Göz atın: ConnectionOptions.receiveTimeout

  • sendTimeout

    sayı

    Göz atın: ConnectionOptions.sendTimeout

  • stopBits

    StopBits isteğe bağlı

    Şu sayfaya göz atın: ConnectionOptions.stopBits. Temel cihaz sorgulanırken hata oluşursa bu alan atlanabilir.

ConnectionOptions

Özellikler

  • bitrate

    numara isteğe bağlı

    Açılacak bağlantının istenen bit hızı. En geniş donanım yelpazesiyle uyumluluk için bu sayı, 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200 gibi yaygın olarak kullanılan bit hızlarından biriyle eşleşmelidir. Seri bağlantı noktasına bağlanan cihazın, bağlantı noktasının kendisi söz konusu bit hızını desteklese bile istenen bit hızını destekleyeceğinin garantisi yoktur. 9600 varsayılan olarak iletilir.

  • bufferSize

    numara isteğe bağlı

    Verileri almak için kullanılan arabelleğin boyutu. Varsayılan değer 4096'dır.

  • ctsFlowControl

    boole isteğe bağlı

    RTS/CTS donanım akış denetiminin etkinleştirilip etkinleştirilmeyeceğini gösteren işaret. Varsayılan olarak false değerine ayarlanır.

  • dataBits

    DataBits isteğe bağlı

    "eight" varsayılan olarak iletilir.

  • ad

    string isteğe bağlı

    Bağlantıyla ilişkilendirilecek, uygulama tanımlı bir dize.

  • parityBit

    ParityBit isteğe bağlı

    "no" varsayılan olarak iletilir.

  • inatçı

    boole isteğe bağlı

    Uygulama askıya alındığında bağlantının açık bırakılması gerekip gerekmediğini gösteren işaret (Uygulama Yaşam Döngüsünü Yönetme bölümüne bakın). Varsayılan değer "false" değeridir. Uygulama yüklendiğinde, daha önce kalıcı=true ile açılmış olan seri bağlantılar getConnections ile alınabilir.

  • receiveTimeout

    numara isteğe bağlı

    "Zaman aşımı" hatası bulunan bir onReceiveError etkinliği oluşturmadan önce yeni veriler için beklenecek maksimum süre (milisaniye cinsinden). Değer sıfırsa bağlantı için alma zaman aşımı hataları bildirilmez. Varsayılan olarak 0 değerine ayarlanır.

  • sendTimeout

    numara isteğe bağlı

    "Zaman aşımı" hatasıyla geri çağırma yapılmadan önce send işleminin tamamlanması için beklenecek maksimum süre (milisaniye cinsinden). Değer sıfırsa gönderme zaman aşımı hataları tetiklenmez. Varsayılan olarak 0 değerine ayarlanır.

  • stopBits

    StopBits isteğe bağlı

    "one" varsayılan olarak iletilir.

DataBits

Enum

DeviceControlSignals

Özellikler

  • cts

    boolean

    CTS (Göndermek İçin Temizle) seçeneğini tıklayın.

  • dcd

    boolean

    DCD (Veri Operatörü Algılama) veya RLSD (Alıcı Hat Sinyali/ Algılama).

  • dsr

    boolean

    DSR (Veri Kümesi Hazır).

  • ri

    boolean

    RI (Zil Göstergesi).

DeviceInfo

Özellikler

  • displayName

    string isteğe bağlı

    Ana cihaz sürücüsü tarafından sorgulanabiliyorsa temel cihazın, kullanıcılar tarafından okunabilir görünen adı.

  • yol

    dize

    Cihazın sistem yolu. Bu cihaza bağlanmak için bu anahtar, chrome.serial.connect öğesine path bağımsız değişkeni olarak iletilmelidir.

  • productId

    numara isteğe bağlı

    Temel cihaz için belirlenebiliyorsa bir USB ürün kimliği.

  • vendorId

    numara isteğe bağlı

    Temel cihaz için belirlenebiliyorsa bir PCI veya USB tedarikçi firma kimliği.

HostControlSignals

Özellikler

  • dtr

    boole isteğe bağlı

    DTR (Veri Terminali Hazır).

  • rts

    boole isteğe bağlı

    RTS (Gönderme İsteği) seçeneğini belirleyin.

ParityBit

Enum

"no" (hayır)

"odd":

"even"

ReceiveError

Enum

"disconnected"
Bağlantı kesildi.

"timeout"
receiveTimeout milisaniyedir boyunca veri alınmadı.

"device_lost"
Cihazın ana makineyle bağlantısı büyük olasılıkla kesildi.

"break"
Cihaz, bir ara koşulu algıladı.

"frame_error"
Cihaz, çerçeveleme hatası algıladı.

"overrun"
Karakter arabelleği aşımı oluştu. Sonraki karakter kaybolur.

"buffer_overflow"
Giriş arabellek taşması gerçekleşti. Giriş arabelleğinde yer yok veya dosya sonu (EOF) karakterinden sonra bir karakter alındı.

"parity_error"
Cihaz bir parite hatası algıladı.

"system_error"
Bir sistem hatası oluştu ve bağlantı kurtarılamaz.

ReceiveErrorInfo

Özellikler

  • connectionId

    sayı

    Bağlantı tanımlayıcısı.

  • Sorunun ne olduğunu gösteren bir hata kodu.

ReceiveInfo

Özellikler

  • connectionId

    sayı

    Bağlantı tanımlayıcısı.

  • veri

    ArrayBuffer

    Alınan veriler.

SendError

Enum

"disconnected"
Bağlantı kesildi.

"pending"
Bir gönderim zaten beklemede.

"timeout"
Gönderme işlemi zaman aşımına uğradı.

"system_error"
Bir sistem hatası oluştu ve bağlantı kurtarılamaz.

SendInfo

Özellikler

  • bytesSent

    sayı

    Gönderilen bayt sayısı.

  • hata

    SendError isteğe bağlı

    Hata oluştuysa hata kodu.

StopBits

Enum

Yöntemler

clearBreak()

Söz Chrome 45 ve sonraki sürümler 
chrome.serial.clearBreak(
  connectionId: number,
  callback?: function,
)

Belirli bir bağlantıda karakter iletimini geri yükleyin ve iletim satırını kesintisiz bir duruma getirin.

Parametreler

  • connectionId

    sayı

    Bağlantının kimliği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: boolean)=>void

    • sonuç

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

connect()

Söz 
chrome.serial.connect(
  path: string,
  options?: ConnectionOptions,
  callback?: function,
)

Belirli bir seri bağlantı noktasına bağlanır.

Parametreler

  • yol

    dize

    Açılacak seri bağlantı noktasının sistem yolu.

  • seçenekler

    ConnectionOptions (isteğe bağlı)

    Bağlantı noktası yapılandırma seçenekleri.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (connectionInfo: ConnectionInfo)=>void

İlerlemeler

  • Promise<ConnectionInfo>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

disconnect()

Söz 
chrome.serial.disconnect(
  connectionId: number,
  callback?: function,
)

Seri bağlantı noktasının bağlantısı kesilir.

Parametreler

  • connectionId

    sayı

    Açılan bağlantının kimliği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: boolean)=>void

    • sonuç

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

flush()

Söz 
chrome.serial.flush(
  connectionId: number,
  callback?: function,
)

Belirtilen bağlantının giriş ve çıkış arabelleklerindeki tüm baytları boşaltır.

Parametreler

  • connectionId

    sayı

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: boolean)=>void

    • sonuç

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getConnections()

Söz 
chrome.serial.getConnections(
  callback?: function,
)

Uygulamanın sahip olduğu, açık durumdaki seri bağlantı noktası bağlantılarının listesini alır.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (connectionInfos: ConnectionInfo[])=>void

İlerlemeler

  • Promise<ConnectionInfo[]>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getControlSignals()

Söz 
chrome.serial.getControlSignals(
  connectionId: number,
  callback?: function,
)

Belirli bir bağlantıdaki kontrol sinyallerinin durumunu alır.

Parametreler

  • connectionId

    sayı

    Bağlantının kimliği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (signals: DeviceControlSignals)=>void

İlerlemeler

  • Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getDevices()

Söz 
chrome.serial.getDevices(
  callback?: function,
)

Sistemdeki kullanılabilir seri cihazlarla ilgili bilgileri döndürür. Bu yöntem her çağrıldığında liste yeniden oluşturulur.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (ports: DeviceInfo[])=>void

İlerlemeler

  • Promise<DeviceInfo[]>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getInfo()

Söz 
chrome.serial.getInfo(
  connectionId: number,
  callback?: function,
)

Belirli bir bağlantının durumunu getirir.

Parametreler

  • connectionId

    sayı

    Açılan bağlantının kimliği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (connectionInfo: ConnectionInfo)=>void

İlerlemeler

  • Promise<ConnectionInfo>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

send()

Söz 
chrome.serial.send(
  connectionId: number,
  data: ArrayBuffer,
  callback?: function,
)

Belirtilen bağlantıya veri yazar.

Parametreler

  • connectionId

    sayı

    Bağlantının kimliği.

  • veri

    ArrayBuffer

    Gönderilecek veriler.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (sendInfo: SendInfo)=>void

İlerlemeler

  • Promise<SendInfo>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

setBreak()

Söz Chrome 45 ve sonraki sürümler 
chrome.serial.setBreak(
  connectionId: number,
  callback?: function,
)

Belirli bir bağlantıda karakter iletimini askıya alır ve clearBreak çağrılana kadar iletim hattını ara durumuna getirir.

Parametreler

  • connectionId

    sayı

    Bağlantının kimliği.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: boolean)=>void

    • sonuç

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

setControlSignals()

Söz 
chrome.serial.setControlSignals(
  connectionId: number,
  signals: HostControlSignals,
  callback?: function,
)

Belirli bir bağlantıdaki kontrol sinyallerinin durumunu ayarlar.

Parametreler

  • connectionId

    sayı

    Bağlantının kimliği.

  • Cihaza gönderilecek sinyal grubu değişir.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: boolean)=>void

    • sonuç

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

setPaused()

Söz 
chrome.serial.setPaused(
  connectionId: number,
  paused: boolean,
  callback?: function,
)

Açık bir bağlantıyı duraklatır veya devam ettirir.

Parametreler

  • connectionId

    sayı

    Açılan bağlantının kimliği.

  • duraklatıldı

    boolean

    İşaretle.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

update()

Söz 
chrome.serial.update(
  connectionId: number,
  options: ConnectionOptions,
  callback?: function,
)

Açık bir seri bağlantı noktası bağlantısında seçenek ayarlarını güncelleyin.

Parametreler

  • connectionId

    sayı

    Açılan bağlantının kimliği.

  • seçenekler

    ConnectionOptions

    Bağlantı noktası yapılandırma seçenekleri.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: boolean)=>void

    • sonuç

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

Etkinlikler

onReceive

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

Bağlantıdan veri okunduğunda etkinlik oluşuyor.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (info: ReceiveInfo)=>void

onReceiveError

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

Çalışma zamanı seri bağlantı noktasında veri beklerken bir hata oluştuğunda etkinlik oluşuyordu. Bu etkinlik oluşturulduktan sonra bağlantı paused olarak ayarlanabilir. "timeout" hatası, bağlantıyı duraklatmaz.

Parametreler