README.org: Add Broadcom webcam usage example.

* README.org (Broadcom Webcam): Add usage example.

Signed-off-by: Jonathan Brielmaier <jonathan.brielmaier@web.de>

1 files changed, 26 insertions, 1 deletions

diff --git a/README.org b/README.org
index e98e84a..5982351 100644
--- a/README.org
+++ b/README.org
@@ -173,7 +173,9 @@ is exactly equivalent to:
                    rest)))
 #+END_SRC
 
-** Broadcom Wireless
+** Broadcom
+
+*** Wireless
 
 Some Broadcom wireless hardware requires a proprietary kernel module in
 addition to firmware. To use such hardware you will also need to add a service
@@ -192,6 +194,29 @@ to load that module on boot and blacklist conflicting kernel modules:
     ...)
 #+END_SRC
 
+*** Webcam
+
+Like Broadcom wireless hardware, the Broadcom 1570 PCIe webcam (better known as
+FacetimeHD and found in recent Macbooks) also requires a kernel module,
+firmware, and blacklisting of conflicting modules:
+
+#+BEGIN_SRC scheme
+  (use-modules (nongnu packages linux))
+  (use-modules (nongnu packages firmware))
+
+  (operating-system
+    (kernel-arguments '("modprobe.blacklist=bdc_pci"))
+    (kernel-loadable-modules (list facetimehd))
+    (firmware (cons* facetimehd-firmware
+                     facetimehd-calibration ; Optional but make the colors look better.
+                     %base-firmware))
+    (services
+     (cons* (simple-service 'facetimehd
+                            kernel-module-loader-service-type
+                            '("facetimehd"))
+            ...))
+    ...)
+#+END_SRC
 ** Substitutes for nonguix
 
 A Nonguix substitute server is available at [[https://substitutes.nonguix.org]].