[fidldoc] Updating fidldocs
diff --git a/all/fidl/README.md b/all/fidl/README.md
index c19b095..3056a63 100644
--- a/all/fidl/README.md
+++ b/all/fidl/README.md
@@ -500,6 +500,10 @@
<td></td>
</tr>
<tr>
+ <td><a href="fuchsia.examples.inspect/index">fuchsia.examples.inspect</a></td>
+ <td></td>
+</tr>
+<tr>
<td><a href="fuchsia.examples.intl.manager/index">fuchsia.examples.intl.manager</a></td>
<td></td>
</tr>
@@ -580,6 +584,10 @@
<td></td>
</tr>
<tr>
+ <td><a href="fuchsia.hardware.cpu.ctrl/index">fuchsia.hardware.cpu.ctrl</a></td>
+ <td></td>
+</tr>
+<tr>
<td><a href="fuchsia.hardware.cpu.insntrace/index">fuchsia.hardware.cpu.insntrace</a></td>
<td></td>
</tr>
@@ -1009,6 +1017,10 @@
<td></td>
</tr>
<tr>
+ <td><a href="fuchsia.session.examples/index">fuchsia.session.examples</a></td>
+ <td></td>
+</tr>
+<tr>
<td><a href="fuchsia.settings/index">fuchsia.settings</a></td>
<td></td>
</tr>
diff --git a/all/fidl/_toc.yaml b/all/fidl/_toc.yaml
index 792815a..af3d882 100644
--- a/all/fidl/_toc.yaml
+++ b/all/fidl/_toc.yaml
@@ -247,6 +247,8 @@
path: /reference/fidl/fuchsia.examples
- title: fuchsia.examples.hello
path: /reference/fidl/fuchsia.examples.hello
+- title: fuchsia.examples.inspect
+ path: /reference/fidl/fuchsia.examples.inspect
- title: fuchsia.examples.intl.manager
path: /reference/fidl/fuchsia.examples.intl.manager
- title: fuchsia.examples.intl.wisdom
@@ -287,6 +289,8 @@
path: /reference/fidl/fuchsia.hardware.bluetooth
- title: fuchsia.hardware.camera
path: /reference/fidl/fuchsia.hardware.camera
+- title: fuchsia.hardware.cpu.ctrl
+ path: /reference/fidl/fuchsia.hardware.cpu.ctrl
- title: fuchsia.hardware.cpu.insntrace
path: /reference/fidl/fuchsia.hardware.cpu.insntrace
- title: fuchsia.hardware.display
@@ -495,6 +499,8 @@
path: /reference/fidl/fuchsia.services.examples
- title: fuchsia.session
path: /reference/fidl/fuchsia.session
+- title: fuchsia.session.examples
+ path: /reference/fidl/fuchsia.session.examples
- title: fuchsia.settings
path: /reference/fidl/fuchsia.settings
- title: fuchsia.setui
diff --git a/all/fidl/fuchsia.developer.remotecontrol/README.md b/all/fidl/fuchsia.developer.remotecontrol/README.md
index 99530f8..d9017f0 100644
--- a/all/fidl/fuchsia.developer.remotecontrol/README.md
+++ b/all/fidl/fuchsia.developer.remotecontrol/README.md
@@ -73,7 +73,7 @@
<td>1</td>
<td><code>exit_code</code></td>
<td>
- <code>uint32</code>
+ <code>int64</code>
</td>
<td></td>
</tr><tr>
diff --git a/all/fidl/fuchsia.examples.inspect/README.md b/all/fidl/fuchsia.examples.inspect/README.md
new file mode 100644
index 0000000..f129a6f
--- /dev/null
+++ b/all/fidl/fuchsia.examples.inspect/README.md
@@ -0,0 +1,79 @@
+[TOC]
+
+# fuchsia.examples.inspect
+
+
+## **PROTOCOLS**
+
+## FizzBuzz {#FizzBuzz}
+*Defined in [fuchsia.examples.inspect/fizzbuzz.test.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/src/diagnostics/examples/inspect/fidl/fizzbuzz.test.fidl#9)*
+
+
+### Execute {#Execute}
+
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>count</code></td>
+ <td>
+ <code>uint32</code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>response</code></td>
+ <td>
+ <code>string[1024]</code>
+ </td>
+ </tr></table>
+
+## Reverser {#Reverser}
+*Defined in [fuchsia.examples.inspect/reverser.test.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/src/diagnostics/examples/inspect/fidl/reverser.test.fidl#9)*
+
+
+### Reverse {#Reverse}
+
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>input</code></td>
+ <td>
+ <code>string[1024]</code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>response</code></td>
+ <td>
+ <code>string[1024]</code>
+ </td>
+ </tr></table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/all/fidl/fuchsia.factory.camera/README.md b/all/fidl/fuchsia.factory.camera/README.md
index 7e0150d..5a3febb 100644
--- a/all/fidl/fuchsia.factory.camera/README.md
+++ b/all/fidl/fuchsia.factory.camera/README.md
@@ -18,9 +18,9 @@
it. If the device has multiple cameras, the first one listed is chosen.</p>
<ul>
<li>response <code>camera_id</code> Identifies the camera. This should not change throughout
-the lifetime of the camera. Is null if no camera exists.</li>
+the lifetime of the camera.</li>
<li>response <code>camera_info</code> A table providing identifying information about the
-camera. Is null if no camera exists.</li>
+camera.</li>
</ul>
<ul>
<li>error A value indicating whether there is a camera.</li>
@@ -70,7 +70,7 @@
<ul>
<li>request <code>mode</code> One of the camera's predefined sensor modes (fpms, resolution,
etc).</li>
-<li>request <code>exposure</code> The camera's sensor exposure parameter.</li>
+<li>request <code>integration_time</code> The camera's sensor integration time parameter.</li>
<li>request <code>analog_gain</code> The camera's sensor analog gain parameter.</li>
<li>request <code>digital_gain</code> The camera's sensor digital gain parameter.</li>
</ul>
@@ -90,9 +90,9 @@
<code>uint32</code>
</td>
</tr><tr>
- <td><code>exposure</code></td>
+ <td><code>integration_time</code></td>
<td>
- <code>uint32</code>
+ <code>int32</code>
</td>
</tr><tr>
<td><code>analog_gain</code></td>
diff --git a/all/fidl/fuchsia.hardware.cpu.ctrl/README.md b/all/fidl/fuchsia.hardware.cpu.ctrl/README.md
new file mode 100644
index 0000000..a85e1c4
--- /dev/null
+++ b/all/fidl/fuchsia.hardware.cpu.ctrl/README.md
@@ -0,0 +1,194 @@
+[TOC]
+
+# fuchsia.hardware.cpu.ctrl
+
+
+## **PROTOCOLS**
+
+## Device {#Device}
+*Defined in [fuchsia.hardware.cpu.ctrl/ctrl.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-cpu-ctrl/ctrl.fidl#24)*
+
+
+### GetPerformanceStateInfo {#GetPerformanceStateInfo}
+
+<p>Returns information about a given performance state for this performance
+domain.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>state</code></td>
+ <td>
+ <code>uint32</code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>result</code></td>
+ <td>
+ <code><a class='link' href='#Device_GetPerformanceStateInfo_Result'>Device_GetPerformanceStateInfo_Result</a></code>
+ </td>
+ </tr></table>
+
+### GetNumLogicalCores {#GetNumLogicalCores}
+
+<p>Returns the number of logical cores contained within this performance
+domain.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ </table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>count</code></td>
+ <td>
+ <code>uint64</code>
+ </td>
+ </tr></table>
+
+### GetLogicalCoreId {#GetLogicalCoreId}
+
+<p>Returns a global system-wide core ID for the nth core in this
+performance domain. <code>index</code> must be a value in the range [0, n) where
+n is the value returned by GetNumLogicalCores().</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>index</code></td>
+ <td>
+ <code>uint64</code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>id</code></td>
+ <td>
+ <code>uint64</code>
+ </td>
+ </tr></table>
+
+
+
+## **STRUCTS**
+
+### Device_GetPerformanceStateInfo_Response {#Device_GetPerformanceStateInfo_Response}
+*generated*
+
+
+
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr><tr>
+ <td><code>info</code></td>
+ <td>
+ <code><a class='link' href='#CpuPerformanceStateInfo'>CpuPerformanceStateInfo</a></code>
+ </td>
+ <td></td>
+ <td>No default</td>
+ </tr>
+</table>
+
+### CpuPerformanceStateInfo {#CpuPerformanceStateInfo}
+*Defined in [fuchsia.hardware.cpu.ctrl/ctrl.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-cpu-ctrl/ctrl.fidl#16)*
+
+
+
+<p>A collection of some basic information for a given performance state.</p>
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr><tr>
+ <td><code>frequency_hz</code></td>
+ <td>
+ <code>int64</code>
+ </td>
+ <td><p>Frequency the core is operating at in hertz.</p>
+</td>
+ <td>No default</td>
+ </tr><tr>
+ <td><code>voltage_uv</code></td>
+ <td>
+ <code>int64</code>
+ </td>
+ <td></td>
+ <td>No default</td>
+ </tr>
+</table>
+
+
+
+
+
+
+
+## **UNIONS**
+
+### Device_GetPerformanceStateInfo_Result {#Device_GetPerformanceStateInfo_Result}
+*generated*
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th></tr><tr>
+ <td><code>response</code></td>
+ <td>
+ <code><a class='link' href='#Device_GetPerformanceStateInfo_Response'>Device_GetPerformanceStateInfo_Response</a></code>
+ </td>
+ <td></td>
+ </tr><tr>
+ <td><code>err</code></td>
+ <td>
+ <code><a class='link' href='../zx/'>zx</a>/<a class='link' href='../zx/#status'>status</a></code>
+ </td>
+ <td></td>
+ </tr></table>
+
+
+
+
+
+
+
+## **CONSTANTS**
+
+<table>
+ <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr id="FREQUENCY_UNKNOWN">
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-cpu-ctrl/ctrl.fidl#12">FREQUENCY_UNKNOWN</a></td>
+ <td>
+ <code>-1</code>
+ </td>
+ <td><code>int64</code></td>
+ <td><p>CpuPerformanceStateInfo::frequency_hz and CpuPerformanceStateInfo::voltage_uv
+are set to this if the frequency and voltage for the given performance state
+are unknown respectively.</p>
+</td>
+ </tr>
+ <tr id="VOLTAGE_UNKNOWN">
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-cpu-ctrl/ctrl.fidl#13">VOLTAGE_UNKNOWN</a></td>
+ <td>
+ <code>-1</code>
+ </td>
+ <td><code>int64</code></td>
+ <td></td>
+ </tr>
+
+</table>
+
+
+
diff --git a/all/fidl/fuchsia.input.report/README.md b/all/fidl/fuchsia.input.report/README.md
index bfec3ec..aae69fd 100644
--- a/all/fidl/fuchsia.input.report/README.md
+++ b/all/fidl/fuchsia.input.report/README.md
@@ -83,6 +83,32 @@
</td>
</tr></table>
+### SendOutputReport {#SendOutputReport}
+
+<p>Send a single output report to the device. This will throw an error
+if the output report does not follow the OutputDescriptor.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>report</code></td>
+ <td>
+ <code><a class='link' href='#OutputReport'>OutputReport</a></code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>result</code></td>
+ <td>
+ <code><a class='link' href='#InputDevice_SendOutputReport_Result'>InputDevice_SendOutputReport_Result</a></code>
+ </td>
+ </tr></table>
+
## **STRUCTS**
@@ -132,6 +158,17 @@
</tr>
</table>
+### InputDevice_SendOutputReport_Response {#InputDevice_SendOutputReport_Response}
+*generated*
+
+
+
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr>
+</table>
+
### SensorAxis {#SensorAxis}
*Defined in [fuchsia.input.report/sensor.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/sensor.fidl#44)*
@@ -215,6 +252,52 @@
## **ENUMS**
+### LedType {#LedType}
+Type: <code>uint32</code>
+
+*Defined in [fuchsia.input.report/led.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/led.fidl#11)*
+
+<p>An LedType represents an LED on a device that can be turned on or off.
+When applicable, the definition of each LED is derived from one of the
+following sources albeit with a Fuchsia-specific numeric value:</p>
+<ul>
+<li>USB HID usage codes for usage page 0x0008 (LED)</li>
+</ul>
+
+
+<table>
+ <tr><th>Name</th><th>Value</th><th>Description</th></tr><tr>
+ <td><code>NUM_LOCK</code></td>
+ <td><code>1</code></td>
+ <td><p>LED to indicate a Keyboard's number lock is enabled.
+Corresponds to USB HID page 0x0008 usage 0x0001</p>
+</td>
+ </tr><tr>
+ <td><code>CAPS_LOCK</code></td>
+ <td><code>2</code></td>
+ <td><p>LED to indicate a Keyboard's capital lock is enabled.
+Corresponds to USB HID page 0x0008 usage 0x0002</p>
+</td>
+ </tr><tr>
+ <td><code>SCROLL_LOCK</code></td>
+ <td><code>3</code></td>
+ <td><p>LED to indicate a Keyboard's scroll lock is enabled.
+Corresponds to USB HID page 0x0008 usage 0x0003</p>
+</td>
+ </tr><tr>
+ <td><code>COMPOSE</code></td>
+ <td><code>4</code></td>
+ <td><p>LED to indicate a Keyboard's composition mode is enabled.
+Corresponds to USB HID page 0x0008 usage 0x0004</p>
+</td>
+ </tr><tr>
+ <td><code>KANA</code></td>
+ <td><code>5</code></td>
+ <td><p>LED to indicate a Keyboard's Kana mode is enabled.
+Corresponds to USB HID page 0x0008 usage 0x0005</p>
+</td>
+ </tr></table>
+
### SensorType {#SensorType}
Type: <code>uint32</code>
@@ -440,10 +523,31 @@
</td>
</tr></table>
+### OutputDescriptor {#OutputDescriptor}
+
+
+*Defined in [fuchsia.input.report/descriptor.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/descriptor.fidl#46)*
+
+<p>Describes the output reports that a physical input device will accept.
+Output information typically represents device output to the user
+(E.g: LEDs, tactile feedback, etc).</p>
+
+
+<table>
+ <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+ <tr>
+ <td>1</td>
+ <td><code>keyboard</code></td>
+ <td>
+ <code><a class='link' href='#KeyboardOutputDescriptor'>KeyboardOutputDescriptor</a></code>
+ </td>
+ <td></td>
+ </tr></table>
+
### KeyboardInputDescriptor {#KeyboardInputDescriptor}
-*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#20)*
+*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#17)*
<p>Describes the format of the input report that will be sent from the keyboard
to the device.</p>
@@ -461,10 +565,30 @@
</td>
</tr></table>
+### KeyboardOutputDescriptor {#KeyboardOutputDescriptor}
+
+
+*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#23)*
+
+<p>Describes the format of the output report that can be sent to the keyboard..</p>
+
+
+<table>
+ <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+ <tr>
+ <td>1</td>
+ <td><code>leds</code></td>
+ <td>
+ <code>vector<<a class='link' href='#LedType'>LedType</a>>[10]</code>
+ </td>
+ <td><p>The list of keyboard LEDs that can be toggled.</p>
+</td>
+ </tr></table>
+
### KeyboardDescriptor {#KeyboardDescriptor}
-*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#26)*
+*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#29)*
<p>The capabilities of a keyboard device.</p>
@@ -478,12 +602,19 @@
<code><a class='link' href='#KeyboardInputDescriptor'>KeyboardInputDescriptor</a></code>
</td>
<td></td>
+ </tr><tr>
+ <td>2</td>
+ <td><code>output</code></td>
+ <td>
+ <code><a class='link' href='#KeyboardOutputDescriptor'>KeyboardOutputDescriptor</a></code>
+ </td>
+ <td></td>
</tr></table>
### KeyboardInputReport {#KeyboardInputReport}
-*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#31)*
+*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#35)*
<p>A single report created by a keyboard device.</p>
@@ -500,6 +631,27 @@
</td>
</tr></table>
+### KeyboardOutputReport {#KeyboardOutputReport}
+
+
+*Defined in [fuchsia.input.report/keyboard.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#41)*
+
+<p>A single report containing output information for a keyboard.</p>
+
+
+<table>
+ <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+ <tr>
+ <td>1</td>
+ <td><code>enabled_leds</code></td>
+ <td>
+ <code>vector<<a class='link' href='#LedType'>LedType</a>>[10]</code>
+ </td>
+ <td><p>Each LED in this list will be turned on. Any LED not in this list will be
+turned off.</p>
+</td>
+ </tr></table>
+
### MouseInputDescriptor {#MouseInputDescriptor}
@@ -687,6 +839,27 @@
</td>
</tr></table>
+### OutputReport {#OutputReport}
+
+
+*Defined in [fuchsia.input.report/report.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/report.fidl#29)*
+
+<p>A single report containing output information for an input device.
+Output information typically represents device output to the user
+(E.g: LEDs, tactile feedback, etc).</p>
+
+
+<table>
+ <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+ <tr>
+ <td>1</td>
+ <td><code>keyboard</code></td>
+ <td>
+ <code><a class='link' href='#KeyboardOutputReport'>KeyboardOutputReport</a></code>
+ </td>
+ <td></td>
+ </tr></table>
+
### SensorInputDescriptor {#SensorInputDescriptor}
@@ -945,6 +1118,27 @@
+## **UNIONS**
+
+### InputDevice_SendOutputReport_Result {#InputDevice_SendOutputReport_Result}
+*generated*
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th></tr><tr>
+ <td><code>response</code></td>
+ <td>
+ <code><a class='link' href='#InputDevice_SendOutputReport_Response'>InputDevice_SendOutputReport_Response</a></code>
+ </td>
+ <td></td>
+ </tr><tr>
+ <td><code>err</code></td>
+ <td>
+ <code><a class='link' href='../zx/'>zx</a>/<a class='link' href='../zx/#status'>status</a></code>
+ </td>
+ <td></td>
+ </tr></table>
+
@@ -976,20 +1170,25 @@
<code>150</code>
</td>
<td><code>uint32</code></td>
- <td><p>A hardcoded number of max keys. This should be increased in the future
-if we ever see keyboards with more keys.</p>
+ <td><p>Hardcoded max sizes for keyboard vectors. These sizes should be increased
+if we ever see keyboards with more objects than can be represented.</p>
</td>
</tr>
+ <tr id="KEYBOARD_MAX_NUM_LEDS">
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#12">KEYBOARD_MAX_NUM_LEDS</a></td>
+ <td>
+ <code>10</code>
+ </td>
+ <td><code>uint32</code></td>
+ <td></td>
+ </tr>
<tr id="KEYBOARD_MAX_PRESSED_KEYS">
- <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#16">KEYBOARD_MAX_PRESSED_KEYS</a></td>
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/keyboard.fidl#13">KEYBOARD_MAX_PRESSED_KEYS</a></td>
<td>
<code>15</code>
</td>
<td><code>uint32</code></td>
- <td><p>A hardcoded number of the maximum keys that can be pressed at a time.
-This should be increased in the future if we see keyboards that can
-handle more pressed keys.</p>
-</td>
+ <td></td>
</tr>
<tr id="MOUSE_MAX_NUM_BUTTONS">
<td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.input.report/mouse.fidl#9">MOUSE_MAX_NUM_BUTTONS</a></td>
diff --git a/all/fidl/fuchsia.io2/README.md b/all/fidl/fuchsia.io2/README.md
index 4e73a5e..5c08d50 100644
--- a/all/fidl/fuchsia.io2/README.md
+++ b/all/fidl/fuchsia.io2/README.md
@@ -658,6 +658,11 @@
<table>
<tr><th>Name</th><th>Type</th></tr>
<tr>
+ <td><code>options</code></td>
+ <td>
+ <code><a class='link' href='#DirectoryEnumerateOptions'>DirectoryEnumerateOptions</a></code>
+ </td>
+ </tr><tr>
<td><code>iterator</code></td>
<td>
<code>request<<a class='link' href='#DirectoryIterator'>DirectoryIterator</a>></code>
@@ -2264,7 +2269,7 @@
### OpenMode {#OpenMode}
Type: <code>uint32</code>
-*Defined in [fuchsia.io2/directory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory.fidl#131)*
+*Defined in [fuchsia.io2/directory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory.fidl#132)*
<p>Options related to node creation during <a class='link' href='#Directory.Open'>Directory.Open</a>.</p>
@@ -2526,7 +2531,7 @@
<td>1</td>
<td><code>event</code></td>
<td>
- <code>handle<event></code>
+ <code>handle<eventpair></code>
</td>
<td><p>An optional event which transmits information about a device's state.</p>
<p>The <a class='link' href='#DeviceSignal'>DeviceSignal</a> values may be observed on this event.</p>
@@ -2547,7 +2552,7 @@
<td>1</td>
<td><code>event</code></td>
<td>
- <code>handle<event></code>
+ <code>handle<eventpair></code>
</td>
<td><p>An optional event which transmits information about a device's state.</p>
<p>The <a class='link' href='#DeviceSignal'>DeviceSignal</a> values may be observed on this event.</p>
@@ -2557,8 +2562,11 @@
### DirectoryEntry {#DirectoryEntry}
-*Defined in [fuchsia.io2/directory-entry.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory-entry.fidl#7)*
+*Defined in [fuchsia.io2/directory-entry.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory-entry.fidl#11)*
+<p>Information about an immediate child node of a directory.</p>
+<p>If a particular attribute is not applicable or not supported,
+implementations should leave the corresponding field absent.</p>
<table>
@@ -2569,7 +2577,7 @@
<td>
<code><a class='link' href='#Name'>Name</a></code>
</td>
- <td><p>Name of the entry.</p>
+ <td><p>Name of the node. This field must be present.</p>
</td>
</tr><tr>
<td>2</td>
@@ -2577,7 +2585,7 @@
<td>
<code><a class='link' href='#NodeProtocolSet'>NodeProtocolSet</a></code>
</td>
- <td><p>Describes the kinds of representations supported by the entry.</p>
+ <td><p>Describes the kinds of representations supported by the node.</p>
</td>
</tr><tr>
<td>3</td>
@@ -2585,10 +2593,31 @@
<td>
<code><a class='link' href='#Abilities'>Abilities</a></code>
</td>
- <td><p>Describes the kinds of operations supported by the entry.</p>
+ <td><p>Describes the kinds of operations supported by the node.</p>
+</td>
+ </tr><tr>
+ <td>4</td>
+ <td><code>id</code></td>
+ <td>
+ <code><a class='link' href='#Id'>Id</a></code>
+ </td>
+ <td><p>An ID for the node. See <a class='link' href='#Id'>Id</a>.
+This <code>id</code> should be unique among all entries of a directory.</p>
</td>
</tr></table>
+### DirectoryEnumerateOptions {#DirectoryEnumerateOptions}
+
+
+*Defined in [fuchsia.io2/directory-iterator.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory-iterator.fidl#33)*
+
+<p>Options to pass to <a class='link' href='#Directory.Enumerate'>Directory.Enumerate</a>.</p>
+
+
+<table>
+ <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+ </table>
+
### DirectoryWatchOptions {#DirectoryWatchOptions}
@@ -2603,7 +2632,7 @@
### DirectoryInfo {#DirectoryInfo}
-*Defined in [fuchsia.io2/directory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory.fidl#154)*
+*Defined in [fuchsia.io2/directory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory.fidl#155)*
<p>Auxiliary data for the directory representation of a node.
The selection of this variant in <a class='link' href='#Representation'>Representation</a> implies that the
@@ -2767,6 +2796,16 @@
</td>
<td><p>Time of last modification in nanoseconds since the Unix epoch, UTC.</p>
</td>
+ </tr><tr>
+ <td>8</td>
+ <td><code>id</code></td>
+ <td>
+ <code><a class='link' href='#Id'>Id</a></code>
+ </td>
+ <td><p>An ID for the node. See <a class='link' href='#Id'>Id</a>.
+This <code>id</code> should be unique among all entries of a directory.</p>
+<p>This attribute is read-only.</p>
+</td>
</tr></table>
### PipeInfo {#PipeInfo}
@@ -3514,6 +3553,11 @@
<td>64</td>
<td><p>Requests <a class='link' href='#NodeAttributes.modification_time'>NodeAttributes.modification_time</a>.</p>
</td>
+ </tr><tr>
+ <td>ID</td>
+ <td>128</td>
+ <td><p>Requests <a class='link' href='#NodeAttributes.id'>NodeAttributes.id</a>.</p>
+</td>
</tr></table>
### Operations {#Operations}
@@ -3585,7 +3629,7 @@
<table>
<tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr id="MAX_DIRECTORY_BATCH_SIZE">
- <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory-entry.fidl#20">MAX_DIRECTORY_BATCH_SIZE</a></td>
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/directory-iterator.fidl#30">MAX_DIRECTORY_BATCH_SIZE</a></td>
<td>
<code>8192</code>
</td>
@@ -3679,6 +3723,25 @@
<td><p>The type to identify a connection to a node.
It represents a capability: a reference to a node with associated rights.</p>
</td>
+ </tr><tr id="Id">
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/io2.fidl#69">Id</a></td>
+ <td>
+ <code>uint64</code></td>
+ <td><p>The type to identify a node, if the implementation supports some notion of
+unique node ID.</p>
+<h2>Uniqueness Guarantees</h2>
+<p>A client is usually presented with a directory tree that is the result
+of composing together multiple backing implementation instances. An ID
+would be unique within the corresponding instance only.
+Their boundaries are rather implicit on Fuchsia, as a result of
+transparently-forwarding directory proxies. It could be common for a client
+to observe identical <code>Id</code>s when traversing a directory tree, when it
+encounters nodes from different backing instances. Therefore, the ID is best
+used for debugging and informational purposes.</p>
+<p>If the implementation also supports <a class='link' href='../fuchsia.fs/'>fuchsia.fs</a>/<a class='link' href='../fuchsia.fs/#Query'>Query</a>, the
+<a class='link' href='../fuchsia.fs/'>fuchsia.fs</a>/<a class='link' href='../fuchsia.fs/#FilesystemInfo.fs_id'>FilesystemInfo.fs_id</a> field may be used to disambiguate IDs
+from different backing instances.</p>
+</td>
</tr><tr id="Rights">
<td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io2/rights-abilities.fidl#74">Rights</a></td>
<td>
diff --git a/all/fidl/fuchsia.mediacodec/README.md b/all/fidl/fuchsia.mediacodec/README.md
index 7d8b544..c942a93 100644
--- a/all/fidl/fuchsia.mediacodec/README.md
+++ b/all/fidl/fuchsia.mediacodec/README.md
@@ -6,7 +6,7 @@
## **PROTOCOLS**
## CodecFactory {#CodecFactory}
-*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#255)*
+*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#258)*
### OnCodecList {#OnCodecList}
@@ -69,7 +69,7 @@
## **STRUCTS**
### CodecDescription {#CodecDescription}
-*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#220)*
+*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#223)*
@@ -165,7 +165,7 @@
### CodecType {#CodecType}
Type: <code>uint32</code>
-*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#215)*
+*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#218)*
@@ -205,7 +205,10 @@
video/vp9
audio/aac
input_details.oob_bytes must be an AudioSpecificConfig() as defined
-by AAC spec.</p>
+by AAC spec.
+audio/sbc
+input_details.oob_bytes must be Codec Specific Information Elements
+for SBC as defined by the A2DP spec.</p>
</td>
</tr><tr>
<td>2</td>
@@ -375,7 +378,7 @@
### CreateEncoder_Params {#CreateEncoder_Params}
-*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#201)*
+*Defined in [fuchsia.mediacodec/codec_factory.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.mediacodec/codec_factory.fidl#204)*
<p>Parameters used to request an encoder.</p>
diff --git a/all/fidl/fuchsia.session.examples/README.md b/all/fidl/fuchsia.session.examples/README.md
new file mode 100644
index 0000000..b2f2b66
--- /dev/null
+++ b/all/fidl/fuchsia.session.examples/README.md
@@ -0,0 +1,40 @@
+[TOC]
+
+# fuchsia.session.examples
+
+
+## **PROTOCOLS**
+
+## ElementPing {#ElementPing}
+*Defined in [fuchsia.session.examples/element_ping.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/src/session/fidl/element_ping.fidl#10)*
+
+<p>A protocol which is used by an example element to ping the session it was
+added to.</p>
+
+### Ping {#Ping}
+
+<p>Sends a ping to the example session.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ </table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/all/fidl/fuchsia.settings/README.md b/all/fidl/fuchsia.settings/README.md
index 8afbc37..bec07d8 100644
--- a/all/fidl/fuchsia.settings/README.md
+++ b/all/fidl/fuchsia.settings/README.md
@@ -333,6 +333,66 @@
</td>
</tr></table>
+## NightMode {#NightMode}
+*Defined in [fuchsia.settings/night_mode.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/night_mode.fidl#15)*
+
+<p>Modify or watch Night Mode setting. Night mode puts the device in a
+restricted mode which can be overrided if the user prefers. During night
+mode, the following settings apply as per night mode parameters:</p>
+<ol>
+<li>DoNotDisturb is enabled/not.</li>
+<li>System volume is set to an override maximum.</li>
+<li>LED Brightness is set to an overridable maximum.</li>
+<li>Sleep mode is enabled/not.</li>
+</ol>
+
+### Watch {#Watch}
+
+<p>Gets the current <a class='link' href='#NightModeSettings'>NightModeSettings</a>. Returns immediately on first
+call; subsequent calls return when the values change.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ </table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>settings</code></td>
+ <td>
+ <code><a class='link' href='#NightModeSettings'>NightModeSettings</a></code>
+ </td>
+ </tr></table>
+
+### Set {#Set}
+
+<p>Sets <a class='link' href='#NightModeSettings'>NightModeSettings</a> settings. Any field not explicitly set in
+the table performs a no-op, and will not make any changes.</p>
+
+#### Request
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>settings</code></td>
+ <td>
+ <code><a class='link' href='#NightModeSettings'>NightModeSettings</a></code>
+ </td>
+ </tr></table>
+
+
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ <tr>
+ <td><code>result</code></td>
+ <td>
+ <code><a class='link' href='#NightMode_Set_Result'>NightMode_Set_Result</a></code>
+ </td>
+ </tr></table>
+
## Privacy {#Privacy}
*Defined in [fuchsia.settings/privacy.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/privacy.fidl#8)*
@@ -641,6 +701,17 @@
<tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr>
</table>
+### NightMode_Set_Response {#NightMode_Set_Response}
+*generated*
+
+
+
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr>
+</table>
+
### Privacy_Watch_Response {#Privacy_Watch_Response}
*generated*
@@ -1190,8 +1261,15 @@
### DisplaySettings {#DisplaySettings}
-*Defined in [fuchsia.settings/display.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/display.fidl#26)*
+*Defined in [fuchsia.settings/display.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/display.fidl#33)*
+<p>DisplaySettings are used to determine the output state of the display.
+The display can be toggled between two modes, auto-brightness on and
+auto-brightness off. When auto-brightness is on a manual offset to the
+total output brightness can be applied by setting <code>user_brightness_offset</code>.
+When auto-brightness is off the display brightness is set manually by
+setting brightness_value. All values can be set at any time to persist
+settings for either mode.</p>
<table>
@@ -1202,20 +1280,30 @@
<td>
<code>bool</code>
</td>
- <td></td>
+ <td><p>Auto brightness enabled</p>
+</td>
</tr><tr>
<td>2</td>
<td><code>brightness_value</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Manually set brightness value [0.0 - 1.0]</p>
+</td>
+ </tr><tr>
+ <td>3</td>
+ <td><code>user_brightness_offset</code></td>
+ <td>
+ <code>float32</code>
+ </td>
+ <td><p>User defined offset to the total auto brightness output [-1.0 - 1.0]</p>
+</td>
</tr></table>
### LightSensorData {#LightSensorData}
-*Defined in [fuchsia.settings/display.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/display.fidl#31)*
+*Defined in [fuchsia.settings/display.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/display.fidl#42)*
@@ -1316,6 +1404,26 @@
</td>
</tr></table>
+### NightModeSettings {#NightModeSettings}
+
+
+*Defined in [fuchsia.settings/night_mode.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/night_mode.fidl#26)*
+
+<p>Settings related to Night mode.</p>
+
+
+<table>
+ <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+ <tr>
+ <td>1</td>
+ <td><code>night_mode_status</code></td>
+ <td>
+ <code>bool</code>
+ </td>
+ <td><p>If true, the device is in Night mode.</p>
+</td>
+ </tr></table>
+
### PrivacySettings {#PrivacySettings}
@@ -1570,6 +1678,25 @@
<td></td>
</tr></table>
+### NightMode_Set_Result {#NightMode_Set_Result}
+*generated*
+
+
+<table>
+ <tr><th>Name</th><th>Type</th><th>Description</th></tr><tr>
+ <td><code>response</code></td>
+ <td>
+ <code><a class='link' href='#NightMode_Set_Response'>NightMode_Set_Response</a></code>
+ </td>
+ <td></td>
+ </tr><tr>
+ <td><code>err</code></td>
+ <td>
+ <code><a class='link' href='#Error'>Error</a></code>
+ </td>
+ <td></td>
+ </tr></table>
+
### Privacy_Watch_Result {#Privacy_Watch_Result}
*generated*
diff --git a/all/fidl/fuchsia.sys2/README.md b/all/fidl/fuchsia.sys2/README.md
index ef779df..5c8fdad 100644
--- a/all/fidl/fuchsia.sys2/README.md
+++ b/all/fidl/fuchsia.sys2/README.md
@@ -1242,7 +1242,7 @@
</td>
</tr></table>
-### ExposeServiceProtocolDecl {#ExposeServiceProtocolDecl}
+### ExposeProtocolDecl {#ExposeProtocolDecl}
*Defined in [fuchsia.sys2/expose_decl.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/decls/expose_decl.fidl#49)*
@@ -1448,7 +1448,7 @@
</td>
</tr></table>
-### OfferServiceProtocolDecl {#OfferServiceProtocolDecl}
+### OfferProtocolDecl {#OfferProtocolDecl}
*Defined in [fuchsia.sys2/offer_decl.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/decls/offer_decl.fidl#51)*
@@ -1763,7 +1763,7 @@
</td>
</tr></table>
-### UseServiceProtocolDecl {#UseServiceProtocolDecl}
+### UseProtocolDecl {#UseProtocolDecl}
*Defined in [fuchsia.sys2/use_decl.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/decls/use_decl.fidl#47)*
@@ -2283,9 +2283,9 @@
</td>
<td></td>
</tr><tr>
- <td><code>service_protocol</code></td>
+ <td><code>protocol</code></td>
<td>
- <code><a class='link' href='#ExposeServiceProtocolDecl'>ExposeServiceProtocolDecl</a></code>
+ <code><a class='link' href='#ExposeProtocolDecl'>ExposeProtocolDecl</a></code>
</td>
<td></td>
</tr><tr>
@@ -2317,9 +2317,9 @@
</td>
<td></td>
</tr><tr>
- <td><code>service_protocol</code></td>
+ <td><code>protocol</code></td>
<td>
- <code><a class='link' href='#OfferServiceProtocolDecl'>OfferServiceProtocolDecl</a></code>
+ <code><a class='link' href='#OfferProtocolDecl'>OfferProtocolDecl</a></code>
</td>
<td></td>
</tr><tr>
@@ -2401,9 +2401,9 @@
</td>
<td></td>
</tr><tr>
- <td><code>service_protocol</code></td>
+ <td><code>protocol</code></td>
<td>
- <code><a class='link' href='#UseServiceProtocolDecl'>UseServiceProtocolDecl</a></code>
+ <code><a class='link' href='#UseProtocolDecl'>UseProtocolDecl</a></code>
</td>
<td></td>
</tr><tr>
diff --git a/all/fidl/fuchsia.ui.activity/README.md b/all/fidl/fuchsia.ui.activity/README.md
index 76aa453..2ec7019 100644
--- a/all/fidl/fuchsia.ui.activity/README.md
+++ b/all/fidl/fuchsia.ui.activity/README.md
@@ -91,18 +91,27 @@
</tr></table>
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ </table>
### StartOngoingActivity {#StartOngoingActivity}
<p>Reports the start of an ongoing activity such as media playback.
-Returns a unique |activity_id| which is expected to be later passed
-to EndOngoingActivity.
+|activity_id| is a unique identifier which is expected to be later
+passed to EndOngoingActivity.
|start_time| is in nanoseconds in the <code>CLOCK_MONOTONIC</code> time base.</p>
#### Request
<table>
<tr><th>Name</th><th>Type</th></tr>
<tr>
+ <td><code>activity_id</code></td>
+ <td>
+ <code><a class='link' href='#OngoingActivityId'>OngoingActivityId</a></code>
+ </td>
+ </tr><tr>
<td><code>activity</code></td>
<td>
<code><a class='link' href='#OngoingActivity'>OngoingActivity</a></code>
@@ -118,17 +127,12 @@
#### Response
<table>
<tr><th>Name</th><th>Type</th></tr>
- <tr>
- <td><code>activity_id</code></td>
- <td>
- <code><a class='link' href='#OngoingActivityId'>OngoingActivityId</a></code>
- </td>
- </tr></table>
+ </table>
### EndOngoingActivity {#EndOngoingActivity}
<p>Reports the end of an ongoing activity such as media playback.
-|activity_id| is the nonce which was returned by StartOngoingActivity.
+|activity_id| is the nonce which was passed into StartOngoingActivity.
|end_time| is in nanoseconds in the <code>CLOCK_MONOTONIC</code> time base.</p>
#### Request
@@ -147,6 +151,10 @@
</tr></table>
+#### Response
+<table>
+ <tr><th>Name</th><th>Type</th></tr>
+ </table>
@@ -154,34 +162,6 @@
## **ENUMS**
-### LidState {#LidState}
-Type: <code>uint32</code>
-
-*Defined in [fuchsia.ui.activity/activity.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.activity/activity.fidl#38)*
-
-<p>LidState is an enumeration of states that a clamshell-like device's lid may
-be in.</p>
-
-
-<table>
- <tr><th>Name</th><th>Value</th><th>Description</th></tr><tr>
- <td><code>UNKNOWN</code></td>
- <td><code>0</code></td>
- <td></td>
- </tr><tr>
- <td><code>OPEN</code></td>
- <td><code>1</code></td>
- <td></td>
- </tr><tr>
- <td><code>CLOSED</code></td>
- <td><code>2</code></td>
- <td></td>
- </tr><tr>
- <td><code>FLIPPED</code></td>
- <td><code>3</code></td>
- <td></td>
- </tr></table>
-
### State {#State}
Type: <code>uint32</code>
@@ -220,7 +200,7 @@
### GenericActivity {#GenericActivity}
-*Defined in [fuchsia.ui.activity/activity.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.activity/activity.fidl#24)*
+*Defined in [fuchsia.ui.activity/activity.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.activity/activity.fidl#21)*
<p>GenericActivity is a user or system activity of unspecified type, e.g.
a keyboard press or an alarm going off.</p>
@@ -239,26 +219,6 @@
</td>
</tr></table>
-### LidActivity {#LidActivity}
-
-
-*Defined in [fuchsia.ui.activity/activity.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.activity/activity.fidl#32)*
-
-<p>LidActivity is an event originating from a change in the state of the lid
-of a clamshell-like device.</p>
-
-
-<table>
- <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
- <tr>
- <td>1</td>
- <td><code>state</code></td>
- <td>
- <code><a class='link' href='#LidState'>LidState</a></code>
- </td>
- <td></td>
- </tr></table>
-
@@ -278,18 +238,10 @@
</td>
<td><p>Activities that require no special handling.</p>
</td>
- </tr><tr>
- <td><code>lid</code></td>
- <td>
- <code><a class='link' href='#LidActivity'>LidActivity</a></code>
- </td>
- <td><p>An activity originating from opening or closing the lid of a
-clamshell-format device.</p>
-</td>
</tr></table>
### OngoingActivity {#OngoingActivity}
-*Defined in [fuchsia.ui.activity/activity.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.activity/activity.fidl#17)*
+*Defined in [fuchsia.ui.activity/activity.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.activity/activity.fidl#14)*
<p>OngoingActivity is an activity which has a definite start and end time.</p>
diff --git a/all/fidl/fuchsia.ui.brightness/README.md b/all/fidl/fuchsia.ui.brightness/README.md
index dae6b46..e1a986c 100644
--- a/all/fidl/fuchsia.ui.brightness/README.md
+++ b/all/fidl/fuchsia.ui.brightness/README.md
@@ -25,8 +25,7 @@
### WatchAutoBrightness {#WatchAutoBrightness}
<p>Requests the current auto-brightness mode.
-This call implements the Hanging Get protocol as detailed in
-https://fuchsia.dev/fuchsia-src/development/api/fidl.md#delay-responses-using-hanging-gets</p>
+This call implements the Hanging Get protocol.</p>
#### Request
<table>
@@ -48,7 +47,8 @@
<p>Turns auto-brightness mode off.
Used by e.g. Settings to set manual brightness using a slider
-Value is in the range 0.0 to 1.0 representing min to max.</p>
+Value is in the range 0.0 to 1.0 representing min to max and
+will be clamped if out of range.</p>
#### Request
<table>
@@ -65,10 +65,9 @@
### WatchCurrentBrightness {#WatchCurrentBrightness}
<p>Gets the current brightness in the range 0.0 to 1.0.
-This result is valid for both manual and auto-brightness modes and is typically used
-to show the current brightness on a slider.
-This call implements the Hanging Get protocol as detailed in
-https://fuchsia.dev/fuchsia-src/development/api/fidl.md#delay-responses-using-hanging-gets</p>
+This result is valid for both manual and auto-brightness modes
+and is typically used to show the current brightness on a slider.
+This call implements the Hanging Get protocol.</p>
#### Request
<table>
@@ -86,17 +85,17 @@
</td>
</tr></table>
-### SetAutoBrightnessOffset {#SetAutoBrightnessOffset}
+### SetAutoBrightnessAdjustment {#SetAutoBrightnessAdjustment}
-<p>Sets the brightness offset.
-This will change the built-in brightness curve by the factor of the offset.
-The offset is in the range of -1.0 to 1.0.</p>
+<p>Sets the brightness adjustment.
+This will change the brightness curve by the factor of the adjustment.
+The adjustment is in the range of -1.0 to 1.0.</p>
#### Request
<table>
<tr><th>Name</th><th>Type</th></tr>
<tr>
- <td><code>offset</code></td>
+ <td><code>adjustment</code></td>
<td>
<code>float32</code>
</td>
@@ -104,11 +103,10 @@
-### WatchAutoBrightnessOffset {#WatchAutoBrightnessOffset}
+### WatchAutoBrightnessAdjustment {#WatchAutoBrightnessAdjustment}
-<p>Gets the current auto brightness offset.
-This call implements the Hanging Get protocol as detailed in
-https://fuchsia.dev/fuchsia-src/development/api/fidl.md#delay-responses-using-hanging-gets</p>
+<p>Gets the current auto brightness adjustment.
+This call implements the Hanging Get protocol.</p>
#### Request
<table>
@@ -120,7 +118,7 @@
<table>
<tr><th>Name</th><th>Type</th></tr>
<tr>
- <td><code>offset</code></td>
+ <td><code>adjustment</code></td>
<td>
<code>float32</code>
</td>
@@ -129,7 +127,9 @@
### SetBrightnessTable {#SetBrightnessTable}
<p>Sets the brightness curve as a set of points.
-This will override the built-in brightness curve.</p>
+This will override the built-in brightness curve.
+The default brightness curve will be used if the table is empty.
+The connection will be closed if table errors are detected.</p>
#### Request
<table>
@@ -172,6 +172,7 @@
### CalculateColorTint {#CalculateColorTint}
+<p>Given a light sensor reading returns tint values and brightness settings.</p>
#### Request
<table>
@@ -199,11 +200,12 @@
## **STRUCTS**
### BrightnessPoint {#BrightnessPoint}
-*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#51)*
+*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#52)*
-<p>A tuple representing a point on the auto-brightness curve</p>
+<p>A tuple representing a point on the auto-brightness curve
+Ambient_lux and nits must be positive values.</p>
<table>
@@ -225,12 +227,12 @@
</table>
### BrightnessTable {#BrightnessTable}
-*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#58)*
+*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#59)*
<p>A set of points defining the auto-brightness curve.
-They should be ordered in increasing ambient_lux</p>
+The ambient_lux values must be monotonically increasing.</p>
<table>
@@ -277,6 +279,8 @@
*Defined in [fuchsia.ui.brightness/color_tint.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/color_tint.fidl#17)*
+<p>Values for a generic sensor.
+Not all entries may be given by a particular sensor.</p>
<table>
@@ -287,7 +291,9 @@
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Raw red, green, blue and clear values given by the sensor.
+They have no units.</p>
+</td>
</tr><tr>
<td>2</td>
<td><code>green</code></td>
@@ -315,14 +321,18 @@
<td>
<code><a class='link' href='#kelvin'>kelvin</a></code>
</td>
- <td></td>
+ <td><p>The color temperature is measured in degrees Kelvin.</p>
+</td>
</tr><tr>
<td>6</td>
<td><code>lux</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>The lux is the measured brightness that the sensor is seeing.
+This will be a calibrated value for each type of sensor and
+each device it is built into.</p>
+</td>
</tr></table>
### TargetColorTint {#TargetColorTint}
@@ -330,6 +340,10 @@
*Defined in [fuchsia.ui.brightness/color_tint.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/color_tint.fidl#36)*
+<p>Values for adjusting screen colors based on the raw sensor information.
+Not all entries may be populated by a particular algorithm.
+Either the RGB values or the color temperature may be used
+they are interchangeable.</p>
<table>
@@ -340,7 +354,9 @@
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Red, green and blue are numbers between 0.0 to 1.0 inclusive, they give
+the tint.</p>
+</td>
</tr><tr>
<td>2</td>
<td><code>green</code></td>
@@ -361,28 +377,32 @@
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>The derived brightness from the R, G, B and clear sensor readings.</p>
+</td>
</tr><tr>
<td>5</td>
<td><code>color_temperature</code></td>
<td>
<code><a class='link' href='#kelvin'>kelvin</a></code>
</td>
- <td></td>
+ <td><p>The derived color temperature matching the red, green and blue values.</p>
+</td>
</tr><tr>
<td>6</td>
<td><code>brightness_with_color_match</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Brightness in range 0.0 - 1.0 inclusive if color tinting is used.</p>
+</td>
</tr><tr>
<td>7</td>
<td><code>brightness_without_color_match</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Brightness in range 0.0 - 1.0 inclusive if color tinting is not used.</p>
+</td>
</tr></table>
