Support bluetooth.simulateService

Author: chengweih001

index.bs

@@ -5008,7 +5008,14 @@ Each <a>simulated Bluetooth adapter</a> has an <dfn>adapter state</dfn> that is
 
 Each <a>simulated Bluetooth adapter</a> has a <dfn lt="LE supported state">low-energy supported state</dfn> that is a boolean describing if the adapter supports Bluetooth Low Energy.
 
-A <dfn>simulated Bluetooth device</dfn> is a software defined [=Bluetooth device=] that behaves like a physical device, and may be attached to a <a>simulated Bluetooth adapter</a>, and may have associated properties like <a>Manufacturer Specific Data</a> and <a>Service UUIDs</a>.
+A <dfn>simulated Bluetooth device</dfn> is a software defined [=Bluetooth device=] that
+behaves like a physical device, may be attached to a <a>simulated Bluetooth adapter</a>,
+may have associated properties like <a>Manufacturer Specific Data</a> and <a>Service UUIDs</a>,
+and has a <dfn>simulated GATT service mapping</dfn>, which is an <a>ordered map</a> of Bluetooth
+<a>UUID</a> {{strings}} to <a>simulated GATT services</a>.
+
+A <dfn>simulated GATT service</dfn> is a software defined [=Service=] that belongs to a
+<a>simulated Bluetooth device</a>, and has a property of <a>UUID</a>.
 
 Issue: CDDL snippetes use the "text" type instead of
 "browsingContext.BrowsingContext" to allow indepedent programmatic
@@ -5567,6 +5574,89 @@ A [=local end=] could simulate device GATT disconnection by sending the followin
 </pre>
 </div>
 
+#### The bluetooth.simulateService Command #### {#bluetooth-simulateservice-command}
+
+<pre highlight="cddl" class="cddl remote-cddl local-cddl">
+bluetooth.SimulateService = (
+   method: "bluetooth.simulateService",
+   params: bluetooth.simulateServiceParameters,
+)
+
+bluetooth.simulateServiceParameters = {
+   context: text,
+   address: text,
+   uuid: bluetooth.BluetoothServiceUuid,
+   type: "add" / "remove",
+}
+
+</pre>
+
+<div algorithm="remote end steps for bluetooth.simulateService">
+The [=remote end steps=] with command parameters |params| are:
+
+1. Let |contextId| be |params|[`"context"`].
+1. Let |navigable| be the result of [=trying=] to [=get a navigable=] with |contextId|.
+1. Let |deviceAddress| be |params|[`"address"`].
+1. Let |simulatedBluetoothAdapter| be |navigable|'s <a>simulated Bluetooth adapter</a>.
+1. If |simulatedBluetoothAdapter| is empty, return [=error=] with [=error code=] [=invalid argument=].
+1. Let |deviceMapping| be |simulatedBluetoothAdapter|'s <a>simulated Bluetooth device mapping</a>.
+1. If |deviceMapping|[|deviceAddress|] [=map/exists=], let |simulatedDevice| be |deviceMapping|[|deviceAddress|].
+1. Otherwise, return [=error=] with [=error code=] [=invalid argument=].
+1. Let |simulatedDeviceInstance| be the result of <a>get the <code>BluetoothDevice</code> representing</a>
+    |simulatedDevice| inside |navigable|'s <a>active window</a>'s <a spec=HTML>associated <code>Navigator</code></a>'s
+    [=associated Bluetooth=].
+1. Let |serviceMapping| be |simulatedDevice|'s <a>simulated GATT service mapping</a>.
+1. If |params|[`"type"`] is `"add"`:
+    1. If |serviceMapping|[|params|[`"uuid"`]] [=map/exists=], return [=error=] with [=error code=] [=invalid element state=].
+    1. Let |simulatedGattService| be a new <a>simulated GATT service</a>.
+    1. Set |simulatedGattService|'s <a>UUID</a> to |params|[`"uuid"`].
+    1. Set |serviceMapping|[|params|[`"uuid"`]] to |simulatedGattService|.
+    1. <a>Create a <code>BluetoothRemoteGATTService</code> representing</a> |simulatedGattService|
+        and add a mapping from |simulatedGattService| to the resulting {{Promise}} in
+        |simulatedDeviceInstance|.{{[[context]]}}.{{Bluetooth/[[attributeInstanceMap]]}}.
+    1. Return [=success=] with data `null`.
+1. Else if |params|[`"type"`] is `"remove"`:
+    1. If |serviceMapping|[|params|[`"uuid"`]] [=map/exists=], let |simulatedGattService| be |serviceMapping|[|params|[`"uuid"`]].
+    1. Otherwise, return [=error=] with [=error code=] [=invalid element state=].
+    1. Remove |simulatedGattService| from |simulatedDeviceInstance|.{{[[context]]}}.{{Bluetooth/[[attributeInstanceMap]]}}.
+    1. Remove |params|[`"uuid"`] from |serviceMapping|.
+    1. Return [=success=] with data `null`.
+1. Return [=error=] with [=error code=] [=invalid argument=].
+
+</div>
+
+<div class="example">
+A [=local end=] could simulate adding a GATT service by sending the following message:
+
+<pre highlight="json">
+{
+  "method": "bluetooth.simulateService",
+  "params": {
+    "context": "cxt-d03fdd81",
+    "address": "09:09:09:09:09:09",
+    "uuid": "12345678-1234-5678-9abc-def123456789",
+    "type": "add"
+  }
+}
+</pre>
+</div>
+
+<div class="example">
+A [=local end=] could simulate removing a GATT service by sending the following message:
+
+<pre highlight="json">
+{
+  "method": "bluetooth.simulateService",
+  "params": {
+    "context": "cxt-d03fdd81",
+    "address": "09:09:09:09:09:09",
+    "uuid": "12345678-1234-5678-9abc-def123456789",
+    "type": "remove"
+  }
+}
+</pre>
+</div>
+
 ### Events ### {#bidi-events}
 
 #### The bluetooth.requestDevicePromptUpdated Event #### {#bluetooth-requestdevicepromptupdated-event}