From 10aeb5e4641a6c79e6c405373f791228cd26748d Mon Sep 17 00:00:00 2001
From: Daniel Barlow <dan@telent.net>
Date: Sun, 19 Feb 2023 16:43:45 +0000
Subject: [PATCH] add notes about dual-band hardware

---
 devices/gl-ar750/default.nix | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/devices/gl-ar750/default.nix b/devices/gl-ar750/default.nix
index 38aa73f..4ba8654 100644
--- a/devices/gl-ar750/default.nix
+++ b/devices/gl-ar750/default.nix
@@ -1,10 +1,3 @@
-# GL.INet GL-AR750 "Creta" travel router
-#  - QCA9531 @650Mhz SoC
-#  - dual band wireless: IEEE 802.11a/b/g/n/ac
-#  - two 10/100Mbps LAN ports and one WAN
-#  - 128MB DDR2 RAM / 16MB  NOR Flash
-#  - "ath79" soc family
-# https://www.gl-inet.com/products/gl-ar750/
 
 # I like GL.iNet devices because they're relatively accessible to
 # DIY users: the serial port connections have headers preinstalled
@@ -24,6 +17,27 @@
     };
   };
 
+  description = ''
+    GL.INet GL-AR750 "Creta" travel router
+     - QCA9531 @650Mhz SoC
+     - dual band wireless: IEEE 802.11a/b/g/n/ac
+     - two 10/100Mbps LAN ports and one WAN
+     - 128MB DDR2 RAM / 16MB  NOR Flash
+     - "ath79" soc family
+    https://www.gl-inet.com/products/gl-ar750/
+
+    The GL-AR750 has two distinct sets of wifi hardware. The 2.4GHz
+    radio is part of the QCA9531 SoC, i.e. it's on the same silicon as
+    the CPU, the Ethernet, the USB etc. The device is connected to the
+    host via AHB, the "Advanced High-Performance Bus" and it is
+    supported in Linux using the ath9k driver. The 5GHz support, on the
+    other hand, is provided by a QCA9887 PCIe (PCI embedded) WLAN chip:
+    I haven't looked closely at the router innards to see if this is
+    actually physically a separate board that could be unplugged, but
+    as far as the Linux is concerned it behaves as one. This is
+    supported by the ath10k driver.
+  '';
+
   module = {pkgs, ... }:
     let
       openwrt = pkgs.pkgsBuildBuild.fetchFromGitHub {