نام (NAME)

hciconfig - پیکربندی دستگاههای بلوتوث HCI

خلاصه دستور (SYNOPSIS)

hciconfig -h

hciconfig [-a]

hciconfig [-a] hciX [COMMAND [PARAMETERS]]

توضیحات (DESCRIPTION)

دستور hciconfig(1) برای پیکربندی دستگاه‌های بلوتوث به کار می‌رود. hciX نام یک دستگاه بلوتوث نصب‌شده در سیستم است. اگر hciX مشخص نشود، hciconfig نام و اطلاعات پایه تمام دستگاه‌های بلوتوث نصب‌شده در سیستم را چاپ می‌کند.

اگر hciX مشخص شود اما هیچ دستوری داده نشود، اطلاعات پایه را تنها برای دستگاه hciX چاپ می‌کند. اطلاعات پایه شامل نوع رابط، آدرس BD، مقدار ACL MTU، مقدار SCO MTU، و پرچم‌ها (شامل up، init، running، raw، page scan enabled، inquiry scan enabled، inquiry، authentication enabled، encryption enabled) است.

گزینه‌ها (OPTIONS)

-a, --all: چاپ ویژگی‌ها، نوع بسته، سیاست پیوند، حالت پیوند، کلاس و نسخه علاوه بر اطلاعات پایه.
-h, --help: نمایش گزینه‌های راهنما.

دستورها (COMMANDS)

up: باز کردن و مقداردهی اولیه دستگاه HCI.
down: بستن دستگاه HCI.
reset: راه‌اندازی مجدد دستگاه HCI.
rstat: بازنشانی شمارنده‌های آماری.
auth: فعال‌سازی احراز هویت (دستگاه را در حالت امنیتی ۳ قرار می‌دهد).
noauth: غیرفعال‌سازی احراز هویت.
encrypt: فعال‌سازی رمزنگاری (دستگاه را در حالت امنیتی ۳ قرار می‌دهد).
noencrypt: غیرفعال‌سازی رمزنگاری.
secmgr: فعال‌سازی مدیر امنیت (پشتیبانی هسته در حال حاضر محدود است).
nosecmgr: غیرفعال‌سازی مدیر امنیت.
piscan: فعال‌سازی پایش صفحه و پایش پرس‌وجو (Page and Inquiry Scan).
noscan: غیرفعال‌سازی پایش صفحه و پایش پرس‌وجو.
iscan: فعال‌سازی پایش پرس‌وجو و غیرفعال‌سازی پایش صفحه.
pscan: فعال‌سازی پایش صفحه و غیرفعال‌سازی پایش پرس‌وجو.
ptype [type]: در صورت عدم تعیین type، انواع بسته‌های فعلی نمایش داده می‌شوند. در غیر این صورت، تمام انواع بسته‌های مشخص‌شده توسط type تنظیم می‌شوند. type فهرستی از انواع بسته‌ها است که با کاما از هم جدا شده‌اند، و انواع بسته‌های ممکن عبارتند از: DM1، DM3، DM5، DH1، DH3، DH5، HV1، HV2، HV3.
name [name]: در صورت عدم تعیین name، نام محلی را چاپ می‌کند. در غیر این صورت، نام محلی را به name تنظیم می‌کند.
class [class]: در صورت عدم تعیین class، کلاس دستگاه را چاپ می‌کند. در غیر این صورت، کلاس دستگاه را به class تنظیم می‌کند. class یک عدد هگزادسیمال ۲۴ بیتی است که کلاس دستگاه را مشخص می‌کند، همان‌گونه که در بخش 1.2 سند Bluetooth Assigned Numbers شرح داده شده است.
voice [voice]: در صورت عدم تعیین voice، تنظیمات صدا را چاپ می‌کند. در غیر این صورت، تنظیمات صدا را به voice تنظیم می‌کند. voice یک عدد هگزادسیمال ۱۶ بیتی است که تنظیمات صدا را شرح می‌دهد.
iac [iac]: در صورت عدم تعیین iac، تنظیمات فعلی IAC را چاپ می‌کند. در غیر این صورت، IAC را به iac تنظیم می‌کند.
inqtpl [level]: در صورت عدم تعیین level، سطح توان ارسال پرس‌وجوی فعلی را چاپ می‌کند. در غیر این صورت، سطح توان ارسال پرس‌وجو را به level تنظیم می‌کند.
inqmode [mode]

در صورت عدم تعیین mode، حالت پرس‌وجوی فعلی را چاپ می‌کند. در غیر این صورت، حالت پرس‌وجو را به mode تنظیم می‌کند.

mode	توضیحات
0	پرس‌وجوی استاندارد (Standard Inquiry)
1	پرس‌وجو همراه با RSSI
2	پرس‌وجو با RSSI یا پرس‌وجوی گسترش‌یافته (Extended Inquiry)

inqdata [data]: در صورت عدم تعیین data، داده‌های پرس‌وجوی فعلی را چاپ می‌کند. در غیر این صورت، داده‌های پرس‌وجو را به data تنظیم می‌کند.
inqtype [type]: در صورت عدم تعیین type، نوع پایش پرس‌وجوی فعلی را چاپ می‌کند. در غیر این صورت، نوع پایش پرس‌وجو را به type تنظیم می‌کند.
inqparams [win:int]: در صورت عدم تعیین win:int، پنجره و بازه زمانی پایش پرس‌وجو را چاپ می‌کند. در غیر این صورت، پنجره پایش پرس‌وجو را به win اسلات و بازه زمانی پایش پرس‌وجو را به int اسلات تنظیم می‌کند.
pageparms [win:int]: در صورت عدم تعیین win:int، پنجره و بازه زمانی پایش صفحه را چاپ می‌کند. در غیر این صورت، پنجره پایش صفحه را به win اسلات و بازه زمانی پایش صفحه را به int اسلات تنظیم می‌کند.
pageto [to]: در صورت عدم تعیین to، مهلت زمانی صفحه را چاپ می‌کند. در غیر این صورت، مهلت زمانی صفحه را به to اسلات تنظیم می‌کند.
afhmode [mode]: در صورت عدم تعیین mode، حالت AFH فعلی را چاپ می‌کند. در غیر این صورت، حالت AFH را به mode تنظیم می‌کند.

mode	توضیحات
0	فعال‌سازی
1	غیرفعال‌سازی

sspmode [mode]: در صورت عدم تعیین mode، حالت جفت‌سازی ساده (Simple Pairing) فعلی را چاپ می‌کند. در غیر این صورت، حالت جفت‌سازی ساده را به mode تنظیم می‌کند.

mode	توضیحات
0	فعال‌سازی
1	غیرفعال‌سازی

aclmtu mtu:pkt: مقدار ACL MTU را به mtu بایت و اندازه بافر ACL را به pkt بسته تنظیم می‌کند.
scomtu mtu:pkt: مقدار SCO MTU را به mtu بایت و اندازه بافر SCO را به pkt بسته تنظیم می‌کند.
delkey <bdaddr>: این دستور کلید پیوند ذخیره‌شده برای bdaddr را از دستگاه حذف می‌کند.
oobdata: دریافت داده‌های OOB محلی (داده‌های خوانده‌شده قبلی را نامعتبر می‌کند).
commands: نمایش دستورهای پشتیبانی‌شده.
features: نمایش ویژگی‌های دستگاه.
version: نمایش اطلاعات نسخه.
revision: نمایش اطلاعات بازبینی.
lm [mode]: در صورت عدم تعیین mode، حالت پیوند را چاپ می‌کند. CENTRAL یا PERIPHERAL به ترتیب به معنای درخواست برای ایفای نقش مرکزی یا ماندن در حالت جانبی در زمان دریافت درخواست اتصال است. کلیدواژه اضافی ACCEPT به این معناست که اتصالات baseband پذیرفته خواهند شد حتی اگر هیچ سوکت شنوندگی AF_BLUETOOTH وجود نداشته باشد. mode می‌تواند NONE یا فهرستی از کلیدواژه‌ها باشد که با کاما از هم جدا شده‌اند، که کلیدواژه‌های ممکن CENTRAL و ACCEPT هستند. NONE سیاست پیوند را روی رفتار پیش‌فرض قرار می‌دهد که عبارت است از جانبی ماندن و نپذیرفتن اتصالات baseband در صورتی که هیچ سوکت شنوندگی AF_BLUETOOTH وجود نداشته باشد. اگر CENTRAL مشخص شود، دستگاه در صورت دریافت درخواست اتصال، تقاضای مرکزی شدن می‌کند. اگر ACCEPT مشخص شود، دستگاه اتصالات baseband را حتی در صورت عدم وجود سوکت شنوندگی AF_BLUETOOTH خواهد پذیرفت.
block <bdaddr>: افزودن یک دستگاه به فهرست رد (Reject list).
unblock <bdaddr>: حذف یک دستگاه از فهرست رد (Reject list).
lerandaddr <bdaddr>: تنظیم آدرس تصادفی LE (مخفف LE Random Address).
leadv [type]: فعال‌سازی اعلان LE (مخفف LE Advertising).

type	توضیحات
0	اعلان بدون‌جهت دارای قابلیت اتصال (پیش‌فرض)
3	اعلان بدون‌جهت بدون قابلیت اتصال

noleadv: غیرفعال‌سازی اعلان LE.
lestates: نمایش حالت‌های پشتیبانی‌شده LE.

منابع (RESOURCES)

http://www.bluez.org

گزارش باگ‌ها (REPORTING BUGS)

<linux-bluetooth@vger.kernel.org>

نویسندگان (AUTHORS)

Maxim Krasnyansky <maxk@qualcomm.com>, Marcel Holtmann <marcel@holtmann.org>, Fabrizio Gennari <fabrizio.gennari@philips.com>

حق نشر (COPYRIGHT)

استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی کمتر گنو (LGPL) مجاز است.