bluetoothctl-endpoint(1) Linux System Administration bluetoothctl-endpoint(1)

bluetoothctl-endpoint - زیردستور مدیریت نقاط پایانی مدیا در bluetoothctl

bluetoothctl [--options] [endpoint.commands]

این زیرمنو نقاط پایانی رسانه را برای جریان‌سازی صوتی با استفاده از واسط‌های org.bluez.MediaEndpoint(5) و org.bluez.Media(5) مدیریت می‌کند.

فهرست کردن نقاط پایانی موجود.

کاربرد (Usage)
> list [local]
[local]
فقط نقاط پایانی ثبت‌شده به صورت محلی را نشان می‌دهد (اختیاری، در صورت حذف همه را نشان می‌دهد)
مثال فهرست کردن تمام نقاط پایانی موجود (محلی و راه دور)
> list
مثال فقط فهرست کردن نقاط پایانی ثبت‌شده به صورت محلی
> list local

اطلاعات نقطه پایانی.

کاربرد (Usage)
> show [endpoint]
استفاده‌ها (Uses)
ویژگی‌های org.bluez.MediaEndpoint(5)
[endpoint]
مسیر نقطه پایانی خاص برای نمایش (اختیاری، در صورت حذف انتخاب فعلی را نشان می‌دهد)
مثال نمایش اطلاعات نقطه پایانی انتخاب‌شده فعلی
> show
مثال نمایش اطلاعات نقطه پایانی محلی
> show /local/endpoint/ep0
مثال نمایش اطلاعات نقطه پایانی راه دور
> show /org/bluez/hci0/dev_00_11_22_33_44_55/ep1
مثال نمایش یک نقطه پایانی محلی دیگر
> show /local/endpoint/ep1

ثبت نقطه پایانی.

کاربرد (Usage)
> register <UUID> <codec[:company]> [capabilities...]
استفاده‌ها (Uses)
متد RegisterEndpoint در org.bluez.Media(5)
<UUID>
شناسه یکتای جهان‌شمول (UUID) سرویس بلوتوث برای نوع نقطه پایانی (الزامی)
<codec[:company]>
شناسه کدک در قالب هگزادسیمال، به همراه شناسه اختیاری شرکت (الزامی)
[capabilities...]
داده‌های قابلیت‌های ویژه کدک به صورت اختیاری در قالب هگزادسیمال
مثال مبدا LC3 BAP
>endpoint.register 00002bcb-0000-1000-8000-00805f9b34fb 0x06
>Auto Accept (yes/no): y
>Max Transports (auto/value): a
>Locations: a
>Supported Context (value): 3
>Context (value): 3
>CIG (auto/value): a
>CIS (auto/value): a
مثال مقصد LC3 BAP همراه با قابلیت‌های اضافی
>endpoint.register 00002bc9-0000-1000-8000-00805f9b34fb 0x06 "0x03 0xe5 0x03 0x00 0x02 0xe6 0x07"
>Enter Metadata (value/no): n
>Auto Accept (yes/no): y
>Max Transports (auto/value): a
>Locations: a
>Supported Context (value): 3
>Context (value): 3
>CIG (auto/value): a
>CIS (auto/value): a
مثال مبدا پخش همگانی LC3 BAP (Broadcast source)
>endpoint.register 00001852-0000-1000-8000-00805f9b34fb 0x06
>Auto Accept (yes/no): y
>Max Transports (auto/value): a
>Locations: 3
>Supported Context (value): 1
مثال مقصد پخش همگانی LC3 BAP (Broadcast sink)
>endpoint.register 00001851-0000-1000-8000-00805f9b34fb 0x06
>Auto Accept (yes/no): y
>Max Transports (auto/value): a
>Locations: 3
>Supported Context (value): 1

نکته:

در صورت اجرای این پیکربندی همراه با یک کارساز صوتی دارای پشتیبانی از LE Audio (مانند PipeWire)، این کارساز به صورت خودکار نقاط پایانی را مطابق با نقش‌های پیکربندی‌شده ثبت می‌کند. برای جزئیات بیشتر درباره پیکربندی مبدا پخش همگانی (Broadcast Source) با PipeWire نشانی زیر را بررسی کنید: https://gitlab.freedesktop.org/pipewire/pipewire/-/blob/master/doc/dox/config/pipewire-props.7.md

لغو ثبت نقطه پایانی.

کاربرد (Usage)
> unregister <UUID/object>
استفاده‌ها (Uses)
متد UnregisterEndpoint در org.bluez.Media(5)
<UUID/object>
شناسه UUID سرویس یا مسیر شیء مربوط به نقطه پایانی برای لغو ثبت
مثال لغو ثبت نقطه پایانی مبدا LC3 بر اساس UUID
> unregister 00002bcb-0000-1000-8000-00805f9b34fb
مثال لغو ثبت نقطه پایانی مقصد LC3 بر اساس UUID
> unregister 00002bc9-0000-1000-8000-00805f9b34fb
مثال لغو ثبت نقطه پایانی مبدا پخش همگانی بر اساس UUID
> unregister 00001852-0000-1000-8000-00805f9b34fb
مثال لغو ثبت نقطه پایانی مقصد پخش همگانی بر اساس UUID
> unregister 00001851-0000-1000-8000-00805f9b34fb
مثال لغو ثبت نقطه پایانی بر اساس مسیر شیء
> unregister /local/endpoint/ep0
مثال لغو ثبت یک نقطه پایانی دیگر بر اساس مسیر شیء
> unregister /local/endpoint/ep1
مثال لغو ثبت نقطه پایانی مبدا بر اساس مسیر
> unregister /local/endpoint/source0
مثال لغو ثبت نقطه پایانی مقصد بر اساس مسیر
> unregister /local/endpoint/sink0

نکته:

اگر نقطه پایانی توسط یک کارساز صوتی ثبت شده باشد، امکان لغو ثبت آن از طریق bluetoothctl وجود ندارد. این کار باید توسط همان کارساز صوتی انجام شود.

پیکربندی نقطه پایانی.

کاربرد (Usage)
> config <endpoint> <local endpoint> [preset]
استفاده‌ها (Uses)
متد SetConfiguration در org.bluez.MediaEndpoint(5)
<endpoint>
مسیر نقطه پایانی راه دور برای پیکربندی
<local endpoint>
مسیر نقطه پایانی محلی برای استفاده در پیکربندی
[preset]
نام پیش‌تنظیم کیفیت صدا (اختیاری، در صورت حذف به صورت خودکار تشخیص داده می‌شود)
مثال پیکربندی نقطه پایانی راه دور با نقطه پایانی محلی (پیش‌تنظیم خودکار)
> config /org/bluez/hci0/dev_00_11_22_33_44_55/ep0 /local/endpoint/ep0
مثال پیکربندی تک‌پخشی صوتی کم‌مصرف (LE Audio Unicast) با تنظیم BAP برابر 32_1_1
> config /org/bluez/hci0/dev_00_11_22_33_44_55/ep0 /local/endpoint/ep0 32_1_1
مثال پیکربندی مبدا پخش همگانی صوتی کم‌مصرف (LE Audio Broadcast Source)
> config /org/bluez/hci0/dev_00_11_22_33_44_55/bis0 /local/endpoint/broadcast0

نکته:

اگر نقطه پایانی توسط یک کارساز صوتی ثبت شده باشد، امکان پیکربندی آن از طریق bluetoothctl وجود ندارد. این کار نیز باید توسط همان کارساز صوتی انجام شود.

فهرست کردن پیش‌تنظیم‌های موجود.

کاربرد (Usage)
> presets <endpoint>/<UUID> [codec[:company]] [preset] [codec config] [metadata]
<endpoint>/<UUID>
مسیر نقطه پایانی یا شناسه UUID سرویس برای کار با پیش‌تنظیم‌ها
[codec[:company]]
شناسه کدک به همراه شناسه اختیاری شرکت
[preset]
نام پیش‌تنظیم برای نمایش جزئیات یا ایجاد پیش‌تنظیم سفارشی
[codec config]
داده‌های پیکربندی سفارشی کدک در قالب هگزادسیمال
[metadata]
متاداده‌های اضافی برای پیش‌تنظیم
مثال با استفاده از نقطه پایانی
>presets /local/endpoint/ep0 32_1_1
>presets /local/endpoint/ep0
Preset 32_1_1
Configuration.**>0: len 0x02 type 0x01
Configuration.Sampling Frequency: 32 Khz (0x06)
Configuration.**>1: len 0x02 type 0x02
Configuration.Frame Duration: 7.5 ms (0x00)
Configuration.**>2: len 0x03 type 0x04
Configuration.Frame Length: 60 (0x003c)
مثال فهرست کردن تمام پیش‌تنظیم‌های موجود برای نقطه پایانی محلی
>presets /local/endpoint/ep0
مثال فهرست کردن تمام پیش‌تنظیم‌ها برای یک نقطه پایانی دیگر
>presets /local/endpoint/ep1
مثال با استفاده از UUID
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06 32_1_1
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06
...
*32_1_1
مثال فهرست کردن تمام پیش‌تنظیم‌های مقصد LC3
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06
مثال فهرست کردن تمام پیش‌تنظیم‌های مبدا LC3
>presets 00002bcb-0000-1000-8000-00805f9b34fb 0x06
مثال فهرست کردن تمام پیش‌تنظیم‌های مبدا پخش همگانی
>presets 00001852-0000-1000-8000-00805f9b34fb 0x06
مثال فهرست کردن تمام پیش‌تنظیم‌های مقصد پخش همگانی
>presets 00001851-0000-1000-8000-00805f9b34fb 0x06
مثال نمایش جزئیات پیش‌تنظیم استریو ۴۸ کیلوهرتز (48kHz stereo)
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06 48_2_1
مثال نمایش جزئیات پیش‌تنظیم مونو با کیفیت بالا ۲۴ کیلوهرتز (24kHz mono high-quality)
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06 24_1_2
مثال نمایش جزئیات پیش‌تنظیم مونو ۱۶ کیلوهرتز (16kHz mono)
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06 16_1_1
مثال راه‌اندازی پیش‌تنظیم سفارشی LC3
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06 custom
>[Codec] Enter frequency (Khz): 48
>[Codec] Enter frame duration (ms): 10
>[Codec] Enter channel allocation: 3
>[Codec] Enter frame length: 100
>[QoS] Enter Target Latency (Low, Balance, High): Low
>[QoS] Enter SDU Interval (us): 1000
>[QoS] Enter Framing (Unframed, Framed): Unframed
>[QoS] Enter PHY (1M, 2M): 2M
>[QoS] Enter Max SDU: 200
>[QoS] Enter RTN: 3
>[QoS] Enter Max Transport Latency (ms): 10
>[QoS] Enter Presentation Delay (us): 20000
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06
...
*custom
مثال راه‌اندازی پیش‌تنظیم سفارشی LC3 با پیکربندی اضافی
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06 custom "0x03 0xe8 0x00 0x00 0x02 0xe9 0x00"
>[Codec] Enter frequency (Khz): 48
>[Codec] Enter frame duration (ms): 10
>[Codec] Enter channel allocation: 3
>[Codec] Enter frame length: 100
>[QoS] Enter Target Latency (Low, Balance, High): Low
>[QoS] Enter SDU Interval (us): 1000
>[QoS] Enter Framing (Unframed, Framed): Unframed
>[QoS] Enter PHY (1M, 2M): 2M
>[QoS] Enter Max SDU: 200
>[QoS] Enter RTN: 3
>[QoS] Enter Max Transport Latency (ms): 10
>[QoS] Enter Presentation Delay (us): 20000
>presets 00002bc9-0000-1000-8000-00805f9b34fb 0x06
...
*custom

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

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

November 2022 BlueZ