From faca0b53c84ade789191a36d1b4f850bcd1685eb Mon Sep 17 00:00:00 2001
From: sandbank52641 <153552626+sandbank52641@users.noreply.github.com>
Date: Sun, 2 Jun 2024 10:48:08 +0200
Subject: [PATCH] document USB-C port control feature

We want to link to this section. The nesting is a little too deep, but
it's the simplest solution for the given state. Ideally, the structure
will be generally flatter and reorganized.

Co-authored-by: matchboxbananasynergy <107055883+matchboxbananasynergy@users.noreply.github.com>
---
 static/features.html | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/static/features.html b/static/features.html
index bd4e43d2..da520d08 100644
--- a/static/features.html
+++ b/static/features.html
@@ -79,7 +79,11 @@
                                 unknown vulnerabilities</a>
                                 <ul>
                                     <li><a href="#attack-surface-reduction">Attack surface
-                                    reduction</a></li>
+                                    reduction</a>
+                                        <ul>
+                                            <li><a href="#usb-c-port-control">USB-C port control</a></li>
+                                        </ul>
+                                    </li>
                                     <li><a href="#exploit-mitigations">Exploit
                                     mitigations</a></li>
                                     <li><a href="#improved-sandboxing">Improved
@@ -249,6 +253,34 @@
                             GrapheneOS shows a notification that links the per-app native debugging
                             settings screen.</li>
                         </ul>
+
+                        <h5 id="usb-c-port-control"><a href="#usb-c-port-control">USB-C port control</a></h5>
+
+                        <p>Our USB-C port mode setting for Tensor Pixels offers precise control over
+                        USB functions, allowing complete disabling of USB controller functionality
+                        including data lines.</p>
+
+                        <p>Unlike the standard Android USB HAL and device administration API, our
+                        USB-C port control fully disables USB-C functionality at the hardware level
+                        using device-specific kernel modifications. This greatly reduces the USB-C
+                        attack surface based on the chosen setting.</p>
+
+                        <p>The feature has five modes:</p>
+
+                        <ul>
+                            <li>Off</li>
+                            <li>Charging-only</li>
+                            <li>Charging-only when locked</li>
+                            <li>Charging-only when locked, except before first unlock</li>
+                            <li>On</li>
+                        </ul>
+
+                        <p>The default is <b>Charging-only when locked, except before the first
+                        unlock</b>. This allows using peripherals like mice, keyboards, and
+                        monitors before the first unlock (for example, after a reboot), which can
+                        help save data if the touch screen fails. After locking, new connections are
+                        blocked immediately, and data lines are disabled when existing connections
+                        end.</p>
                     </section>
 
                     <section id="exploit-mitigations">