#include < bluetooth.h >

حقول البيانات
size_t	size

int(*	init )( bt_callbacks_t *callbacks)

int(*	enable )(bool guest_mode)

int(*	disable )(void)

void(*	cleanup )(void)

int(*	get_adapter_properties )(void)

int(*	get_adapter_property )( bt_property_type_t type)

int(*	set_adapter_property )(const bt_property_t *property)

int(*	get_remote_device_properties )(bt_bdaddr_t *remote_addr)

int(*	get_remote_device_property )(bt_bdaddr_t *remote_addr, bt_property_type_t type)

int(*	set_remote_device_property )(bt_bdaddr_t remote_addr, const bt_property_t property)

int(*	get_remote_service_record )(bt_bdaddr_t remote_addr, bt_uuid_t uuid)

int(*	get_remote_services )(bt_bdaddr_t *remote_addr)

int(*	start_discovery )(void)

int(*	cancel_discovery )(void)

int(*	create_bond )(const bt_bdaddr_t *bd_addr, int transport)

int(*	create_bond_out_of_band )(const bt_bdaddr_t bd_addr, int transport, const bt_out_of_band_data_t oob_data)

int(*	remove_bond )(const bt_bdaddr_t *bd_addr)

int(*	cancel_bond )(const bt_bdaddr_t *bd_addr)

int(*	get_connection_state )(const bt_bdaddr_t *bd_addr)

int(*	pin_reply )(const bt_bdaddr_t bd_addr, uint8_t accept, uint8_t pin_len, bt_pin_code_t pin_code)

int(*	ssp_reply )(const bt_bdaddr_t *bd_addr, bt_ssp_variant_t variant, uint8_t accept, uint32_t passkey)

const void (	get_profile_interface )(const char *profile_id)

int(*	dut_mode_configure )(uint8_t enable )

int(*	dut_mode_send )(uint16_t opcode, uint8_t *buf, uint8_t len)

int(*	le_test_mode )(uint16_t opcode, uint8_t *buf, uint8_t len)

int(*	config_hci_snoop_log )(uint8_t enable )

int(*	set_os_callouts )( bt_os_callouts_t *callouts)

int(*	read_energy_info )()

void(*	dump )(int fd, const char **arguments)

int(*	config_clear )(void)

void(*	interop_database_clear )(void)

void(*	interop_database_add )(uint16_t feature, const bt_bdaddr_t *addr, size_t len)

وصف مفصّل

ملاحظة: لا يتم إعداد أي ملفات تعريف تلقائيًا في وقت الإعداد/التفعيل. عندما يستدعي التطبيق واجهة برمجة التطبيقات "init" لأحد الملفات الشخصية، سيحدث أحد الإجراءَين التاليَين:

1.) إذا لم يكن البلوتوث مفعّلاً، سيضع "النواة البلوتوث" علامة على الملف الشخصي تفيد بأنّه مفعّل. بعد ذلك، عندما يستدعي التطبيق عملية "تفعيل" البلوتوث، سيتم تفعيل الملف الشخصي الذي تم وضع علامة عليه كجزء من تسلسل التفعيل من خلال استدعاء واجهات برمجة التطبيقات المناسبة للمجموعة. يجب أن يعرض الإجراء adapter_properties_cb قائمة أرقام تعريف UUID للملفات الشخصية المفعّلة.

2.) في حال تفعيل البلوتوث، سيستدعي "البلوتوث الأساسي" واجهة برمجة التطبيقات لملف التعريف في الحزمة لبدء تشغيل الملف الشخصي وتشغيل "adapter_properties_cb" مع القائمة الحالية لأرقام تعريف UUID، بما في ذلك رقم تعريف UUID للملف الشخصي الذي تمت إضافته حديثًا.

يجب أن يحدث العكس عند استدعاء واجهات برمجة التطبيقات الخاصة بـ "تنظيف" الملف الشخصي. يمثّل واجهة Bluetooth DM العادية.

التعريف في السطر 456 من الملف bluetooth.h .

مستندات الحقل

int(* cancel_bond)(const bt_bdaddr_t *bd_addr)

إلغاء الربط

التعريف في السطر 521 من الملف bluetooth.h .

int(* cancel_discovery)(void)

إلغاء ميزة "اقتراحات"

التعريف في السطر 508 من الملف bluetooth.h .

void(* cleanup)(void)

إغلاق الواجهة

التعريف في السطر 472 من الملف bluetooth.h .

int(* config_clear)(void)

محو ملف ‎ /data/misc/bt_config.conf ومحو جميع عمليات الربط المخزّنة

التعريف في السطر 580 من الملف bluetooth.h .

int(* config_hci_snoop_log)(uint8_t enable )

التعريف في السطر 557 من الملف bluetooth.h .

int(* create_bond)(const bt_bdaddr_t *bd_addr, int transport)

إنشاء ربط عبر البلوتوث

التعريف في السطر 511 من الملف bluetooth.h .

int(* create_bond_out_of_band)(const bt_bdaddr_t *bd_addr, int transport, const bt_out_of_band_data_t *oob_data)

إنشاء رابط بلوتوث باستخدام بيانات خارج النطاق

التعريف في السطر 514 من الملف bluetooth.h .

int(* disable)(void)

أوقِف البلوتوث.

التعريف في السطر 469 من الملف bluetooth.h .

void(* dump)(int fd, const char **arguments)

إتاحة وظائف أصلية لدالة dumpsys: الوظيفة متزامنة و |fd| مملوكة للمُتصل. |arguments| هي وسيطات قد تؤثر في الإخراج، ويتم ترميزها كسلسلات UTF-8.

التعريف في السطر 575 من الملف bluetooth.h .

int(* dut_mode_configure)(uint8_t enable )

واجهات برمجة تطبيقات وضع اختبار البلوتوث: يجب تفعيل البلوتوث لاستخدام واجهات برمجة التطبيقات هذه.

التعريف في السطر 548 من الملف bluetooth.h .

int(* dut_mode_send)(uint16_t opcode, uint8_t *buf, uint8_t len)

التعريف في السطر 551 من الملف bluetooth.h .

int(* enable)(bool guest_mode)

فعِّل البلوتوث.

التعريف في السطر 466 من الملف bluetooth.h .

int(* get_adapter_properties)(void)

الحصول على جميع سمات محوِّل البلوتوث عند الإعداد

التعريف في السطر 475 من الملف bluetooth.h .

int(* get_adapter_property)( bt_property_type_t type)

الحصول على سمة "محوّل البلوتوث" من النوع "type"

التعريف في السطر 478 من الملف bluetooth.h .

int(* get_connection_state)(const bt_bdaddr_t *bd_addr)

الحصول على حالة الاتصال لجهاز عن بُعد معيّن. تعني القيمة المعروضة 0 أنّ الجهاز غير متصل، وتشير الحالة المعروضة غير الصفرية إلى اتصال نشط.

التعريف في السطر 528 من الملف bluetooth.h .

const void*(* get_profile_interface)(const char *profile_id)

الحصول على واجهة ملف البلوتوث الشخصي

التعريف في السطر 544 من الملف bluetooth.h .

int(* get_remote_device_properties)(bt_bdaddr_t *remote_addr)

الحصول على جميع سمات "الجهاز البعيد"

التعريف في السطر 487 من الملف bluetooth.h .

int(* get_remote_device_property)(bt_bdaddr_t *remote_addr, bt_property_type_t type)

الحصول على سمة "الجهاز البعيد" من النوع "type"

التعريف في السطر 490 من الملف bluetooth.h .

int(* get_remote_service_record)(bt_bdaddr_t *remote_addr, bt_uuid_t *uuid)

الحصول على سجلّ خدمة الجهاز البعيد للمعرّف الفريد العالمي (UUID) المحدَّد

التعريف في السطر 498 من الملف bluetooth.h .

int(* get_remote_services)(bt_bdaddr_t *remote_addr)

بدء SDP للحصول على الخدمات عن بُعد

التعريف في السطر 502 من الملف bluetooth.h .

int(* init)( bt_callbacks_t *callbacks)

يفتح الواجهة ويقدّم إجراءات الاستدعاء لتنفيذ هذه الواجهة.

التعريف في السطر 463 من الملف bluetooth.h .

void(* interop_database_add)(uint16_t feature, const bt_bdaddr_t *addr, size_t len)

التعريف في السطر 592 من الملف bluetooth.h .

void(* interop_database_clear)(void)

محو (إعادة ضبط) الجزء الديناميكي من قاعدة بيانات التشغيل التفاعلي للأجهزة

التعريف في السطر 585 من الملف bluetooth.h .

int(* le_test_mode)(uint16_t opcode, uint8_t *buf, uint8_t len)

واجهات برمجة التطبيقات الخاصة بوضع الاختبار في تقنية البلوتوث المنخفضة الطاقة

التعريف في السطر 554 من الملف bluetooth.h .

int(* pin_reply)(const bt_bdaddr_t *bd_addr, uint8_t accept, uint8_t pin_len, bt_pin_code_t *pin_code)

BT Legacy PinKey Reply If accept==FALSE, then pin_len and pin_code shall be 0x0

التعريف في السطر 532 من الملف bluetooth.h .

int(* read_energy_info)()

قراءة تفاصيل معلومات الطاقة: تشير القيمة المعروضة إلى BT_STATUS_SUCCESS أو BT_STATUS_NOT_READY. يشير "النجاح" إلى أنّه تم إرسال أمر VSC إلى وحدة التحكّم.

التعريف في السطر 567 من الملف bluetooth.h .

int(* remove_bond)(const bt_bdaddr_t *bd_addr)

إزالة الربط

التعريف في السطر 518 من الملف bluetooth.h .

int(* set_adapter_property)(const bt_property_t *property)

ضبط سمة "محوّل البلوتوث" على "النوع"

التعريف في السطر 484 من الملف bluetooth.h .

int(* set_os_callouts)( bt_os_callouts_t *callouts)

تضبط وظائف الاتصال بنظام التشغيل التي يحتاجها bluedroid للإنذارات وأقفال التنشيط. يجب استدعاء هذا الإجراء مباشرةً بعد نجاح |init|.

التعريف في السطر 562 من الملف bluetooth.h .

int(* set_remote_device_property)(bt_bdaddr_t *remote_addr, const bt_property_t *property)

ضبط سمة "الجهاز عن بُعد" على "النوع"

التعريف في السطر 494 من الملف bluetooth.h .

الحجم size_t

تم ضبطه على sizeof(bt_interface_t)

التعريف في السطر 458 من الملف bluetooth.h .

int(* ssp_reply)(const bt_bdaddr_t *bd_addr, bt_ssp_variant_t variant, uint8_t accept, uint32_t passkey)

ردّ بروتوكول SSP للبلوتوث: يعمل تلقائيًا، والمقارنة الرقمية ومفتاح المرور، يجب أن يكون مفتاح المرور صفرًا لكل من BT_SSP_VARIANT_PASSKEY_COMPARISON وBT_SSP_VARIANT_CONSENT. بالنسبة إلى BT_SSP_VARIANT_PASSKEY_ENTRY، إذا كان accept==FALSE، يجب أن يكون مفتاح المرور صفرًا.

التعريف في السطر 540 من الملف bluetooth.h .

int(* start_discovery)(void)

بدء ميزة "اقتراحات"

التعريف في السطر 505 من الملف bluetooth.h .

تم إنشاء مستندات هذه البنية من الملف التالي:

hardware/libhardware/include/hardware/ bluetooth.h

مرجع بنية bt_interface_t

حقول البيانات

وصف مفصّل

مستندات الحقل