chrome.serial

ब्यौरा

सीरियल पोर्ट से कनेक्ट किए गए डिवाइस से पढ़ने और उसमें बदलाव करने के लिए, chrome.serial एपीआई का इस्तेमाल करें.

अनुमतियां

serial

टाइप

ConnectionInfo

प्रॉपर्टी

  • बिटरेट

    नंबर वैकल्पिक

    ConnectionOptions.bitrate देखें. अगर बिना मानक वाला बिटरेट इस्तेमाल किया जा रहा है या दिए गए डिवाइस की क्वेरी करते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड को हटाया जा सकता है या इसकी सटीक जानकारी नहीं दी जा सकती.

  • bufferSize

    संख्या

    ConnectionOptions.bufferSize देखें

  • connectionId

    संख्या

    सीरियल पोर्ट कनेक्शन का आईडी.

  • ctsFlowControl

    बूलियन ज़रूरी नहीं

    ConnectionOptions.ctsFlowControl देखें. अगर दिए गए डिवाइस की क्वेरी करते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड को हटाया जा सकता है.

  • dataBits

    DataBits ज़रूरी नहीं

    ConnectionOptions.dataBits देखें. अगर दिए गए डिवाइस की क्वेरी करते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड को हटाया जा सकता है.

  • नाम

    स्ट्रिंग

    ConnectionOptions.name देखें

  • parityBit

    ParityBit ज़रूरी नहीं

    ConnectionOptions.parityBit देखें. अगर दिए गए डिवाइस की क्वेरी करते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड को हटाया जा सकता है.

  • रोका गया

    बूलियन

    इस फ़्लैग से पता चलता है कि कनेक्शन को पाने वाले इवेंट ट्रिगर करने से ब्लॉक किया गया है या नहीं.

  • अनवरत

    बूलियन

    ConnectionOptions.persistent देखें

  • receiveTimeout

    संख्या

    ConnectionOptions.receiveTimeout देखें

  • sendTimeout

    संख्या

    ConnectionOptions.sendTimeout देखें

  • stopBits

    StopBits ज़रूरी नहीं

    ConnectionOptions.stopBits देखें. अगर दिए गए डिवाइस की क्वेरी करते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड को हटाया जा सकता है.

ConnectionOptions

प्रॉपर्टी

  • बिटरेट

    नंबर वैकल्पिक

    कनेक्शन के लिए अनुरोध किया गया बिटरेट, जिसे खोला जाना है. हार्डवेयर की सबसे बड़ी रेंज के साथ काम करने के लिए, यह नंबर आम तौर पर उपलब्ध बिटरेट से मेल खाना चाहिए. जैसे, 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200. इस बात की कोई गारंटी नहीं है कि सीरियल पोर्ट से कनेक्ट किया गया डिवाइस, अनुरोध किए गए बिटरेट के साथ काम करेगा, भले ही पोर्ट खुद उस बिटरेट के साथ काम करता हो. 9600 को डिफ़ॉल्ट रूप से पास कर दिया जाएगा.

  • bufferSize

    नंबर वैकल्पिक

    डेटा पाने के लिए इस्तेमाल किए गए बफ़र का साइज़. डिफ़ॉल्ट तौर पर, यह वैल्यू 4096 है.

  • ctsFlowControl

    बूलियन ज़रूरी नहीं

    फ़्लैग बताता है कि आरटीएस/सीटीएस हार्डवेयर फ़्लो कंट्रोल चालू करना है या नहीं. डिफ़ॉल्ट तौर पर, 'गलत' पर सेट होती है.

  • dataBits

    DataBits ज़रूरी नहीं

    "eight" को डिफ़ॉल्ट रूप से पास कर दिया जाएगा.

  • नाम

    स्ट्रिंग ज़रूरी नहीं

    कनेक्शन के साथ जोड़ने के लिए ऐप्लिकेशन के ज़रिए तय की गई स्ट्रिंग.

  • parityBit

    ParityBit ज़रूरी नहीं

    "no" को डिफ़ॉल्ट रूप से पास कर दिया जाएगा.

  • अनवरत

    बूलियन ज़रूरी नहीं

    इस फ़्लैग से पता चलता है कि ऐप्लिकेशन के निलंबित होने पर, कनेक्शन को खुला रखना है या नहीं. ज़्यादा जानकारी के लिए, ऐप्लिकेशन की लाइफ़साइकल मैनेज करना लेख पढ़ें. डिफ़ॉल्ट वैल्यू "गलत" है. ऐप्लिकेशन लोड होने पर, स्थायी=true के साथ पहले से खोले गए सभी सीरियल कनेक्शन, getConnections की मदद से फ़ेच किए जा सकते हैं.

  • receiveTimeout

    नंबर वैकल्पिक

    "समय खत्म" होने के बाद onReceiveError इवेंट को बढ़ाने से पहले, नए डेटा के लिए इंतज़ार का ज़्यादा से ज़्यादा समय (मिलीसेकंड में) गड़बड़ी. शून्य होने पर, कनेक्शन के लिए टाइम आउट से जुड़ी गड़बड़ियां नहीं दिखेंगी. डिफ़ॉल्ट तौर पर, यह वैल्यू 0 पर सेट होती है.

  • sendTimeout

    नंबर वैकल्पिक

    "समय खत्म" होने के बाद कॉलबैक को कॉल करने से पहले, send कार्रवाई पूरी होने तक इंतज़ार का ज़्यादा से ज़्यादा समय (मिलीसेकंड में) गड़बड़ी. शून्य होने पर, 'भेजने का समय' गड़बड़ियां ट्रिगर नहीं होंगी. डिफ़ॉल्ट तौर पर, यह वैल्यू 0 पर सेट होती है.

  • stopBits

    StopBits ज़रूरी नहीं

    "one" को डिफ़ॉल्ट रूप से पास कर दिया जाएगा.

DataBits

Enum

"सात"

"आठ"

DeviceControlSignals

प्रॉपर्टी

  • सीटीएस

    बूलियन

    सीटीएस (भेजने के लिए साफ़ करें).

  • dcd

    बूलियन

    DCD (डेटा कैरियर डिटेक्ट) या RLSD (लाइन सिग्नल/ डिटेक्ट पाएं).

  • dsr

    बूलियन

    DSR (डेटा सेट के लिए तैयार).

  • री

    बूलियन

    RI (रिंग इंडिकेटर).

DeviceInfo

प्रॉपर्टी

  • displayName

    स्ट्रिंग ज़रूरी नहीं

    अगर होस्ट ड्राइवर से क्वेरी की जा सकती है, तो मौजूदा डिवाइस का डिसप्ले नेम, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

  • पाथ

    स्ट्रिंग

    डिवाइस का सिस्टम पाथ. इस डिवाइस से कनेक्ट करने के लिए, इसे path आर्ग्युमेंट के तौर पर chrome.serial.connect को पास किया जाना चाहिए.

  • productId

    नंबर वैकल्पिक

    यूएसबी प्रॉडक्ट आईडी, अगर किसी डिवाइस के लिए तय किया जा सकता है.

  • vendorId

    नंबर वैकल्पिक

    अगर पहले से मौजूद डिवाइस के लिए, पीसीआई या यूएसबी वेंडर आईडी की पहचान हो पाती है.

HostControlSignals

प्रॉपर्टी

  • dtr

    बूलियन ज़रूरी नहीं

    DTR (डेटा टर्मिनल के लिए तैयार).

  • आरटीएस

    बूलियन ज़रूरी नहीं

    आरटीएस (भेजने का अनुरोध).

ParityBit

Enum

"नहीं"

"अजीब"

"भी"

ReceiveError

Enum

"डिसकनेक्ट किया गया"
कनेक्शन डिसकनेक्ट हो गया था.

"समय खत्म"
receiveTimeout मिलीसेकंड के लिए कोई डेटा नहीं मिला.

"device_lost"
शायद डिवाइस को होस्ट से डिसकनेक्ट कर दिया गया था.

"break"
डिवाइस ने ब्रेक की स्थिति का पता लगाया है.

"frame_error"
डिवाइस पर फ़्रेमिंग की गड़बड़ी का पता चला है.

"ओवररन"
वर्ण-बफ़र ओवररन हुआ है. अगला किरदार खो जाता है.

"buffer_overflow"
इनपुट बफ़र ओवरफ़्लो हुआ. इनपुट बफ़र में कोई जगह नहीं है या फ़ाइल के आखिर (EOF) वर्ण के बाद कोई वर्ण मिला है.

"parity_error"
डिवाइस पर पैरिटी की गड़बड़ी का पता चला है.

"system_error"
सिस्टम में कोई गड़बड़ी हुई और हो सकता है कि कनेक्शन ठीक न हो.

ReceiveErrorInfo

प्रॉपर्टी

  • connectionId

    संख्या

    कनेक्शन आइडेंटिफ़ायर.

  • गड़बड़ी

    गड़बड़ी का एक कोड, जो बताता है कि क्या गड़बड़ी हुई.

ReceiveInfo

प्रॉपर्टी

  • connectionId

    संख्या

    कनेक्शन आइडेंटिफ़ायर.

  • डेटा

    अरेबफ़र

    डेटा मिला.

SendError

Enum

"डिसकनेक्ट किया गया"
कनेक्शन डिसकनेक्ट हो गया था.

"मंज़ूरी बाकी"
भेजना पहले ही बाकी था.

"समय खत्म"
भेजने का समय खत्म हो गया.

"system_error"
सिस्टम में कोई गड़बड़ी हुई और हो सकता है कि कनेक्शन ठीक न हो.

SendInfo

प्रॉपर्टी

  • bytesSent

    संख्या

    भेजे गए बाइट की संख्या.

  • गड़बड़ी

    SendError ज़रूरी नहीं

    अगर कोई गड़बड़ी हुई है, तो गड़बड़ी का कोड.

StopBits

Enum

"एक"

"दो"

तरीके

clearBreak()

प्रॉमिस Chrome 45 और उसके बाद वाले वर्शन के लिए
chrome.serial.clearBreak(
  connectionId: number,
  callback?: function,
)

दिए गए कनेक्शन पर कैरेक्टर ट्रांसमिशन को पहले जैसा करें और ट्रांसमिशन लाइन को नॉनब्रेक स्थिति में रखें.

पैरामीटर

  • connectionId

    संख्या

    कनेक्शन का आईडी.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (result: boolean) => void

    • नतीजा

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

connect()

प्रॉमिस
chrome.serial.connect(
  path: string,
  options?: ConnectionOptions,
  callback?: function,
)

दिए गए सीरियल पोर्ट से कनेक्ट करता है.

पैरामीटर

  • पाथ

    स्ट्रिंग

    सीरियल पोर्ट का सिस्टम पाथ, जिसे खोलना है.

  • विकल्प

    ConnectionOptions वैकल्पिक

    पोर्ट कॉन्फ़िगरेशन के विकल्प.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (connectionInfo: ConnectionInfo) => void

रिटर्न

  • Promise<ConnectionInfo>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

disconnect()

प्रॉमिस
chrome.serial.disconnect(
  connectionId: number,
  callback?: function,
)

किसी सीरियल पोर्ट से डिसकनेक्ट होता है.

पैरामीटर

  • connectionId

    संख्या

    खुले हुए कनेक्शन का आईडी.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (result: boolean) => void

    • नतीजा

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

flush()

प्रॉमिस
chrome.serial.flush(
  connectionId: number,
  callback?: function,
)

दिए गए कनेक्शन के इनपुट और आउटपुट बफ़र में सभी बाइट फ़्लश करता है.

पैरामीटर

  • connectionId

    संख्या

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (result: boolean) => void

    • नतीजा

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

getConnections()

प्रॉमिस
chrome.serial.getConnections(
  callback?: function,
)

ऐप्लिकेशन के मालिकाना हक वाले, हाल ही में खोले गए सीरियल पोर्ट कनेक्शन की सूची लाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (connectionInfos: ConnectionInfo[]) => void

रिटर्न

  • Promise<ConnectionInfo[]>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

getControlSignals()

प्रॉमिस
chrome.serial.getControlSignals(
  connectionId: number,
  callback?: function,
)

दिए गए कनेक्शन पर, कंट्रोल सिग्नल की स्थिति का पता लगाता है.

पैरामीटर

  • connectionId

    संख्या

    कनेक्शन का आईडी.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (signals: DeviceControlSignals) => void

रिटर्न

  • Promise<DeviceControlSignals>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

getDevices()

प्रॉमिस
chrome.serial.getDevices(
  callback?: function,
)

सिस्टम पर उपलब्ध सीरियल डिवाइसों की जानकारी दिखाता है. इस तरीके को हर बार कॉल करने पर, सूची फिर से जनरेट होती है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (ports: DeviceInfo[]) => void

रिटर्न

  • Promise<DeviceInfo[]>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

getInfo()

प्रॉमिस
chrome.serial.getInfo(
  connectionId: number,
  callback?: function,
)

दिए गए कनेक्शन की स्थिति का पता लगाता है.

पैरामीटर

  • connectionId

    संख्या

    खुले हुए कनेक्शन का आईडी.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (connectionInfo: ConnectionInfo) => void

रिटर्न

  • Promise<ConnectionInfo>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

send()

प्रॉमिस
chrome.serial.send(
  connectionId: number,
  data: ArrayBuffer,
  callback?: function,
)

दिए गए कनेक्शन में डेटा लिखता है.

पैरामीटर

  • connectionId

    संख्या

    कनेक्शन का आईडी.

  • डेटा

    अरेबफ़र

    भेजा जाने वाला डेटा.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (sendInfo: SendInfo) => void

रिटर्न

  • Promise<SendInfo>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

setBreak()

प्रॉमिस Chrome 45 और उसके बाद वाले वर्शन के लिए
chrome.serial.setBreak(
  connectionId: number,
  callback?: function,
)

दिए गए कनेक्शन पर, कैरेक्टर के ट्रांसमिशन को निलंबित करता है और ट्रांसमिशन लाइन को ब्रेक की स्थिति में तब तक रखता है, जब तक clearBreak को कॉल नहीं किया जाता.

पैरामीटर

  • connectionId

    संख्या

    कनेक्शन का आईडी.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (result: boolean) => void

    • नतीजा

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

setControlSignals()

प्रॉमिस
chrome.serial.setControlSignals(
  connectionId: number,
  signals: HostControlSignals,
  callback?: function,
)

दिए गए कनेक्शन पर, कंट्रोल सिग्नल की स्थिति सेट करता है.

पैरामीटर

  • connectionId

    संख्या

    कनेक्शन का आईडी.

  • सिग्नल

    डिवाइस पर भेजने के लिए सिग्नल का सेट बदल जाता है.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (result: boolean) => void

    • नतीजा

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

setPaused()

प्रॉमिस
chrome.serial.setPaused(
  connectionId: number,
  paused: boolean,
  callback?: function,
)

किसी खुले हुए कनेक्शन को रोकता या फिर से चालू करता है.

पैरामीटर

  • connectionId

    संख्या

    खुले हुए कनेक्शन का आईडी.

  • रोका गया

    बूलियन

    रोकने या फिर से शुरू करने के बारे में बताने के लिए फ़्लैग करें.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    () => void

रिटर्न

  • प्रॉमिस<void>

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

update()

प्रॉमिस
chrome.serial.update(
  connectionId: number,
  options: ConnectionOptions,
  callback?: function,
)

किसी खुले हुए सीरियल पोर्ट कनेक्शन पर, विकल्प की सेटिंग अपडेट करें.

पैरामीटर

  • connectionId

    संख्या

    खुले हुए कनेक्शन का आईडी.

  • विकल्प

    पोर्ट कॉन्फ़िगरेशन के विकल्प.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है:

    (result: boolean) => void

    • नतीजा

      बूलियन

रिटर्न

  • Promise&lt;boolean&gt;

    Chrome 117 और उसके बाद वाले वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

इवेंट

onReceive

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

कनेक्शन से डेटा पढ़े जाने पर इवेंट उठाया गया.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है:

    (info: ReceiveInfo) => void

onReceiveError

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

जब रनटाइम, सीरियल पोर्ट पर डेटा का इंतज़ार कर रहा था, तब कोई गड़बड़ी होने पर इवेंट की जानकारी दी गई. यह इवेंट शुरू होने के बाद, कनेक्शन paused पर सेट हो सकता है. "timeout" गड़बड़ी की वजह से कनेक्शन नहीं रुकता.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है:

    (info: ReceiveErrorInfo) => void