.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "bluetoothctl-advertise" "1" "November 2022" "BlueZ" "Linux System Administration"
.SH "نام (NAME)"
bluetoothctl-advertise \- مدیریت تبلیغات بلوتوث LE
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbluetoothctl\fP [\-\-options] [advertise.commands]
.sp
این زیرمنو داده‌ها و پارامترهای تبلیغاتی LE را با استفاده از واسط‌های
\fBorg.bluez.LEAdvertisement(5)\fP و \fBorg.bluez.LEAdvertisingManager(5)\fP
پیکربندی می‌کند.
.SH "دستورات گزینه‌های تبلیغات (Advertise Options Commands)"
.SS uuids
.sp
تنظیم/دریافت UUIDهای تبلیغاتی.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> uuids [uuid1 uuid2 ...]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBServiceUUIDs\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [uuid1 uuid2 ...]
فهرست UUIDها برای تبلیغ کردن (پیش‌فرض: هیچ‌کدام)
.TP
.B مثال نمایش UUIDهای تبلیغاتی کنونی
.nf
\fB> uuids\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن UUID سرویس 16\-bit سفارشی
.nf
\fB> uuids 0x1234\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن UUID سرویس 32\-bit سفارشی
.nf
\fB> uuids 0x12345678\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن UUID سرویس 128\-bit سفارشی
.nf
\fB> uuids 90f95193\-35de\-4306\-a6e9\-699328f15059\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن سرویس‌های Battery و Generic Attribute
.nf
\fB> uuids 0x180F 0x1801\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن سرویس‌های Device Information، Battery و HID
.nf
\fB> uuids 0x180A 0x180F 0x1812\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن سرویس Generic Access
.nf
\fB> uuids 0x1800\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن سرویس Environmental Sensing
.nf
\fB> uuids 0x181A\fP
.fi
.sp
.TP
.B مثال تبلیغ کردن سرویس Pulse Oximeter
.nf
\fB> uuids 0x183B\fP
.fi
.sp
.TP
.B مثال ترکیب قالب‌های کوتاه و کامل UUID
.nf
\fB> uuids 0x180F 12345678\-1234\-5678\-9abc\-123456789abc\fP
.fi
.sp
.UNINDENT
.SS solicit
.sp
تنظیم/دریافت UUIDهای درخواست (solicit) تبلیغات.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> solicit [uuid1 uuid2 ...]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBSolicitUUIDs\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [uuid1 uuid2 ...]
فهرست UUIDها برای تبلیغ کردن (پیش‌فرض: هیچ‌کدام)
.TP
.B مثال نمایش UUIDهای سرویس درخواست‌شده کنونی
.nf
\fB> solicit\fP
.fi
.sp
.TP
.B مثال درخواست سرویس Generic Access
.nf
\fB> solicit 0x1800\fP
.fi
.sp
.TP
.B مثال درخواست سرویس Device Information
.nf
\fB> solicit 0x180A\fP
.fi
.sp
.TP
.B مثال درخواست سرویس User Data
.nf
\fB> solicit 0x181C\fP
.fi
.sp
.TP
.B مثال درخواست سرویس‌های Battery و Generic Attribute
.nf
\fB> solicit 0x180F 0x1801\fP
.fi
.sp
.TP
.B مثال درخواست سرویس‌های Device Info، Environmental Sensing و Pulse Oximeter
.nf
\fB> solicit 0x180A 0x181A 0x183B\fP
.fi
.sp
.UNINDENT
.SS service
.sp
تنظیم/دریافت داده‌های سرویس تبلیغاتی.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> service [uuid] [data=xx xx ...]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBServiceData\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [uuid]
UUID سرویس
.TP
.B [data=xx xx ...]
داده‌های سرویس
.TP
.B مثال نمایش داده‌های سرویس کنونی
.nf
\fB> service\fP
.fi
.sp
.TP
.B مثال تنظیم سطح باتری روی 100 (0x64)
.nf
\fB> service 0x180F 64\fP
.fi
.sp
.TP
.B مثال تنظیم سطح باتری روی 50 (0x32)
.nf
\fB> service 0x180F 32\fP
.fi
.sp
.TP
.B مثال تنظیم سطح باتری روی 0 (0x00)
.nf
\fB> service 0x180F 00\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های محیطی (دما، رطوبت، فشار)
.nf
\fB> service 0x181A 20 15 C8 07\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های اطلاعات دستگاه
.nf
\fB> service 0x180A 01 02 03 04\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سرویس سفارشی با UUID 128\-bit
.nf
\fB> service 12345678\-1234\-5678\-9abc\-123456789abc FF EE DD CC\fP
.fi
.sp
.UNINDENT
.SS manufacturer
.sp
تنظیم/دریافت داده‌های سازندهٔ تبلیغ.
.sp
به‌روزرسانی در حین تبلیغ کردن، به‌صورت بی‌درنگ (real time) انجام می‌شود. این مقدار در حال حاضر به ۲۵ بایت محدود است و در صورت فراتر رفتن از این مقدار بیشینه، پیام خطای \(dqToo much data\(dq بازگردانده خواهد شد. با این حال، این بررسی نمی‌کند که آیا از بیشینهٔ طول محموله (payload) تبلیغ فراتر رفته است یا خیر، بنابراین ممکن است خطایی از bluetoothd دریافت کنید مبنی بر \(dqFailed to register advertisement\(dq که به این معنی است که باید طول داده‌های سازندهٔ خود را کاهش دهید.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> manufacturer [id] [data=xx xx ...]\fP
.TP
.B استفاده‌ها (Uses)
ویژگی \fBManufacturerData\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [id]
شناسهٔ سازنده (پیش‌فرض: 0x004C برای Apple Inc.)
.TP
.B [data=xx xx ...]
داده‌های سازنده
.TP
.B مثال نمایش داده‌های فعلی سازنده
.nf
\fB> manufacturer\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازنده برای Apple Inc.
.nf
\fB> manufacturer 0x004C 01 02 03 04\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازندهٔ Apple با ۸ بایت
.nf
\fB> manufacturer 0x004C FF FE FD FC FB FA F9 F8\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازنده برای Microsoft Corp.
.nf
\fB> manufacturer 0x0006 10 11 12 13\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازنده برای Samsung Electronics
.nf
\fB> manufacturer 0x0075 AA BB CC DD EE\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازنده برای Google LLC
.nf
\fB> manufacturer 0x00E0 01 23 45 67 89 AB CD EF\fP
.fi
.sp
.TP
.B مثال تنظیم شناسهٔ سفارشی سازنده همراه با داده‌های آزمایشی
.nf
\fB> manufacturer 0xFFFF DE AD BE EF\fP
.fi
.sp
.UNINDENT
.SS data
.sp
تنظیم/دریافت داده‌های تبلیغ.
.sp
این امکان را به شما می‌دهد که داده‌ها را با یک نوع مشخص تبلیغ کنید. نمی‌توانید با این دستور از یک مقدار نوع دادهٔ ثبت‌شده {1} استفاده کنید. برای LE، تبلیغ در تبلیغات اولیه (primary advertisements) نشان داده می‌شود.
.sp
اگر فقط نوع داده را بدون هیچ داده‌ای تنظیم کنید (data 0x0c)، این کار هنگام روشن کردن تبلیغ (advertise) باعث خطای تجزیه خواهد شد.
.sp
می‌توانید داده‌های تبلیغ را در حین تبلیغ کردن تغییر دهید.
.sp
برای دریافت داده‌های تنظیم‌شدهٔ فعلی، از دستور data بدون هیچ آرگومانی استفاده کنید.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> data [type] [data=xx xx ...]\fP
.TP
.B استفاده‌ها (Uses)
ویژگی \fBData\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [type]
نوع داده‌های تبلیغ
.TP
.B [data=xx xx ...]
داده‌های تبلیغ (پیش‌فرض: هیچ)
.TP
.B مثال نمایش داده‌های فعلی تبلیغ
.nf
\fB> data\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های بازهٔ فاصلهٔ زمانی اتصال پیرو (slave connection interval range)
.nf
\fB> data 0x0C 01 0x0F 13\fP
.fi
.sp
.TP
.B مثال تنظیم نام محلی کامل به \(dqHello\(dq
.nf
\fB> data 0x09 48 65 6C 6C 6F\fP
.fi
.sp
.TP
.B مثال تنظیم نام محلی کوتاه‌شده به \(dqTest\(dq
.nf
\fB> data 0x08 54 65 73 74\fP
.fi
.sp
.TP
.B مثال تنظیم پرچم‌ها (LE General Discoverable + BR/EDR پشتیبانی نمی‌شود)
.nf
\fB> data 0x01 06\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهری (keyboard, 0x0341)
.nf
\fB> data 0x19 41 03\fP
.fi
.sp
.TP
.B مثال تنظیم سطح توان TX به +4 dBm
.nf
\fB> data 0x0A 04\fP
.fi
.sp
.TP
.B مثال تنظیم سطح توان TX به \-4 dBm
.nf
\fB> data 0x0A FC\fP
.fi
.sp
.TP
.B مثال تنظیم URI به \(dq//google.com\(dq
.nf
\fB> data 0x24 17 2F 2F 67 6F 6F 67 6C 65 2E 63 6F 6D\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سرویس برای Battery Service (شناسه 0x180F، سطح 100)
.nf
\fB> data 0x16 0F 18 64\fP
.fi
.sp
.UNINDENT
.SS sr\-uuids
.sp
تنظیم/دریافت UUIDهای پاسخ پویش (scan response).
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> sr\-uuids [uuid1 uuid2 ...]\fP
.TP
.B [uuid1 uuid2 ...]
فهرست UUIDها برای تبلیغ در پاسخ پویش (scan response)
.TP
.B مثال نمایش UUIDهای فعلی پاسخ پویش (scan response)
.nf
\fB> sr\-uuids\fP
.fi
.sp
.TP
.B مثال تنظیم Generic Access در پاسخ پویش (scan response)
.nf
\fB> sr\-uuids 0x1800\fP
.fi
.sp
.TP
.B مثال تنظیم سرویس‌های Device Info و Battery در پاسخ پویش (scan response)
.nf
\fB> sr\-uuids 0x180A 0x180F\fP
.fi
.sp
.TP
.B مثال تنظیم UUID سفارشی در پاسخ پویش (scan response)
.nf
\fB> sr\-uuids 12345678\-1234\-5678\-9abc\-123456789abc\fP
.fi
.sp
.UNINDENT
.SS sr\-solicit
.sp
تنظیم/دریافت UUIDهای درخواست‌شده در پاسخ پویش (scan response).
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> sr\-solicit [uuid1 uuid2 ...]\fP
.TP
.B [uuid1 uuid2 ...]
فهرست UUIDها برای تبلیغ در پاسخ پویش (scan response)
.TP
.B مثال نمایش UUIDهای درخواست‌شدهٔ فعلی پاسخ پویش (scan response)
.nf
\fB> sr\-solicit\fP
.fi
.sp
.TP
.B مثال درخواست سرویس Generic Attribute در پاسخ پویش (scan response)
.nf
\fB> sr\-solicit 0x1801\fP
.fi
.sp
.TP
.B مثال درخواست Device Info و Environmental Sensing در پاسخ پویش (scan response)
.nf
\fB> sr\-solicit 0x180A 0x181A\fP
.fi
.sp
.UNINDENT
.SS sr\-service
.sp
تنظیم/دریافت داده‌های سرویس در پاسخ پویش (scan response).
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> sr\-service [uuid] [data=xx xx ...]\fP
.TP
.B [uuid]
UUID سرویس
.TP
.B [data=xx xx ...]
داده‌های سرویس
.TP
.B مثال نمایش داده‌های سرویس فعلی در پاسخ پویش (scan response)
.nf
\fB> sr\-service\fP
.fi
.sp
.TP
.B مثال تنظیم سطح باتری به 128 در پاسخ پویش (scan response)
.nf
\fB> sr\-service 0x180F 80\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های محیطی در پاسخ پویش (scan response)
.nf
\fB> sr\-service 0x181A 22 18 C0 05\fP
.fi
.sp
.TP
.B مثال تنظیم اطلاعات دستگاه به \(dqHello\(dq در پاسخ پویش (scan response)
.nf
\fB> sr\-service 0x180A 48 65 6C 6C 6F\fP
.fi
.sp
.UNINDENT
.SS sr\-manufacturer
.sp
تنظیم/دریافت داده‌های سازنده در پاسخ پویش (scan response).
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> sr\-manufacturer [id] [data=xx xx ...]\fP
.TP
.B [id]
شناسهٔ سازنده (پیش‌فرض: 0x004C برای Apple Inc.)
.TP
.B [data=xx xx ...]
داده‌های سازنده
.TP
.B مثال نمایش داده‌های سازندهٔ فعلی در پاسخ پویش (scan response)
.nf
\fB> sr\-manufacturer\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازندهٔ Apple در پاسخ پویش (scan response)
.nf
\fB> sr\-manufacturer 0x004C 05 06 07 08\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سازندهٔ Microsoft در پاسخ پویش (scan response)
.nf
\fB> sr\-manufacturer 0x0006 20 21 22 23\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سفارشی سازنده در پاسخ پویش (scan response)
.nf
\fB> sr\-manufacturer 0xFFFF CA FE BA BE\fP
.fi
.sp
.UNINDENT
.SS sr\-data
.sp
تنظیم/دریافت داده‌های پاسخ پویش (scan response).
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> sr\-data [type] [data=xx xx ...]\fP
.TP
.B [type]
نوع داده‌های پاسخ پویش (scan response)
.TP
.B [data=xx xx ...]
داده‌های پاسخ پویش (scan response)
.TP
.B مثال نمایش داده‌های فعلی پاسخ پویش (scan response)
.nf
\fB> sr\-data\fP
.fi
.sp
.TP
.B مثال تنظیم نام محلی کامل \(dqScanResp\(dq در پاسخ پویش (scan response)
.nf
\fB> sr\-data 0x09 53 63 61 6E 52 65 73 70\fP
.fi
.sp
.TP
.B مثال تنظیم سطح توان TX به +8 dBm در پاسخ پویش (scan response)
.nf
\fB> sr\-data 0x0A 08\fP
.fi
.sp
.TP
.B مثال تنظیم داده‌های سرویس باتری (سطح 50) در پاسخ پویش (scan response)
.nf
\fB> sr\-data 0x16 0F 18 32\fP
.fi
.sp
.UNINDENT
.SS discoverable
.sp
تنظیم/دریافت وضعیت قابل کشف (discoverable) در اعلان.
.sp
برای LE، گزینه discoverable on در صورت روشن بودن، پرچم LE General Discoverable Mode را در اعلان اولیه بر روی true تنظیم می‌کند.
.sp
این ویژگی می‌تواند در حین اعلان (advertising) تغییر داده شود، اما تنها LE General Discoverable Mode را فعال خواهد کرد؛ حتی اگر قبلاً discoverable\-timeout را انتخاب کرده باشید، نادیده گرفته خواهد شد.
.sp
وارد کردن این دستور به تنهایی، وضعیت این تنظیم را نمایش می‌دهد.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> discoverable [on/off]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBDiscoverable\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [on/off]
فعال/غیرفعال کردن LE General Discoverable Mode
.TP
.B مثال نمایش تنظیمات فعلی قابل کشف (discoverable)
.nf
\fB> discoverable\fP
.fi
.sp
.TP
.B مثال فعال کردن LE General Discoverable Mode
.nf
\fB> discoverable on\fP
.fi
.sp
.TP
.B مثال غیرفعال کردن حالت قابل کشف (discoverable)
.nf
\fB> discoverable off\fP
.fi
.sp
.UNINDENT
.SS discoverable\-timeout
.sp
تنظیم/دریافت مهلت زمانی قابل کشف (discoverable timeout) در اعلان.
.sp
استفاده از این ویژگی در LE باعث می‌شود پرچم LE Limited Discoverable Mode در اعلان اولیه تنظیم شود و پرچم LE General Discoverable Mode تنظیم نگردد.
.sp
پرچم LE Limited Discoverable Mode پس از [seconds] ثانیه به طور خودکار خاموش می‌شود؛ برای استفاده از این ویژگی باید discoverable [on] تنظیم شده باشد.
.sp
وارد کردن این دستور به تنهایی، مقدار تنظیم‌شده فعلی را نمایش می‌دهد.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> discoverable\-timeout [seconds]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBDiscoverableTimeout\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [seconds]
مدت زمان انقضا/مهلت زمانی به ثانیه برای LE Limited Discoverable Mode
.TP
.B مثال نمایش مهلت زمانی فعلی قابل کشف (discoverable timeout)
.nf
\fB> discoverable\-timeout\fP
.fi
.sp
.TP
.B مثال تنظیم LE Limited Discoverable برای ۳۰ ثانیه
.nf
\fB> discoverable\-timeout 30\fP
.fi
.sp
.TP
.B مثال تنظیم LE Limited Discoverable برای ۲ دقیقه
.nf
\fB> discoverable\-timeout 120\fP
.fi
.sp
.TP
.B مثال تنظیم LE Limited Discoverable برای ۵ دقیقه
.nf
\fB> discoverable\-timeout 300\fP
.fi
.sp
.TP
.B مثال غیرفعال کردن مهلت زمانی قابل کشف (نامحدود)
.nf
\fB> discoverable\-timeout 0\fP
.fi
.sp
.UNINDENT
.SS tx\-power
.sp
نمایش/فعال‌سازی/غیرفعال‌سازی توان ارسال (TX power) برای اعلان.
.sp
این دستور فیلد TX Power Level را در بسته اعلان (advertising packet) تنظیم می‌کند.
.sp
این مقدار بر حسب dBm است و می‌تواند بین \-127 و 127 باشد.
.sp
هنگامی که این ویژگی روشن باشد، دستگاه LE توان ارسال خود را در اعلان اولیه منتشر می‌کند.
.sp
این ویژگی می‌تواند در حین اعلان (advertising) تغییر داده شود.
.sp
وارد کردن این دستور به تنهایی، مقدار تنظیم‌شده فعلی را نمایش می‌دهد.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> tx\-power [on/off]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBIncludes\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [on/off]
فعال یا غیرفعال کردن اعلان توان ارسال (TX power) (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیمات فعلی اعلان توان ارسال (TX power)
.nf
\fB> tx\-power\fP
.fi
.sp
.TP
.B مثال فعال کردن اعلان توان ارسال (TX power) با توان پیش‌فرض
.nf
\fB> tx\-power on\fP
.fi
.sp
.TP
.B مثال غیرفعال کردن اعلان توان ارسال (TX power)
.nf
\fB> tx\-power off\fP
.fi
.sp
.UNINDENT
.SS name
.sp
پیکربندی نام محلی (local name) برای اعلان.
.sp
نام محلی مورد استفاده در گزارش اعلان (advertising report).
.sp
اگر رشته برای جا گرفتن در بسته بیش از حد بزرگ باشد، کوتاه خواهد شد.
.sp
یا به صورت نام محلی کامل یا در صورت لزوم به عنوان یک نام محلی کوتاه شده اعلان خواهد شد.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> name [on/off/name]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBLocalName\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [name]
نام محلی (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیمات فعلی نام اعلان‌شده
.nf
\fB> name\fP
.fi
.sp
.TP
.B مثال فعال کردن اعلان نام میزبان (hostname) سیستم
.nf
\fB> name on\fP
.fi
.sp
.TP
.B مثال غیرفعال کردن اعلان نام
.nf
\fB> name off\fP
.fi
.sp
.TP
.B مثال اعلان \(dqMy Device\(dq به عنوان نام محلی
.nf
\fB> name \(dqMy Device\(dq\fP
.fi
.sp
.TP
.B مثال اعلان \(dqSmart Sensor\(dq به عنوان نام محلی
.nf
\fB> name \(dqSmart Sensor\(dq\fP
.fi
.sp
.TP
.B مثال اعلان دستگاه با پسوند شناسه (ID)
.nf
\fB> name \(dqBLE\-Peripheral\-001\(dq\fP
.fi
.sp
.TP
.B مثال اعلان نام طولانی (برای جا شدن کوتاه خواهد شد)
.nf
\fB> name \(dq0123456789abcdef0123456789abcdef\(dq\fP
.fi
.sp
.TP
.B مثال نام توصیفی طولانی (به‌طور خودکار کوتاه می‌شود)
.nf
\fB> name \(dqThis is a very long device name that will be truncated\(dq\fP
.fi
.sp
.TP
.B مثال نام با نویسه‌های خاص
.nf
\fB> name \(dqDevice™\(dq\fP
.fi
.sp
.TP
.B مثال نام با حروف نشانه‌دار (accented)
.nf
\fB> name \(dqTëst\-Dëvicë\(dq\fP
.fi
.sp
.UNINDENT
.SS appearance
.sp
پیکربندی ظاهر / هویت دستگاه (appearance) سفارشی برای اعلان.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> appearance [on/off/value]\fP
.TP
.B استفاده‌ها (Uses)
مشخصه \fBAppearance\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [value]
مقدار ظاهر / هویت دستگاه (appearance) (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیمات فعلی ظاهر / هویت دستگاه (appearance)
.nf
\fB> appearance\fP
.fi
.sp
.TP
.B مثال فعال کردن اعلان ظاهر / هویت دستگاه با مقدار پیش‌فرض
.nf
\fB> appearance on\fP
.fi
.sp
.TP
.B مثال غیرفعال کردن اعلان ظاهر / هویت دستگاه
.nf
\fB> appearance off\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی صفحه‌کلید (0x03C1)
.nf
\fB> appearance 961\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی ماوس (0x03C2)
.nf
\fB> appearance 962\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی جوی‌استیک (0x03C3)
.nf
\fB> appearance 963\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی گیم‌پد (0x03C4)
.nf
\fB> appearance 964\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی گیرنده صوتی عمومی (0x0340)
.nf
\fB> appearance 832\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی بلندگو (0x0341)
.nf
\fB> appearance 833\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی میکروفون (0x0342)
.nf
\fB> appearance 834\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی هدست (0x0343)
.nf
\fB> appearance 835\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی هدفون (0x0344)
.nf
\fB> appearance 836\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی حسگر ضربان قلب (0x0540)
.nf
\fB> appearance 1344\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی دماسنج (0x05C0)
.nf
\fB> appearance 1472\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی قندسنج (0x0640)
.nf
\fB> appearance 1600\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی تلفن عمومی (0x0040)
.nf
\fB> appearance 64\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی رایانه عمومی (0x0080)
.nf
\fB> appearance 128\fP
.fi
.sp
.TP
.B مثال تنظیم ظاهر / هویت دستگاه روی ساعت مچی عمومی (0x00C0)
.nf
\fB> appearance 192\fP
.fi
.sp
.UNINDENT
.SS duration
.sp
تنظیم/دریافت مدت زمان تبلیغ.
.sp
پارامتر Duration طول یک نمونه (Instance) را پیکربندی می‌کند.
.sp
مقدار به ثانیه است.
.sp
مقدار ۰ نشان می‌دهد که مقدار پیش‌فرض برای Duration انتخاب شده است.
.sp
مقدار پیش‌فرض ۲ ثانیه است.
.sp
اگر تنها یک نمونه تبلیغ اضافه شده باشد، مقدار Duration نادیده گرفته خواهد شد.
.sp
اگر چندین نمونه تبلیغ اضافه شده باشد، مقدار Duration برای تعیین مدت زمانی که هر نمونه تبلیغ می‌شود استفاده خواهد شد.
.sp
مقدار Duration برای محاسبه تعداد رویدادهای تبلیغاتی که برای تبلیغ هر نمونه استفاده خواهد شد، به کار می‌رود.
.sp
تعداد رویدادهای تبلیغاتی با تقسیم مقدار Duration بر بازه زمانی تبلیغ محاسبه می‌شود.
.sp
بازه زمانی تبلیغ توسط پارامترهای تبلیغاتی که برای هر نمونه تنظیم شده‌اند تعیین می‌شود. بازه زمانی تبلیغ برابر با حداکثر بازه‌های زمانی تبلیغ تنظیم‌شده برای هر نمونه است.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> duration [seconds]\fP
.TP
.B استفاده‌ها (Uses)
ویژگی \fBDuration\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [seconds]
مدت زمان به ثانیه (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیم فعلی مدت زمان تبلیغ
.nf
\fB> duration\fP
.fi
.sp
.TP
.B مثال استفاده از مدت زمان پیش‌فرض (۲ ثانیه)
.nf
\fB> duration 0\fP
.fi
.sp
.TP
.B مثال تنظیم مدت زمان روی ۱ ثانیه
.nf
\fB> duration 1\fP
.fi
.sp
.TP
.B مثال تنظیم مدت زمان روی ۵ ثانیه
.nf
\fB> duration 5\fP
.fi
.sp
.TP
.B مثال تنظیم مدت زمان روی ۱۰ ثانیه
.nf
\fB> duration 10\fP
.fi
.sp
.TP
.B مثال تنظیم مدت زمان روی ۳۰ ثانیه
.nf
\fB> duration 30\fP
.fi
.sp
.TP
.B مثال تنظیم مدت زمان روی ۱ دقیقه
.nf
\fB> duration 60\fP
.fi
.sp
.TP
.B مثال تنظیم مدت زمان روی ۵ دقیقه
.nf
\fB> duration 300\fP
.fi
.sp
.UNINDENT
.SS timeout
.sp
تنظیم/دریافت مهلت زمانی تبلیغ.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> timeout [seconds]\fP
.TP
.B استفاده‌ها (Uses)
ویژگی \fBTimeout\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [seconds]
مهلت زمانی به ثانیه (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیم فعلی مهلت زمانی تبلیغ
.nf
\fB> timeout\fP
.fi
.sp
.TP
.B مثال تبلیغ نامحدود (بدون مهلت زمانی)
.nf
\fB> timeout 0\fP
.fi
.sp
.TP
.B مثال توقف تبلیغ پس از ۳۰ ثانیه
.nf
\fB> timeout 30\fP
.fi
.sp
.TP
.B مثال توقف تبلیغ پس از ۲ دقیقه
.nf
\fB> timeout 120\fP
.fi
.sp
.TP
.B مثال توقف تبلیغ پس از ۱ ساعت
.nf
\fB> timeout 3600\fP
.fi
.sp
.UNINDENT
.SS secondary
.sp
تنظیم/دریافت کانال ثانویه تبلیغ.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> secondary [1M/2M/Coded]\fP
.TP
.B استفاده‌ها (Uses)
ویژگی \fBSecondaryChannel\fP در \fBorg.bluez.LEAdvertisement(5)\fP
.TP
.B [1M/2M/Coded]
کانال ثانویه (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیم فعلی کانال ثانویه
.nf
\fB> secondary\fP
.fi
.sp
.TP
.B مثال استفاده از LE 1M PHY برای کانال ثانویه تبلیغ
.nf
\fB> secondary 1M\fP
.fi
.sp
.TP
.B مثال استفاده از LE 2M PHY برای کانال ثانویه تبلیغ
.nf
\fB> secondary 2M\fP
.fi
.sp
.TP
.B مثال استفاده از LE Coded PHY برای کانال ثانویه تبلیغ
.nf
\fB> secondary Coded\fP
.fi
.sp
.UNINDENT
.SS rsi
.sp
نمایش/فعال‌سازی/غیرفعال‌سازی تبلیغ RSI.
.sp
از RSI (شناسه مجموعه‌ی تفکیک‌پذیر یا Resolvable Set Identifier) برای تبلیغ یک شناسه تفکیک‌پذیر جهت شناسایی مجموعه هماهنگ (Coordinated Set Identification) استفاده می‌شود.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> rsi [on/off]\fP
.TP
.B [on/off]
فعال یا غیرفعال کردن تبلیغ RSI (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B مثال نمایش تنظیم فعلی RSI
.nf
\fB> rsi\fP
.fi
.sp
.TP
.B مثال فعال‌سازی تبلیغ RSI
.nf
\fB> rsi on\fP
.fi
.sp
.TP
.B مثال غیرفعال‌سازی تبلیغ RSI
.nf
\fB> rsi off\fP
.fi
.sp
.UNINDENT
.SS interval
.sp
تنظیم/دریافت بازه زمانی تبلیغ.
.sp
پارامتر Interval بازه زمانی تبلیغ یک نمونه (Instance) را پیکربندی می‌کند.
.sp
مقدار به میلی‌ثانیه است.
.sp
مقدار ۰ نشان می‌دهد که مقدار پیش‌فرض برای Interval انتخاب شده است.
.sp
مقدار پیش‌فرض ۱۰۰ میلی‌ثانیه است.
.sp
مقدار Interval برای محاسبه تعداد رویدادهای تبلیغاتی که برای تبلیغ هر نمونه استفاده خواهد شد، به کار می‌رود.
.sp
تعداد رویدادهای تبلیغاتی با تقسیم مقدار Duration بر بازه زمانی تبلیغ محاسبه می‌شود.
.sp
بازه زمانی تبلیغ توسط پارامترهای تبلیغاتی که برای هر نمونه تنظیم شده‌اند تعیین می‌شود.
.sp
بازه زمانی تبلیغ برابر با حداکثر بازه‌های زمانی تبلیغ تنظیم‌شده برای هر نمونه است.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> interval [min] [max]\fP
.TP
.B [min]
حداقل بازه زمانی تبلیغ به میلی‌ثانیه (اختیاری، در صورت حذف مقدار فعلی را نشان می‌دهد)
.TP
.B [max]
حداکثر بازه زمانی تبلیغ به میلی‌ثانیه (اختیاری، مقدار پیش‌فرض برابر با مقدار min است)
.TP
.B مثال نمایش تنظیم فعلی بازه زمانی تبلیغ
.nf
\fB> interval\fP
.fi
.sp
.TP
.B مثال تنظیم حداقل بازه زمانی تبلیغ (۲۰ میلی‌ثانیه)
.nf
\fB> interval 20\fP
.fi
.sp
.TP
.B مثال تنظیم محدوده بازه زمانی تبلیغ (۵۰ تا ۱۰۰ میلی‌ثانیه)
.nf
\fB> interval 50 100\fP
.fi
.sp
.TP
.B مثال تنظیم بازه زمانی تبلیغ عادی (۱۰۰ میلی‌ثانیه)
.nf
\fB> interval 100\fP
.fi
.sp
.TP
.B مثال تنظیم بازه زمانی تبلیغ متوسط (۲۰۰ میلی‌ثانیه)
.nf
\fB> interval 200\fP
.fi
.sp
.TP
.B مثال تنظیم بازه زمانی تبلیغ آهسته (۵۰۰ میلی‌ثانیه)
.nf
\fB> interval 500\fP
.fi
.sp
.TP
.B مثال تنظیم بازه زمانی تبلیغ بسیار آهسته (۱ ثانیه)
.nf
\fB> interval 1000\fP
.fi
.sp
.TP
.B مثال تنظیم حداکثر بازه زمانی تبلیغ (۱۰٫۲۴ ثانیه)
.nf
\fB> interval 10240\fP
.fi
.sp
.UNINDENT
.SS clear
.sp
پاک کردن پیکربندی تبلیغ.
.sp
در صورتی که تبلیغ در حال حاضر فعال باشد، این کار باعث توقف آن می‌شود.
.sp
اگر می‌خواهید در حین تبلیغ، پیکربندی تبلیغ را تغییر دهید ابتدا باید پیکربندی تبلیغ را پاک کرده و سپس پیکربندی جدید تبلیغ را تنظیم کنید.
.INDENT 0.0
.TP
.B کاربرد (Usage)
\fB> clear [uuids/service/manufacturer/config\-name...]\fP
.TP
.B [uuids/service/manufacturer/config\-name...]
فهرست پیکربندی‌ها برای پاک کردن
.TP
.B مثال پاک کردن تمام پیکربندی تبلیغ
.nf
\fB> clear\fP
.fi
.sp
.TP
.B مثال پاک کردن فقط UUIDهای تبلیغ‌شده
.nf
\fB> clear uuids\fP
.fi
.sp
.TP
.B مثال پاک کردن فقط داده‌های سرویس
.nf
\fB> clear service\fP
.fi
.sp
.TP
.B مثال پاک کردن فقط داده‌های سازنده
.nf
\fB> clear manufacturer\fP
.fi
.sp
.TP
.B مثال پاک کردن فقط نام تبلیغ‌شده
.nf
\fB> clear name\fP
.fi
.sp
.TP
.B مثال پاک کردن فقط داده‌های ظاهر (appearance)
.nf
\fB> clear appearance\fP
.fi
.sp
.TP
.B مثال پاک کردن فقط تبلیغ توان TX
.nf
\fB> clear tx\-power\fP
.fi
.sp
.TP
.B مثال پاک کردن UUIDها و داده‌های سرویس
.nf
\fB> clear uuids service\fP
.fi
.sp
.TP
.B مثال پاک کردن داده‌های سازنده و نام
.nf
\fB> clear manufacturer name\fP
.fi
.sp
.TP
.B مثال پاک کردن UUIDها، داده‌های سرویس و داده‌های سازنده
.nf
\fB> clear uuids service manufacturer\fP
.fi
.sp
.TP
.B مثال پاک کردن حالت کشف‌پذیر و توان TX
.nf
\fB> clear discoverable tx\-power\fP
.fi
.sp
.UNINDENT
.SH "منابع (RESOURCES)"
.sp
\%<http://www.bluez.org>
.SH "گزارش اشکالات (REPORTING BUGS)"
.sp
\%<linux-bluetooth@vger.kernel.org>
.SH "حق نشر (COPYRIGHT)"
استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی کمتر گنو (LGPL) اعطا شده است.
.\" End of generated man page.