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
öğesinepath
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ı.
-
hata
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()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
connect()
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
-
connectionInfo
-
İlerlemeler
-
Promise<ConnectionInfo>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
disconnect()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
flush()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getConnections()
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
-
connectionInfos
-
İlerlemeler
-
Promise<ConnectionInfo[]>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getControlSignals()
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
-
signals
-
İlerlemeler
-
Promise<DeviceControlSignals>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getDevices()
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
-
ports
-
İlerlemeler
-
Promise<DeviceInfo[]>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getInfo()
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
-
connectionInfo
-
İlerlemeler
-
Promise<ConnectionInfo>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
send()
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
-
sendInfo
-
İlerlemeler
-
Promise<SendInfo>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setBreak()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setControlSignals()
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.
-
signals
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setPaused()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
update()
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
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ümlerVaatler 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
-
bilgi
-
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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: ReceiveErrorInfo) => void
-
bilgi
-