chrome.serial

شرح

از chrome.serial API برای خواندن و نوشتن در دستگاه متصل به پورت سریال استفاده کنید.

مجوزها

serial

انواع

ConnectionInfo

خواص

  • نرخ بیت

    شماره اختیاری

    به ConnectionOptions.bitrate مراجعه کنید. این قسمت ممکن است حذف یا نادرست باشد، اگر از یک نرخ بیت غیر استاندارد استفاده می شود، یا اگر خطایی در هنگام جستجو در دستگاه اصلی رخ داده باشد.

  • bufferSize

    عدد

    به ConnectionOptions.bufferSize مراجعه کنید

  • شناسه اتصال

    عدد

    شناسه اتصال پورت سریال.

  • ctsFlowControl

    بولی اختیاری

    ConnectionOptions.ctsFlowControl را ببینید. در صورت بروز خطا در هنگام پرس و جو از دستگاه اصلی، ممکن است این فیلد حذف شود.

  • داده بیت ها

    DataBits اختیاری است

    ConnectionOptions.dataBits را ببینید. در صورت بروز خطا در هنگام پرس و جو از دستگاه اصلی، ممکن است این فیلد حذف شود.

  • نام

    رشته

    به ConnectionOptions.name مراجعه کنید

  • parityBit

    ParityBit اختیاری است

    ConnectionOptions.parityBit را ببینید. در صورت بروز خطا در هنگام پرس و جو از دستگاه اصلی، ممکن است این فیلد حذف شود.

  • مکث کرد

    بولی

    پرچمی که نشان می‌دهد آیا اتصال در رویدادهای Receive فعال نمی‌شود یا خیر.

  • مداوم

    بولی

    به ConnectionOptions.persistent مراجعه کنید

  • دریافت تایم اوت

    عدد

    ConnectionOptions.receiveTimeout را ببینید

  • ارسال تایم اوت

    عدد

    به ConnectionOptions.sendTimeout مراجعه کنید

  • stopBits

    StopBits اختیاری است

    ConnectionOptions.stopBits را ببینید. اگر هنگام پرس و جو از دستگاه زیربنایی خطایی رخ داده باشد، ممکن است این فیلد حذف شود.

ConnectionOptions

خواص

  • میزان بیت

    شماره اختیاری

    نرخ بیت درخواستی اتصال برای باز شدن. برای سازگاری با وسیع‌ترین طیف سخت‌افزار، این عدد باید با یکی از بیت‌ریت‌های رایج در دسترس مانند 110، 300، 1200، 2400، 4800، 9600، 14400، 19200، 38400، 57600، 57600، 115 مطابقت داشته باشد. البته، دستگاه متصل به پورت سریال از بیت ریت درخواستی پشتیبانی می کند، حتی اگر خود پورت آن بیت ریت را پشتیبانی کند. 9600 به صورت پیش فرض ارسال می شود.

  • bufferSize

    شماره اختیاری

    اندازه بافری که برای دریافت داده ها استفاده می شود. مقدار پیش فرض 4096 است.

  • ctsFlowControl

    بولی اختیاری

    پرچم را نشان می دهد که آیا کنترل جریان سخت افزاری RTS/CTS فعال شود یا خیر. پیش فرض به نادرست.

  • داده بیت ها

    DataBits اختیاری است

    "eight" به طور پیش فرض ارسال می شود.

  • نام

    رشته اختیاری

    یک رشته تعریف شده توسط برنامه برای ارتباط با اتصال.

  • parityBit

    ParityBit اختیاری است

    "no" به طور پیش فرض ارسال می شود.

  • مداوم

    بولی اختیاری

    پرچمی که نشان می دهد آیا اتصال باید در زمان تعلیق برنامه باز بماند یا نه (به مدیریت چرخه عمر برنامه مراجعه کنید). مقدار پیش فرض غلط است." هنگامی که برنامه بارگیری می شود، هر اتصال سریالی که قبلاً با persistent=true باز شده است را می توان با getConnections واکشی کرد.

  • دریافت تایم اوت

    شماره اختیاری

    حداکثر زمان (بر حسب میلی ثانیه) برای انتظار برای داده های جدید قبل از بالا بردن یک رویداد onReceiveError با خطای "timeout". اگر صفر باشد، خطاهای دریافت مهلت زمانی برای اتصال افزایش نخواهد یافت. پیش فرض 0 است.

  • ارسال تایم اوت

    شماره اختیاری

    حداکثر زمان (بر حسب میلی ثانیه) برای انتظار برای تکمیل یک عملیات send قبل از تماس پاسخ با خطای "تایم اوت". اگر صفر باشد، خطاهای مهلت ارسال ارسال نمی شود. پیش فرض 0 است.

  • stopBits

    StopBits اختیاری است

    "one" به طور پیش فرض ارسال می شود.

DataBits

Enum

"هفت"

"هشت"

DeviceControlSignals

خواص

  • cts

    بولی

    CTS (پاک کردن برای ارسال).

  • دی سی دی

    بولی

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

  • dsr

    بولی

    DSR (مجموعه داده آماده).

  • ری

    بولی

    RI (نشانگر حلقه).

DeviceInfo

خواص

  • نمایش نام

    رشته اختیاری

    اگر بتوان از درایور میزبان درخواست کرد، یک نام نمایشی قابل خواندن توسط انسان برای دستگاه زیرین.

  • مسیر

    رشته

    مسیر سیستم دستگاه این باید به عنوان آرگومان path به chrome.serial.connect ارسال شود تا به این دستگاه متصل شوید.

  • شناسه محصول

    شماره اختیاری

    شناسه محصول USB اگر بتوان برای دستگاه زیربنایی تعیین کرد.

  • شناسه فروشنده

    شماره اختیاری

    شناسه فروشنده PCI یا USB اگر بتوان برای دستگاه زیربنایی تعیین کرد.

HostControlSignals

خواص

  • dtr

    بولی اختیاری

    DTR (Data Terminal Ready).

  • rts

    بولی اختیاری

    RTS (درخواست ارسال).

ParityBit

Enum

"نه"

"فرد"

"زوج"

ReceiveError

Enum

"قطع شده"
اتصال قطع شد.

"تایم اوت"
هیچ داده ای برای receiveTimeout میلی ثانیه دریافت نشده است.

"دستگاه_از دست رفته"
به احتمال زیاد ارتباط دستگاه با میزبان قطع شده است.

"زنگ تفريح"
دستگاه یک وضعیت شکست را تشخیص داد.

"frame_error"
دستگاه یک خطای کادربندی را شناسایی کرد.

"غلو"
یک سرریز کاراکتر بافر رخ داده است. شخصیت بعدی گم شده است.

"سرریز بافر"
سرریز بافر ورودی رخ داده است. یا جایی در بافر ورودی وجود ندارد، یا یک کاراکتر بعد از نویسه پایان فایل (EOF) دریافت شده است.

"parity_error"
دستگاه یک خطای برابری را شناسایی کرد.

"خطای سیستم"
یک خطای سیستم رخ داده است و ممکن است اتصال غیرقابل بازیابی باشد.

ReceiveErrorInfo

خواص

  • شناسه اتصال

    عدد

    شناسه اتصال

  • خطا

    ReceiveError

    کد خطایی که نشان می دهد چه مشکلی رخ داده است.

ReceiveInfo

خواص

  • شناسه اتصال

    عدد

    شناسه اتصال

  • داده ها

    ArrayBuffer

    داده های دریافت شده

SendError

Enum

"قطع شده"
اتصال قطع شد.

"انتظار"
ارسال از قبل در انتظار بود.

"تایم اوت"
زمان ارسال تمام شد.

"خطای سیستم"
یک خطای سیستم رخ داده است و ممکن است اتصال غیرقابل بازیابی باشد.

SendInfo

خواص

  • bytesSent

    عدد

    تعداد بایت های ارسال شده

  • خطا

    SendError اختیاری است

    یک کد خطا در صورت بروز خطا.

StopBits

Enum

"یک"

"دو"

مواد و روش ها

clearBreak()

Promise Chrome 45+
chrome.serial.clearBreak(
  connectionId: number,
  callback?: function,
)

انتقال کاراکتر در یک اتصال مشخص را بازیابی کنید و خط انتقال را در حالت بدون وقفه قرار دهید.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: boolean)=>void

    • نتیجه

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

connect()

وعده
chrome.serial.connect(
  path: string,
  options?: ConnectionOptions,
  callback?: function,
)

به یک پورت سریال مشخص متصل می شود.

مولفه های

  • مسیر

    رشته

    مسیر سیستم پورت سریال برای باز شدن.

  • گزینه ها

    ConnectionOptions اختیاری است

    گزینه های پیکربندی پورت

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (connectionInfo: ConnectionInfo)=>void

برمی گرداند

  • Promise< ConnectionInfo >

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

disconnect()

وعده
chrome.serial.disconnect(
  connectionId: number,
  callback?: function,
)

از پورت سریال جدا می شود.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال باز شده

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: boolean)=>void

    • نتیجه

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

flush()

وعده
chrome.serial.flush(
  connectionId: number,
  callback?: function,
)

تمام بایت ها را در بافرهای ورودی و خروجی اتصال داده شده شستشو می دهد.

مولفه های

  • شناسه اتصال

    عدد

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: boolean)=>void

    • نتیجه

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getConnections()

وعده
chrome.serial.getConnections(
  callback?: function,
)

لیست اتصالات پورت سریال باز شده در حال حاضر متعلق به برنامه را بازیابی می کند.

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (connectionInfos: ConnectionInfo[])=>void

برمی گرداند

  • Promise< ConnectionInfo []>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getControlSignals()

وعده
chrome.serial.getControlSignals(
  connectionId: number,
  callback?: function,
)

وضعیت سیگنال های کنترلی را در یک اتصال مشخص بازیابی می کند.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (signals: DeviceControlSignals)=>void

برمی گرداند

  • Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getDevices()

وعده
chrome.serial.getDevices(
  callback?: function,
)

اطلاعات مربوط به دستگاه های سریال موجود در سیستم را برمی گرداند. هر بار که این متد فراخوانی می شود، لیست دوباره تولید می شود.

مولفه های

برمی گرداند

  • Promise< DeviceInfo []>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getInfo()

وعده
chrome.serial.getInfo(
  connectionId: number,
  callback?: function,
)

وضعیت یک اتصال داده شده را بازیابی می کند.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال باز شده

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (connectionInfo: ConnectionInfo)=>void

برمی گرداند

  • Promise< ConnectionInfo >

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

send()

وعده
chrome.serial.send(
  connectionId: number,
  data: ArrayBuffer,
  callback?: function,
)

داده ها را در اتصال داده شده می نویسد.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال

  • داده ها

    ArrayBuffer

    داده های ارسالی

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (sendInfo: SendInfo)=>void

برمی گرداند

  • وعده< SendInfo >

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

setBreak()

Promise Chrome 45+
chrome.serial.setBreak(
  connectionId: number,
  callback?: function,
)

انتقال کاراکتر را در یک اتصال معین به حالت تعلیق در می آورد و خط انتقال را در حالت قطع قرار می دهد تا زمانی که clearBreak فراخوانی شود.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: boolean)=>void

    • نتیجه

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

setControlSignals()

وعده
chrome.serial.setControlSignals(
  connectionId: number,
  signals: HostControlSignals,
  callback?: function,
)

وضعیت سیگنال های کنترلی را در یک اتصال مشخص تنظیم می کند.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال

  • سیگنال ها

    HostControlSignals

    مجموعه سیگنال ها برای ارسال به دستگاه تغییر می کند.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: boolean)=>void

    • نتیجه

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

setPaused()

وعده
chrome.serial.setPaused(
  connectionId: number,
  paused: boolean,
  callback?: function,
)

اتصال باز را متوقف یا لغو مکث می کند.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال باز شده

  • مکث کرد

    بولی

    برای نشان دادن توقف یا لغو مکث پرچم گذاری کنید.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

update()

وعده
chrome.serial.update(
  connectionId: number,
  options: ConnectionOptions,
  callback?: function,
)

تنظیمات گزینه را در اتصال پورت سریال باز به روز کنید.

مولفه های

  • شناسه اتصال

    عدد

    شناسه اتصال باز شده

  • گزینه های پیکربندی پورت

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: boolean)=>void

    • نتیجه

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

مناسبت ها

onReceive

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

زمانی که داده‌ها از اتصال خوانده می‌شوند، رویداد مطرح می‌شود.

مولفه های

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (info: ReceiveInfo)=>void

onReceiveError

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

زمانی که در زمان اجرا منتظر داده‌ها در پورت سریال بود، خطایی روی داد. هنگامی که این رویداد مطرح شد، اتصال ممکن است روی paused تنظیم شود. خطای "timeout" اتصال را متوقف نمی کند.

مولفه های