Estensioni HCI Bluetooth definite da Microsoft

Il Bluetooth Host-Controller Interface (HCI) specifica tutte le interazioni tra un host e un controller di radio Bluetooth. Le specifiche Bluetooth consentono ai comandi e agli eventi HCI definiti dal fornitore di abilitare l'interazione non standard tra host e controller. Microsoft definisce comandi ed eventi HCI specifici del fornitore utilizzati da Windows. Gli implementatori del controller Bluetooth possono usare queste estensioni per implementare funzionalità speciali.

Requirements

I comandi Bluetooth HCI sono identificati da un codice di comando a 16 bit. L'organizzazione Bluetooth definisce i valori nell'intervallo 0x0000 tramite 0xFBFF. I fornitori definiscono i valori nell'intervallo 0xFC00 tramite 0xFFFF, consentendo 1024 diversi codici di comando assegnati dal fornitore.

Il fornitore deve scegliere il valore del codice di comando definito da Microsoft. Microsoft non può scegliere un codice di comando e presupporre che nessun altro fornitore usi il codice per uno scopo in conflitto. Non è sicuro eseguire un comando specifico del fornitore e dipende dal controller per rifiutare il comando se non lo riconosce. Il controller potrebbe interpretare il comando come operazione distruttiva, ad esempio l'aggiornamento del firmware del controller.

Il fornitore deve comunicare il valore scelto tramite un metodo diverso dal controller. Microsoft non specifica come ottenere il codice scelto.

Notifica allo stack Bluetooth di Windows del codice di comando specifico del fornitore

Lo stack Bluetooth di Windows legge il codice di comando specifico del fornitore da una chiave del Registro di sistema, VsMsftOpCode.

La VsMsftOpCode chiave del Registro di sistema ha un tipo di REG_DWORD e i dati della chiave sono il codice operativo specifico del fornitore.

To specify the vendor specific opcode, use the AddReg directive under DDInstall.HW section in the driver's INF. La sezione di aggiunta al registro deve contenere:

HKR,,"VsMsftOpCode",0x00010001,<Vendor Specific Opcode>

Example:

[radio.NTamd64.HW]
AddReg=radio.NTamd64.HW.AddReg
[radio.NTamd64.HW.AddReg]
HKR,,"VsMsftOpCode",0x00010001,<Vendor Specific Opcode>

Comandi HCI definiti da Microsoft

Comandi e sottocomandi HCI definiti da Microsoft

Il controller riconosce che è presente un solo comando HCI specifico di Microsoft. Il set di comandi specifico di Microsoft viene esteso usando un codice operativo. Il primo parametro di comando per il comando HCI definito da Microsoft è un codice operativo che specifica il sottocomando.

Controllers must support HCI_VS_MSFT_Read_Supported_Features in order to support any other Microsoft HCI subcommands. Il supporto per altri comandi è facoltativo e dipende dai valori restituiti da HCI_VS_MSFT_Read_Supported_Features. Windows non invia comandi secondari definiti da Microsoft a meno che il controller non indichi il supporto per il sottocomando tramite una risposta a HCI_VS_MSFT_Read_Supported_Features.

HCI_VS_MSFT_Read_Supported_Features

HCI_VS_MSFT_Read_Supported_Features fornisce una bitmap che descrive le funzionalità definite da Microsoft supportate dal controller e specifica il prefisso per gli eventi definiti da Microsoft restituiti dal controller.

Il controller completerà sempre questo comando tempestivamente con un evento Command Completed.

Command_parameters

Subcommand_opcode (1 octet):

Return_parameters

Status (1 octet):

Subcommand_opcode (1 octet):

Supported_features (8 octets):

Microsoft_event_prefix_length (1 octet):

Microsoft_event_prefix (variable length):

HCI_VS_MSFT_Monitor_Rssi

HCI_VS_MSFT_Monitor_Rssi richiede che il controller avvii il monitoraggio del collegamento misurato RSSI per una connessione specificata e generi un evento quando il collegamento misurato della connessione RSSI non rientra nei limiti specificati.

The controller shall notify the host of the RSSI value with a periodically generated event (based on the RSSI_sampling_period). The measured link RSSI shall be the absolute receiver signal strength value in dBm for the BR/EDR connection.

In risposta a un comando HCI_VS_MSFT_Monitor_Rssi, il controller genererà un evento Command Complete con stato uguale a zero se il controller può iniziare il monitoraggio o uno stato diverso da zero. If the status value is nonzero, the controller shall not generate an HCI_VS_MSFT_Rssi_Event in response to this command.

The controller shall refuse the command if another HCI_VS_MSFT_Monitor_Rssi command with the same Connection_Handle is outstanding, or if the specified connection handle is invalid. Il controller può anche rifiutare il comando per altri motivi, ad esempio l'esaurimento delle risorse.

Questo diagramma di stato mostra gli stati di transizione nel controller quando si monitora RSSI per una connessione.

The controller shall generate an HCI_VS_MSFT_Rssi_Event when the received RSSI is greater than or equal to the specified RSSI_threshold_high. After this event has been generated, the controller shall not generate a new HCI_VS_MSFT_Rssi_Event to specify that the RSSI_threshold_high has been exceeded until it generates an HCI_VS_MSFT_Rssi_Event that specifies the RSSI has fallen below RSSI_threshold_low.

The controller shall generate an HCI_VS_MSFT_Rssi_Event when the received RSSI equals or falls below the specified RSSI_threshold_low over the specified RSSI_threshold_low_time_interval. After this event has been generated, the controller shall not generate a new HCI_VS_MSFT_Rssi_Event to specify that the RSSI has fallen below the RSSI_threshold_low until an HCI_VS_MSFT_Rssi_Event event is generated to specify that RSSI_threshold_high has been reached or exceeded.

If the RSSI_sampling_period is between 0x01 and 0xFE, the controller shall generate an HCI_VS_MSFT_Rssi_Event periodically every RSSI_sampling_period. This event shall contain the average of the RSSI calculated over the RSSI_sampling_period. If the RSSI_sampling_period is 0x00 or 0xFF, the controller shall not notify the host periodically with HCI_VS_MSFT_Rssi_Event.

Command_parameters

Subcommand_opcode (1 ottetto):

Connection_Handle (2 ottetti):

RSSI_threshold_high (1 ottetto):

RSSI_threshold_low (1 byte):

RSSI_threshold_low_time_interval (1 ottetto):

RSSI_sampling_period (1 ottetto):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Eventi generati a meno che non siano stati mascherati

The controller shall promptly generate a Command Complete event when the HCI_VS_MSFT_Monitor_Rssi command is received. If the Command Complete event returns a status of 0, the controller shall generate an HCI_VS_MSFT_Rssi_Event when one of the following conditions occurs.

• The observed RSSI for the device over RSSI_threshold_low_time_interval becomes equal to or less than the specified RSSI_threshold_low value.
• The observed RSSI for the device becomes greater than or equal to the specified RSSI_threshold_high value.
• The RSSI_sampling_period is valid and the sampling period expires.

Il controller deve eseguire tutte le operazioni di pulizia necessarie se la connettività con il dispositivo specificato viene persa. In this case, an HCI_VS_MSFT_Cancel_Monitor_Rssi command isn't sent to the controller.

HCI_VS_MSFT_Cancel_Monitor_Rssi

HCI_VS_MSFT_Cancel_Monitor_Rssi cancels a previously issued HCI_VS_MSFT_Monitor_Rssi command. Il controller genererà tempestivamente un evento Command Completed in risposta a questo comando.

Command_parameters

Subcommand_opcode (1 ottetto):

Connection_Handle (2 ottetti):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Eventi generati a meno che non siano stati mascherati

The controller shall generate a Command Complete event when the HCI_VS_MSFT_Cancel_Monitor_RSSI command is received.

HCI_VS_MSFT_LE_Monitor_Advertisement

HCI_VS_MSFT_LE_Monitor_Advertisement richiede che il controller avvii il monitoraggio degli annunci che ricadono nell'intervallo RSSI specificato e soddisfano anche una delle condizioni seguenti.

• Un criterio specificato può essere abbinato al pacchetto di annunci ricevuti.
• Un UUID specificato può essere abbinato al pacchetto di annuncio ricevuto.
• È possibile usare una chiave IRK (Identity Resolution Key) specificata per risolvere l'indirizzo privato del dispositivo da cui ha avuto origine il pacchetto pubblicitario.
• Un indirizzo Bluetooth specificato può essere abbinato al pacchetto di annunci ricevuti.

Il comando v2 consente all'host di combinare alcune delle condizioni precedenti con opzioni che regolano l'origine dell'annuncio e la destinazione di un annuncio diretto, per perfezionare ulteriormente gli annunci monitorati. Il comando v2 consente inoltre all'host di filtrare quali annunci monitorati portano il controller a generare rapporti sugli annunci.

Il controller genererà un evento Command Complete in risposta a questo comando. Il valore di stato deve essere impostato su zero se il controller può iniziare il monitoraggio o uno stato diverso da zero in caso contrario. If the controller doesn't support RSSI monitoring for LE Advertisements, it shall ignore the RSSI_threshold_high, RSSI_threshold_low, RSSI_threshold_low_time_interval, and RSSI_sampling_period parameter values.

Questo diagramma di stato mostra gli stati di transizione nel controller quando si monitora RSSI per un annuncio pubblicitario.

The controller shall begin monitoring an advertisement only when the received RSSI is greater than or equal to RSSI_threshold_high for a particular device and the Monitor_options match (see below). The controller shall generate an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 1 and Monitor_handle set to the handle for this Condition, to notify the host that the controller is monitoring this particular device for Condition. Additionally, the Controller shall propagate the first advertisement report of a monitored advertisement to the Host only when the Advertisement_report_filter_options match (see below).

The Monitor_options for a filter are considered a match based on the following logic (in pseudocode):

MatchesCondition = (PDU Matches Condition Parameters)

IsAdvAMatch = ((Monitor_options bit 0 is set) && ((AdvA == Peer_device_address) && (TxAdd == Peer_device_address_type))) ||
    ((Monitor_options bit 1 is set) && (AdvA resolvable with Peer_device_IRK))

IsDirectedAdvAMatch = (TargetA is permitted based on the Scanning Filter Policy) &&
    (((Monitor_options bit 2 is set) && ((AdvA == Peer_device_address) && (TxAdd == Peer_device_address_type))) ||
        ((Monitor_options bit 3 is set) && (AdvA resolvable with Peer_device_IRK)))

IsDirectedTargetAMatch = (Monitor_options bit 4 is set) &&
    (TargetA is permitted based on the Scanning Filter Policy)

MonitorOptionsMatch = (MatchesCondition && IsAdvAMatch) ||
    IsDirectedAdvAMatch ||
    IsDirectedTargetAMatch ||
    ((Monitor_options bit 5 is set) && MatchesCondition)

And for a monitored advertisement, the Advertisement_report_filter_options are considered a match based on the following logic (in pseudocode):

IsDuplicateFilterSatisfied = (Advertisement_report_filter_options bit 0 is NOT set || PDU is not a duplicate)

ShouldGenerateLegacyReport = (Advertisement_report_filter_options bit 1 is set) &&
    (PDU is Legacy) &&
    MonitorOptionsMatch

ShouldGenerateExtendedReport = (Advertisement_report_filter_options bit 2 is set) &&
    (PDU is Extended) &&
    MonitorOptionsMatch

ShouldGenerateDirectedReport = (Advertisement_report_filter_options bit 3 is set) &&
    (PDU is Directed) &&
    MonitorOptionsMatch

AdvertisementReportFilterOptionsMatch = IsDuplicateFilterSatisfied &&
    (ShouldGenerateLegacyReport || ShouldGenerateExtendedReport || ShouldGenerateDirectedReport)

The controller shall stop monitoring for Condition if the RSSI of the received advertisements equals or falls below RSSI_threshold_low over RSSI_threshold_low_interval for the particular device. The controller shall generate an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 0 to notify the host that the controller has stopped monitoring the particular device for the Condition. After the controller specifies the HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 0, the controller shall not allow further advertisement packets to flow to the host for the device until the controller has notified the host that the RSSI for the particular device has risen to or above RSSI_threshold_high for the particular device for the Condition.

Additionally, the controller shall generate an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 0 to notify the host that the controller has stopped monitoring the device for the Condition if the specified RSSI_threshold_low_time_interval expires without receiving any advertising packets from the device. Se il controller monitora un dispositivo per una determinata condizione, le istruzioni seguenti sono vere.

If the controller supports the RSSI monitoring of LE extended advertisements without sampling, the controller shall propagate anonymous advertisement packets to the host if the RSSI value for the packet is greater than or equal to RSSI_threshold_high. Anonymous advertisements shall not be tracked and the HCI_VS_MSFT_LE_Monitor_Device_Event event shall not be generated.

Se il titolare del trattamento supporta il monitoraggio RSSI degli annunci LE senza campionamento, il titolare del trattamento genera un rapporto pubblicitario troncato nel caso in cui i frammenti ricevuti dell'annuncio corrispondano, ma in cui l'intero annuncio non è stato ricevuto correttamente.

Il controllore supporta almeno 30 istanze di Monitor_handle simultanee, almeno 30 dispositivi monitorati simultaneamente e almeno 20 annunci duplicati tracciati simultaneamente. Il Controller deve anche essere in grado di eseguire una scansione LE continua con un ciclo di lavoro del 10%.

Se la risoluzione degli indirizzi è abilitata nel controller e l'host intende monitorare un dispositivo remoto con il relativo IRK archiviato correttamente nell'elenco di risoluzione del controller, l'host fornirà i parametri Peer_Identity_Address e Peer_Identity_Address_Type dalla voce dell'elenco di risoluzione del dispositivo remoto come parametri Peer_device_address e Peer_device_address_type, rispettivamente.

If the controller previously received an HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x00, the sampling period timer shall not be stopped. Per altre informazioni, vedere Esempio: HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable sui filtri con periodo di campionamento. Se il controller riceve pacchetti pubblicitari non duplicati dallo stesso dispositivo, confronterà ogni pacchetto pubblicitario con le condizioni archiviate nel controller.

If the controller receives an advertisement packet from a device that matches multiple Conditions, then the controller shall generate an HCI_VS_MSFT_LE_Monitor_Device_Event for each Condition that matched, with Monitor_handle set to the Condition that matched.

If the controller is unable to monitor the RSSI values for all devices in range that match the Condition, it keeps monitoring as many devices as it can. La decisione sui dispositivi da monitorare dipenderà dai valori RSSI degli annunci ricevuti. Il controller monitorerà i dispositivi con maggiore potenza del segnale ricevuto.

If the controller has notified the host about a particular device (A) and it's monitoring devices at maximum hardware capacity, and if another device (B) comes into range with a higher RSSI value, then the controller shall notify the host that it has stopped monitoring the device (A) by generating an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 0. The controller shall also generate an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 1 to notify the host that the device (B) is now being monitored.

Tipo di condizione e parametri di condizione

The Condition_type parameter specifies whether the Condition parameter specifies a pattern, UUID, IRK, or BD_ADDR.

If the Condition_type parameter specifies a pattern, the Condition contains two sections that contain the number of patterns present within the Condition, and the pattern data.

Number of Patterns specifica il numero di modelli che devono essere confrontati.

Pattern Data has the following format.

• Length specifies the length of this pattern include the data type and start byte of the pattern.
• AD Type specifies the AD Type field.
• Inizio del pattern specifica la posizione iniziale dei byte del pattern immediatamente successivo al tipo AD.
• Pattern has a size of (Length - 0x2) and is the pattern to be matched for the specified AD Type within the advertisement packet from the specified starting byte.

Se sono specificati più modelli, il controller deve assicurarsi che almeno un modello corrisponda all'annuncio ricevuto.

Se il controller supporta il monitoraggio RSSI degli annunci estesi LE senza campionamento:

• Il titolare del trattamento cercherà il modello nei primi 251 ottetti dei dati della pubblicità host e potrà cercare in eventuali ottetti rimanenti dei dati della pubblicità host. Se la sezione AD si estende oltre i primi 251 ottetti dei dati di Host Advertising Data, il titolare del trattamento cercherà il modello all'interno della parte della sezione AD che si trova nei primi 251 ottetti dei dati di Host Advertising e potrebbe cercare eventuali ottetti rimanenti dei dati di Host Advertising Data. Nota: in base alla frammentazione da parte dell'inserzionista, i primi 251 ottetti dei dati della pubblicità host possono estendersi attraverso AdvData di più PDU pubblicitari. Gli scanner devono limitare il numero di AuxPtrs che seguono, per evitare di seguire catene eccessivamente lunghe di PDU.

• Il titolare del trattamento deve tenere traccia in base a un indirizzo per dispositivo per ogni set di annunci pubblicitari. The controller shall propagate a HCI_VS_MSFT_LE_Monitor_Device_Event for each advertising set that matches the pattern even if the advertisement comes from the same device address.

If the Condition_type parameter specifies a UUID, the Condition parameter contains a UUID Type and a UUID. Il tipo UUID specifica se l'UUID è a 16 bit, a 32 bit o a 128 bit. Il controller analizzerà l'UUID del servizio del pacchetto di annuncio per verificare la presenza dell'UUID specificato. Se il tipo UUID è definito come 0x01, il controller analizzerà l'elenco incompleto degli UUID del servizio a 16 bit e l'elenco completo degli UUID del servizio a 16 bit specificati nel tipo di AD UUID del servizio. Se il tipo UUID è definito come 0x02, il controller analizzerà l'elenco incompleto degli UUID del servizio a 32 bit e l'elenco completo degli UUID a 32 bit specificati nel tipo di AD UUID del servizio. Se il tipo UUID specificato è 0x03, il controller analizzerà l'elenco incompleto degli UUID del servizio a 128 bit e l'elenco completo degli UUID del servizio a 128 bit specificati nel tipo di AD UUID del servizio.

Se il controller supporta il monitoraggio RSSI degli annunci estesi LE senza campionamento:

• Il titolare del trattamento cercherà l'UUID del servizio nei primi 251 ottetti dei dati della pubblicità host e potrà cercare eventuali ottetti rimanenti dei dati della pubblicità host. Se la sezione AD si estende oltre i primi 251 ottetti dei dati di pubblicità host, il controllore cercherà l'UUID del servizio all'interno della parte della sezione AD che si trova nei primi 251 ottetti dei dati di pubblicità host e potrebbe cercare negli eventuali ottetti rimanenti dei dati di pubblicità host. Nota: in base alla frammentazione da parte dell'inserzionista, i primi 251 ottetti dei dati pubblicitari dell'host possono estendersi sugli AdvData di più PDU pubblicitari. Gli scanner devono limitare il numero di AuxPtrs che seguono, per evitare di seguire catene eccessivamente lunghe di PDU.

• Il titolare del trattamento deve tenere traccia in base a un indirizzo per dispositivo per ogni set di annunci pubblicitari. The controller shall propagate a HCI_VS_MSFT_LE_Monitor_Device_Event for each advertising set that matches the Service UUID even if the advertisement comes from the same device.

If the Condition_type parameter specifies an IRK, the Condition parameter contains the IRK.

If the Condition_type parameter specifies a Bluetooth Address, the Condition parameter contains the address type and BD_ADDR.

Il titolare del trattamento deve mantenere il monitoraggio in base alle condizioni, anche quando l'analisi (attiva o passiva) è abilitata. Quando l'analisi attiva è abilitata, la risposta di analisi per un annuncio pubblicitario corrispondente a un filtro deve essere propagata all'host.

If the controller receives a HCI_VS_MSFT_LE_Monitor_Advertisement command when the filters are disabled (due to a previously received HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x00), the controller shall accept the command if it can, but set it to a disabled state. Il controller può anche rifiutare il comando per altri motivi, ad esempio l'esaurimento delle risorse.

Se tutti i bit di Monitor_options sono chiari, il controller deve restituire il codice di errore Parametri di comando HCI non validi (0x12).

Se è impostato bit 1 o bit 3 di Monitor_options e Peer_device_IRK è impostato su un IRK non valido oppure nessuno dei bit di Monitor_options è impostato, il controller deve restituire il codice di errore Parametri di comando HCI non validi (0x12).

Se è impostato bit 0 o bit 1 o bit 2 o bit 3 di Monitor_options e Condition_type è impostato su 0x03 o 0x04, il controller deve restituire il codice di errore Parametri di comando HCI non validi (0x12).

Se viene impostato il bit 0 di Advertisement_report_filter_options e RSSI_sampling_period è un valore diverso da 0x00, il controller deve restituire il codice di errore Parametri di comando HCI non validi (0x12).

Missing parameters

Quando viene eseguita una versione di questo comando che non include tutti i parametri, è necessario usare quanto segue:

Command_parameters

Subcommand_opcode_v1 (1 ottetto):

Subcommand_opcode_v2 (1 byte):

RSSI_threshold_high (1 ottetto):

RSSI_threshold_low (1 byte):

RSSI_threshold_low_time_interval (1 ottetto):

RSSI_sampling_period (1 ottetto):

Monitor_options (1 ottetto):

Opzioni_di_filtraggio_rapporto_annuncio (1 byte):

Peer_device_address (6 byte)

Peer_device_address_type (1 ottetto):

Peer_device_IRK (16 byte):

Tipo_condizione (1 ottetto):

Condizione: i campi applicabili per Condizione dipendono dal valore di Condition_type. Per altre informazioni, vedere la sezione parametri Condition_type e Condition.

Numero_di_modelli (1 ottetto):

Pattern_data (>3 ottetti):

UUID_type (1 byte):

UUID (2, 4 o 16 ottetti):

IRK (16 byte):

Tipo_di_indirizzo (1 octet):

BD_ADDR (6 ottetti):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Monitor_handle (1 byte):

Eventi generati a meno che non siano stati mascherati

When the HCI_VS_MSFT_LE_Monitor_Advertisement command is received, the controller shall generate a Command Complete event.

HCI_VS_MSFT_LE_Cancel_Monitor_Advertisement

HCI_VS_MSFT_LE_Cancel_Monitor_Advertisement cancels a previously issued HCI_VS_MSFT_LE_Monitor_Advertisement command.

Il controller genererà tempestivamente un evento Command Completed in risposta a questo comando.

Command_parameters

Subcommand_opcode (1 ottetto):

Connection_Handle (1 byte):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Eventi generati a meno che non siano stati mascherati

The controller shall generate a Command Complete event when the HCI_VS_MSFT_LE_Cancel_Monitor_Advertisement command is received.

HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable

HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable imposta lo stato dei filtri degli annunci pubblicitari.

If Enable is set to 0x00, the controller shall propagate received advertisements to the host based on existing filter accept list settings. The controller shall continue monitoring the devices that are currently being monitored and generate an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 0 if the device is no longer being monitored. The controller shall generate an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 1 if a new device is being monitored. The host may issue HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable with Enable set to 0x01 to reenable all the filter conditions.

If Enable is set to 0x01, this command enables all filters that were set with a previously issued HCI_VS_MSFT_LE_Monitor_Advertisement command. Il controller rifiuterà un comando HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable se non alterna lo stato del filtro.

• The controller shall reject an HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x01 if it previously received an HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x01.
• The controller shall reject the HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x00 if it previously received an HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x00.

Lo stato predefinito del filtro di annuncio deve essere disattivato. This state is equivalent to the controller previously receiving a HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command with Enable set to 0x00. Il controller genererà tempestivamente un evento Command Completed in risposta a questo comando.

Command_parameters

Subcommand_opcode (1 ottetto):

Abilita (1 ottetto):

Return_parameter

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Eventi generati a meno che non siano stati mascherati

The controller shall generate a Command Complete event when the HCI_VS_MSFT_LE_Set_Advertisement_Filter_Enable command is received.

HCI_VS_MSFT_Read_Absolute_RSSI

HCI_VS_MSFT_Read_Absolute_RSSI reads the absolute Received Signal Strength Indication (RSSI) value for a BR/EDR connection from the controller.

Un handle di connessione viene fornito sia come comando che come parametro restituito per identificare la connessione ACL di cui viene letto RSSI. The RSSI metric is the absolute receiver signal strength in dBm to ± 6 dB accuracy. Se non è possibile leggere l'RSSI, la metrica RSSI verrà impostata su 127. Il controller completerà sempre questo comando tempestivamente con un evento Command Completed.

Command_parameters

Subcommand_opcode (1 ottetto):

Connection_Handle (2 ottetti):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Connection_Handle (2 ottetti):

RSSI (1 ottetto):

Eventi generati a meno che non siano stati mascherati

The controller shall generate a Command Complete event when the HCI_VS_MSFT_Read_Absolute_RSSI command has completed.

Eventi HCI Bluetooth definiti da Microsoft

Tutti gli eventi Bluetooth HCI definiti da Microsoft sono eventi definiti dal fornitore e usano il codice evento 0xFF. I dati dell'evento per gli eventi Microsoft iniziano sempre con una stringa costante di byte per distinguere gli eventi definiti da Microsoft da altri eventi definiti dal fornitore. The length and value of the constant string are defined by the controller implementer and returned in response to HCI_VS_MSFT_Read_Supported_Features.

HCI_VS_MSFT_RSSI_Event

HCI_VS_MSFT_RSSI_Event indicates that an HCI_VS_MSFT_Monitor_Rssi command has completed. If the Status parameter is zero, the command completed because the RSSI value for the remote device changed to a value outside of the specified range. If the Status parameter is nonzero, the command completed because the RSSI value of the connection can no longer be monitored.

Event_parameters

Event_prefix (dimensione variabile):

Microsoft_event_code (1 ottetto):

Stato (1 ottetto):

Connection_Handle (2 ottetti):

RSSI (1 ottetto):

HCI_VS_MSFT_LE_Monitor_Device_Event

HCI_VS_MSFT_LE_Monitor_Device_Event indica che il controller ha avviato o arrestato il monitoraggio di un dispositivo Bluetooth LE.

If the Monitor_state parameter value is 1, the controller started monitoring the Bluetooth device with the specified BD_ADDR. If the Monitor_state parameter value is 0, the controller stopped monitoring the Bluetooth device with the specified BD_ADDR.

The controller shall not generate an HCI_VS_MSFT_LE_Monitor_Device_Event with the Monitor_state parameter set to 0 if it hasn't already generated an HCI_VS_MSFT_LE_Monitor_Device_Event with Monitor_state set to 1.

Event_parameters

Event_prefix (dimensione variabile):

Microsoft_event_code (1 ottetto):

Tipo_di_indirizzo (1 octet):

BD_ADDR (6 ottetti):

Monitor_handle (1 byte):

Stato_monitoraggio (1 ottetto):

Comandi HCI AVDTP definiti da Microsoft

I seguenti comandi HCI AVDTP forniscono supporto per il trasferimento A2DP della banda laterale audio. Per altre informazioni, vedere Audio Sideband A2DP Offload.

HCI_VS_MSFT_Avdtp_Capabilities_Configuration

HCI_VS_MSFT_Avdtp_Capabilities_Configuration configura l'interfaccia del trasporto audio e restituisce le funzionalità codec del controller Bluetooth, che è un elenco di blocchi di informazioni sui codec. Ogni blocco di informazioni sul codec descrive un codec supportato.

Alcuni parametri riportati di seguito sono matrici di strutture con lunghezza variabile, quindi si presuppone che tutti questi parametri siano ancora inseriti in un comando HCI e in un evento HCI corrispondente.

Command_parameters

External_codec_count (1 byte):

External_codec_capability (lunghezza variabile)

This data structure repeats External_codec_count times.

Audio_interface_parameter_count (1 ottetto):

Audio_interface_parameter (lunghezza variabile)

This data structure repeats Audio_interface_parameter_count times.

Return_parameters

Stato (1 ottetto):

Subcommand_opcode _ (1 octet)

Internal_codec_count (1 ottetto):

Internal_codec_capability (lunghezza variabile):

Questa struttura di dati si ripete Internal_codec_count volte.

Audio_interface_parameter_count (1 ottetto):

Audio_interface_parameter (lunghezza variabile)

Questa struttura di dati si ripete Audio_interface_parameter_count volte.

HCI_VS_MSFT_Avdtp_Open

Alloca e configura le risorse di offload AVDTP all'interno del controller.

Alcuni parametri riportati di seguito sono matrici di strutture con lunghezza variabile, quindi si presuppone che tutti questi parametri siano ancora inseriti in un comando HCI e in un evento HCI corrispondente.

Command_parameters

Connection_handle (2 ottetti)

L2cap_destination_cid (2 ottetti)

L2cap_mtu (2 byte)

Configured_codec_capability (lunghezza variabile):

Audio_interface_parameter_count (1 ottetto):

Audio_interface_parameter (lunghezza variabile)

Questa struttura di dati si ripete Audio_interface_parameter_count volte.

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Avdtp_offload_handle (2 byte):

Audio_interface_parameter_count (1 ottetto):

Audio_interface_parameter (lunghezza variabile)

Questa struttura di dati si ripete Audio_interface_parameter_count volte.

HCI_VS_MSFT_Avdtp_Start

Questo comando avvia lo streaming audio dal trasporto audio ai pacchetti AVDTP multimediali trasmessi. Dopo l'esecuzione di questo comando, il controller Bluetooth avvia l'attività seguente.

• Riceve i dati audio dal trasporto audio
• Se il codificatore si trova nel controller Bluetooth, codifica i dati ricevuti dal trasporto audio per produrre frame codificati
• Se il codificatore si trova nel DSP audio, estrae frame codificati dal trasporto audio.
• Assembla i frame codificati in payload multimediali AVDTP
• Costruisce e trasmette pacchetti multimediali AVDTP contenenti i payload multimediali

Command_parameters

Avdtp_offload_handle (2 byte):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

HCI_VS_MSFT_Avdtp_Suspend

Arresta l'attività di streaming avviata da HCI_VS_MSFT_Avdtp_Start.

Command_parameters

Avdtp_offload_handle (2 byte):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

HCI_VS_MSFT_Avdtp_Close

Rilascia le risorse di scaricamento AVDTP allocate da HCI_VS_MSFT_Avdtp_Open.

Command_parameters

Avdtp_offload_handle (2 byte):

Return_parameters

Stato (1 ottetto):

Subcommand_opcode (1 ottetto):

Appendix

Questa sezione contiene esempi e diagrammi di estensione HCI Bluetooth definiti da Microsoft.

Esempio: Modelli di corrispondenza per HCI_VS_MSFT_LE_Monitor_Advertisement

This example shows a received HCI_VS_MSFT_LE_Monitor_Advertisement command and the evaluations of three different advertisement packets against the command parameters.

Received HCI_VS_MSFT_LE_Monitor_Advertisement command An HCI_VS_MSFT_LE_Monitor_Advertisement command is received by the controller and contains the following parameters.

Il controller riceve quindi i pacchetti di annunci seguenti.

• Pacchetto pubblicitario [A]

  0x02 0x01 0x01 0x07 0x09 0x54 0x61 0x62 0x6C 0x65 0x74 0x05 0xFF 0x00 0x06 0xFF 0xFF

• Pacchetto pubblicitario [B]

  0x02 0x01 0x01 0x07 0x09 0x54 0x61 0x62 0x6C 0x65 0x74 0x04 0xFF 0x00 0x06 0xFF

• Pacchetto pubblicitario [C]

  0x07 0x09 0x54 0x61 0x62 0x6C 0x65 0x74 0x05 0xFF 0x00 0x06 0xFF 0xFF

• Pacchetto pubblicitario [D]

  0x02 0x01 0x02 0x05 0xFF 0x00 0x06 0xFF 0x01

Valutazione della corrispondenza per il pacchetto di annunci pubblicitari [A]

Verdict: PASS (both patterns match)

Valutazione della corrispondenza per il pacchetto di annunci pubblicitari [B]

Verdict: PASS (only first pattern matches)

Valutazione della corrispondenza per il pacchetto di annunci pubblicitari [C]

Verdict: PASS (only second pattern matches)

Valutazione della corrispondenza per il pacchetto pubblicitario [D]

Verdict: FAIL (neither pattern matches)

Esempio: monitoraggio degli annunci pubblicitari

Questo esempio illustra il monitoraggio degli annunci RSSI. Di seguito sono riportati i valori RSSI per gli annunci ricevuti corrispondenti a una condizione specificata.

The advertisement RSSI is greater than RSSI_threshold_high at time 3. Il timer periodico per il campionamento inizia all'ora 3. Ogni 2 secondi, il timer periodico scade e il valore RSSI medio dell'annuncio ricevuto viene propagato allo stack.

Quando il timer periodico scade al momento 5, la media degli annunci RSSI ricevuti durante questo periodo (-23dB) viene propagata allo stack.

When the periodic timer expires at time 13, the average of the advertisement RSSIs received during this timeframe is below RSSI_threshold_low (-80dB). La media dell'RSSI dell'annuncio (-85 dB) deve essere propagata all'host.

When RSSI_threshold_low_time_interval expires at instant 15, an advertisement is propagated to the host with RSSI of -85dB. In questo esempio non vengono inviati altri annunci all'host.

Esempio: Monitoraggio degli annunci BAP da un dispositivo

Mentre è associato a un CAP Acceptor, ma non connesso, un host potrebbe monitorare gli Annunci BAP da quel dispositivo.

Esempio: Monitoraggio degli annunci CAP da un dispositivo

Durante un legame con un comandante CAP, pur senza essere connesso, un host potrebbe monitorare gli annunci CAP da quel dispositivo.

Diagramma di flusso: filtraggio di annunci e lista di accettazione

Questo diagramma di flusso fornisce un esempio di implementazione del controller per il filtraggio degli annunci pubblicitari e il filtraggio tramite l'elenco di accettazione dei filtri quando viene ricevuto un annuncio.

A controller can implement this logic differently, as long as the host is notified of the advertisement or HCI_VS_MSFT_LE_Monitor_Device_Event as specified by the flowchart.

Diagramma di sequenza: Propagare la risposta di scansione associata all'annuncio

Diagramma di sequenza: Propagare la risposta di scansione associata all'annuncio

Questo diagramma di sequenza mostra una risposta di analisi propagata associata a un annuncio pubblicitario che soddisfa un filtro pubblicitario quando è abilitata l'analisi attiva. Questo diagramma mostra solo la sequenza prevista di eventi tra controller e host e non mostra gli eventi tra il controller e un determinato dispositivo. Assume that there's an advertisement A that satisfies an advertisement filter, and an advertisement B that doesn't satisfy the advertisement filter.