| hcitool(1) | Linux System Administration | hcitool(1) |
نام (NAME)
hcitool - پیکربندی اتصالات HCI و ارسال دستورات به دستگاههای بلوتوث
خلاصه دستور (SYNOPSIS)
hcitool -h
hcitool COMMAND --help
hcitool [-i hciX] [COMMAND [PARAMETERS]]
توضیحات (DESCRIPTION)
دستور hcitool(1) برای پیکربندی اتصالات بلوتوث و ارسال دستورات ویژه به دستگاههای بلوتوث استفاده میشود. اگر هیچ دستوری داده نشود، یا اگر گزینه -h استفاده شود، hcitool اطلاعات نحوه استفاده را چاپ کرده و خارج میشود.
گزینهها (OPTIONS)
دستورات (COMMANDS)
- dev
- نمایش دستگاههای محلی.
- inq
- استعلام دستگاههای دوردست. برای هر دستگاه کشفشده، آدرس دستگاه بلوتوث، آفست ساعت و کلاس دستگاه چاپ میشود.
- scan
- استعلام دستگاههای دوردست. برای هر دستگاه کشفشده، نام دستگاه چاپ میشود.
- name <bdaddr>
- چاپ نام دستگاه دوردست با آدرس بلوتوث bdaddr.
- info <bdaddr>
- چاپ نام دستگاه، نسخه و ویژگیهای پشتیبانیشده دستگاه دوردست با آدرس بلوتوث bdaddr.
- spinq
- شروع فرآیند استعلام دورهای. هیچ نتیجه استعلامی چاپ نمیشود.
- epinq
- خروج از فرآیند استعلام دورهای.
- cmd <ogf> <ocf> [parameters]
- ارسال یک دستور اختیاری HCI به دستگاه محلی. آرگومانهای ogf، ocf و parameters بایتهای هگزادسیمال هستند.
- con
- نمایش اتصالات فعال باند پایه (baseband).
- cc [--role=c|p] [--pkt-type=<ptype>] <bdaddr>
- ایجاد
اتصال باند
پایه به
دستگاه
دوردست با
آدرس
بلوتوث bdaddr.
گزینه --pkt-type فهرستی از انواع بستههای مجاز را مشخص میکند. <ptype> فهرستی جداشده با کاما از انواع بستهها است، که انواع بستههای ممکن عبارتند از: DM1، DM3، DM5، DH1، DH3، DH5، HV1، HV2، HV3. حالت پیشفرض، مجاز دانستن تمام انواع بستهها است.
گزینه --role میتواند مقدار c (عدم اجازه تغییر نقش، ماندن در حالت مرکزی) یا p (اجازه تغییر نقش، تبدیل به حالت جانبی اگر دستگاه مقابل درخواست مرکزی شدن کند) داشته باشد. مقدار پیشفرض c است.
- dc <bdaddr> [reason]
- حذف اتصال
باند پایه
از دستگاه
دوردست با
آدرس
بلوتوث bdaddr.
علت (reason) میتواند یکی از کدهای خطای HCI بلوتوث باشد. مقدار پیشفرض برای اتصالاتی که توسط کاربر خاتمه یافتهاند 19 است. مقدار باید به صورت دهدهی (decimal) داده شود.
- sr <bdaddr> <role>
- تغییر نقش برای اتصال باند پایه از دستگاه دوردست به central یا peripheral.
- cpt <bdaddr> <ptypes>
- تغییر انواع بستهها برای اتصال باند پایه به دستگاه با آدرس بلوتوث bdaddr. مقدار ptypes فهرستی جداشده با کاما از انواع بستهها است، که انواع بستههای ممکن عبارتند از: DM1، DM3، DM5، DH1، DH3، DH5، HV1، HV2، HV3.
- rssi <bdaddr>
- نمایش اطلاعات قدرت سیگنال دریافتی برای اتصال به دستگاه با آدرس بلوتوث bdaddr.
- lq <bdaddr>
- نمایش کیفیت پیوند برای اتصال به دستگاه با آدرس بلوتوث bdaddr.
- tpl <bdaddr> [type]
- نمایش سطح
توان ارسال
برای اتصال
به دستگاه
با آدرس
بلوتوث bdaddr.
پارامتر type میتواند 0 برای سطح توان ارسال فعلی (که پیشفرض است) یا 1 برای حداکثر سطح توان ارسال باشد.
- afh <bdaddr>
- نمایش نقشه کانال AFH برای اتصال به دستگاه با آدرس بلوتوث bdaddr.
- lp <bdaddr> [value]
- بدون
مقدار،
تنظیمات
خطمشی
پیوند را
برای اتصال
به دستگاه
با آدرس
بلوتوث bdaddr
نمایش
میدهد.
اگر value داده شود، تنظیمات خطمشی پیوند را برای آن اتصال به value تنظیم میکند. مقادیر ممکن عبارتند از: RSWITCH، HOLD، SNIFF و PARK.
- lst <bdaddr> [value]
- بدون
مقدار،
مهلت زمانی
نظارت بر
پیوند را
برای اتصال
به دستگاه
با آدرس
بلوتوث bdaddr
نمایش
میدهد.
اگر value داده شود، مهلت زمانی نظارت بر پیوند را برای آن اتصال به اسلاتهای value، یا در صورت 0 بودن مقدار به نامحدود تنظیم میکند.
- auth <bdaddr>
- درخواست احراز هویت برای دستگاه با آدرس بلوتوث bdaddr.
- enc <bdaddr> [encrypt]
- فعالسازی (enable) یا غیرفعالسازی (disable) رمزنگاری برای دستگاه با آدرس بلوتوث bdaddr.
- key <bdaddr>
- تغییر کلید پیوند اتصال برای دستگاه با آدرس بلوتوث bdaddr.
- clkoff <bdaddr>
- خواندن آفست ساعت برای دستگاه با آدرس بلوتوث bdaddr.
- clock [bdaddr] [clock]
- خواندن
ساعت برای
دستگاه با
آدرس
بلوتوث bdaddr.
مقدار clock میتواند 0 برای ساعت محلی یا 1 برای ساعت پیکونت (که پیشفرض است) باشد.
- lescan [--privacy] [--passive] [--acceptlist] [--discovery=g|l] [--duplicates]
- شروع اسکن LE.
- leinfo [--static] [--random] <bdaddr>
- دریافت اطلاعات دوردست LE.
- lealadd [--random] <bdaddr>
- افزودن دستگاه به لیست پذیرش LE (LE Accept List).
- lealrm <bdaddr>
- حذف دستگاه از لیست پذیرش LE.
- lealsz
- خواندن اندازه لیست پذیرش LE.
- lealclr
- پاکسازی لیست پذیرش LE.
- lerladd [--local_irk] [--peer_irk] [--random] <bdaddr>
- افزودن دستگاه به لیست تفکیک LE (LE Resolving List).
- lerlrm <bdaddr>
- حذف دستگاه از لیست تفکیک LE.
- lerlclr
- پاکسازی لیست تفکیک LE.
- lerlsz
- خواندن اندازه لیست تفکیک LE.
- lerlon
- فعالسازی تفکیک آدرس LE.
- lerloff
- غیرفعالسازی تفکیک آدرس LE.
- lecc [--static] [--random] <bdaddr> | [--acceptlist]
- ایجاد یک اتصال LE.
- ledc <handle> [reason]
- قطع یک اتصال LE.
- lecup <handle> <min> <max> <latency> <timeout>
- بهروزرسانی اتصال LE (LE Connection Update).
منابع (RESOURCES)
گزارش خطاها (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) مجاز است.
| November 12, 2002 | BlueZ |