Update page.tsx

web/app/docs/hardware/coral-tpu-lxc/page.tsx

@@ -18,13 +18,9 @@ export default function CoralTPULXC() {
       </p>
 
       <h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2>
-      <p className="mb-4">The script automates the following steps:</p>
+      <p className="mb-4">The script automates the complete configuration of Coral TPU support in LXC containers, including USB and M.2 variants. It applies Proxmox-specific container settings, manages device passthrough permissions, and installs required drivers both on the host and inside the container.</p>
-      <ol className="list-decimal pl-6 space-y-2 mb-6">
+      <p className="mb-4">The USB variant uses a persistent mapping based on <code>/dev/coral</code> via <code>udev</code> rules, avoiding reliance on dynamic USB paths like <code>/dev/bus/usb/*</code>. This ensures consistent device assignment across reboots and hardware reordering.</p>
-        <li>Allows selection of an existing LXC container.</li>
+      <p className="mb-4">The M.2 version is detected automatically and configured only if present.</p>
-        <li>Ensures the container is privileged for hardware access.</li>
-        <li>Configures LXC parameters for Coral TPU and Intel iGPU.</li>
-        <li>Installs required drivers and dependencies inside the container.</li>
-      </ol>
 
       <h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</h2>
       <Steps>
@@ -39,13 +35,47 @@ export default function CoralTPULXC() {
             <li>Sets device permissions for TPU and iGPU.</li>
             <li>Configures proper device mounts.</li>
           </ul>
+          <CopyableCode
+            code={`# Coral USB persistent passthrough example:
+/etc/udev/rules.d/99-coral-usb.rules
+SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="9302", SYMLINK+="coral", MODE="0666"
+
+# LXC config:
+lxc.cgroup2.devices.allow: c 189:* rwm
+lxc.mount.entry: /dev/coral dev/coral none bind,optional,create=file`}
+            className="my-4"
+          />
+          <CopyableCode
+            code={`# Coral M.2 passthrough example (automatically added if detected):
+lxc.cgroup2.devices.allow: c 245:0 rwm
+lxc.mount.entry: /dev/apex_0 dev/apex_0 none bind,optional,create=file`}
+            className="my-4"
+          />
         </Steps.Step>
         <Steps.Step title="Install Required Drivers">
           <p>The script installs the necessary components inside the container:</p>
           <ul className="list-disc pl-6 space-y-1 mt-2">
-            <li>GPU drivers (va-driver-all, intel-opencl-icd).</li>
+            <li>GPU drivers:</li>
-            <li>Coral TPU dependencies (Python, GPG keys, repository setup).</li>
+            <ul className="list-disc pl-10">
-            <li>Coral TPU drivers (USB and M.2 support).</li>
+              <li><code>va-driver-all</code></li>
+              <li><code>ocl-icd-libopencl1</code></li>
+              <li><code>intel-opencl-icd</code></li>
+              <li><code>vainfo</code></li>
+              <li><code>intel-gpu-tools</code></li>
+            </ul>
+            <li>Coral TPU dependencies:</li>
+            <ul className="list-disc pl-10">
+              <li><code>python3</code></li>
+              <li><code>python3-pip</code></li>
+              <li><code>python3-venv</code></li>
+              <li><code>gnupg</code></li>
+              <li><code>curl</code></li>
+            </ul>
+            <li>Coral TPU drivers:</li>
+            <ul className="list-disc pl-10">
+              <li><code>libedgetpu1-std</code> (standard performance)</li>
+              <li><code>libedgetpu1-max</code> (maximum performance, optional)</li>
+            </ul>
           </ul>
         </Steps.Step>
         <Steps.Step title="Select Coral TPU Driver Version">
@@ -70,8 +100,9 @@ export default function CoralTPULXC() {
         <li>The script supports both USB and M.2 Coral TPU devices.</li>
         <li>The Proxmox host must have the required Coral TPU and Intel GPU drivers installed.</li>
         <li>Additional application-specific configurations may be required inside the container.</li>
+        <li>Coral USB passthrough uses a persistent device alias <code>/dev/coral</code> created by a udev rule. This improves stability and avoids issues with changing USB port identifiers.</li>
+        <li>Coral M.2 devices are detected dynamically using <code>lspci</code> and configured only if present.</li>
       </ul>
-      
     </div>
   )
 }