Add Bluetooth device emulation support

index.bs

@@ -4938,6 +4938,19 @@ To <dfn>serialize prompt devices</dfn> given [=device prompt=] |prompt|:
 
 </div>
 
+#### The bluetooth.ScanRecord Type #### {#bluetooth-scanrecord-type}
+
+<pre highlight="cddl" class="cddl remote-cddl local-cddl">
+bluetooth.ScanRecord = {
+  optional name: text,
+  optional uuids: BluetoothServiceUuid[],
+  optional appearance: integer,
+  optional manufacturerData: BluetoothManufacturerDataMap,
+}
+</pre>
+
+A bluetooth.ScanRecord represents data of the advertisement packet sent by a Bluetooth device.
+
 ### Errors ### {#bidi-errors}
 
 This specification extends the set of [=error codes=] from
@@ -5013,6 +5026,130 @@ A [=local end=] could dismiss a prompt by sending the following message:
 </pre>
 </div>
 
+#### The bluetooth.simulateCentral Command #### {#bluetooth-simulatecentral-command}
+
+<pre highlight="cddl" class="cddl remote-cddl local-cddl">
+bluetooth.simulateCentral = (
+   method: "bluetooth.simulateCentral",
+   params: bluetooth.SimulateCentralParameters,
+)
+
+bluetooth.SimulateCentralParameters = {
+   state: "absent" / "powered-off" / "powered-on"
+}
+</pre>
+
+<div algorithm="remote end steps for bluetooth.simulateCentral">
+The [=remote end steps=] with command parameters |params| are:
+
+1. Let |state| be |params|[`"state"`].
+1. Return [=success=] with data `null`.
+
+</div>
+
+<div class="example">
+A [=local end=] could simulate a central by sending the following message:
+
+<pre highlight="json">
+{
+  "method": "bluetooth.simulateCentral",
+  "state": "powered-on"
+}
+</pre>
+</div>
+
+#### The bluetooth.simulatePreconnectedPeripheral Command #### {#bluetooth-simulateconnectedperipheral-command}
+
+<pre highlight="cddl" class="cddl remote-cddl local-cddl">
+bluetooth.simulatePreconnectedPeripheral = (
+   method: "bluetooth.simulatePreconnectedPeripheral",
+   params: bluetooth.SimulatePreconnectedPeripheralParameters,
+)
+
+bluetooth.SimulatePreconnectedPeripheralParameters = {
+   address: string,
+   name: string,
+   manufacturerData: BluetoothManufacturerDataMap,
+   knownServiceUuids: string[]
+}
+</pre>
+
+<div algorithm="remote end steps for bluetooth.simulatePreconnectedPeripheral">
+The [=remote end steps=] with command parameters |params| are:
+
+1. Let |address| be |params|[`"address"`].
+1. Let |name| be |params|[`"name"`].
+1. Let |manufacturerData| be |params|[`"manufacturerData"`].
+1. Let |knownServiceUuids| be |params|[`"knownServiceUuids"`].
+1. Return [=success=] with data `null`.
+
+</div>
+
+<div class="example">
+A [=local end=] could simulate a preconnected peripheral by sending the following message:
+
+<pre highlight="json">
+{
+  "method": "bluetooth.simulatePreconnectedPeripheral",
+  "address": "09:09:09:09:09:09",
+  "name": "Some Device",
+  "manufacturerData": { "companyIdentifier": 17 },
+  "knownServiceUuids": [
+     "12345678-1234-5678-9abc-def123456789",
+  ]
+}
+</pre>
+</div>
+
+#### The bluetooth.simulateAdvertisement Command #### {#bluetooth-simulateadvertisement-command}
+
+<pre highlight="cddl" class="cddl remote-cddl local-cddl">
+bluetooth.simulateAdvertisement = (
+   method: "bluetooth.simulateAdvertisement",
+   params: bluetooth.SimulateAdvertisementParameters,
+)
+
+bluetooth.SimulateAdvertisementParameters = {
+   entry: bluetooth.SimulateAdvertisementScanEntryParameters[]
+}
+
+bluetooth.SimulateAdvertisementScanEntryParameters = {
+   deviceAddress: string,
+   rssi: integer,
+   scanRecord: bluetooth.ScanRecord
+}
+
+</pre>
+
+<div algorithm="remote end steps for bluetooth.simulateAdvertisement">
+The [=remote end steps=] with command parameters |params| are:
+
+1. Let |entry| be |params|[`"entry"`].
+1. Return [=success=] with data `null`.
+
+</div>
+
+<div class="example">
+A [=local end=] could simulate a device advertisement by sending the following message:
+
+<pre highlight="json">
+{
+  "method": "bluetooth.simulateAdvertisement",
+  "entry": {
+    "deviceAddress": "08:08:08:08:08:08",
+    "rssi": -10,
+    "scanRecord": {
+      "name": "Heart Rate",
+      "uuids": ["0000180d-0000-1000-8000-00805f9b34fb"],
+      "manufacturerData": { "companyIdentifier": 17 },
+      "appearance": 1,
+      "txPower": 1
+    }
+  }
+}
+</pre>
+</div>
+
 ### Events ### {#bidi-events}
 
 #### The bluetooth.requestDevicePromptUpdated Event #### {#bluetooth-requestdevicepromptupdated-event}