diff --git a/docs/dragon/q6a/other-system/windows.md b/docs/dragon/q6a/other-system/windows.md new file mode 100644 index 000000000..1c1f5f5e8 --- /dev/null +++ b/docs/dragon/q6a/other-system/windows.md @@ -0,0 +1,121 @@ +--- +sidebar_position: 5 +--- + +# Windows on ARM + +:::warning 重要提示 + +- 当前系统缺失无线网卡驱动，需通过有线网络或其他方式联网安装后续更新； +- 安装过程中可能需要多次重启，请确保电源稳定，避免在关键步骤中断电； +- 安装和驱动部署前请备份重要数据。 +- 不建议使用 SD 存储，请使用 UFS 或 NVMe 存储。 + ::: + +## 功能概览（简要） + +在未安装专用驱动之前，Dragon Q6A 可以正常从通用 Windows ARM64 安装镜像启动，基础可用功能包括： + +- HDMI 输出（依赖 UEFI GOP）； +- PCIe（可使用 NVMe 作为存储；出厂镜像中可能不包含网卡驱动）； +- eMMC、UFS 存储； +- USB2、USB3（部分情况下需要在开机前接好设备）。 + +安装官方驱动后，可以进一步获得： + +- 硬件视频编解码加速（最高支持 4K@60fps 10-bit 解码等，通过 D3D11VA / MediaFoundation 等接口）； +- GPU 功能（Direct3D 12、OpenCL 3.0、Vulkan 1.3、OpenGL 4.1 等能力，需要在 Microsoft Store 安装对应兼容包）； +- MIPI CSI 摄像头（Qualcomm Spectra 570L ISP，可 4K@30fps 10-bit 录像）； +- 40-Pin GPIO 等扩展能力[示例](https://github.com/strongtz/radxa-wos-gpio-demo/releases/tag/v1)。 + +## 使用前提 + +在开始安装 Windows on ARM 之前，请确认： + +- 已经准备好一块 Radxa Dragon Q6A 开发板，以及合适的电源适配器； +- 有 HDMI 显示器、USB 键盘和鼠标； +- 有一台运行 Windows 的主机电脑，用于制作 Windows 安装 U 盘； +- Dragon Q6A 已刷入支持 Windows 启动的 UEFI 固件（参考[spi-fw](../low-level-dev/spi-fw.md)）。 + +## 准备 Windows 安装 U 盘 + +安装 Windows 推荐使用标准的 Windows 安装流程：先在 PC 上制作 Windows ARM64 安装 U 盘，然后在 Q6A 上从 U 盘启动安装程序。 + +### 下载 Windows ARM64 ISO 镜像 + +你需要获取一份 Windows 11 ARM64 的 ISO 镜像，推荐来源包括： + +- [Microsoft 官方网站](https://www.microsoft.com/en-us/software-download/windows11) + ![select windows on arm](/img/dragon/q6a/windows-download1.webp) +- [UUP dump](https://uupdump.net/) + +建议，可以选择 Windows 11 24H2 或更新版本，以获得更好的应用兼容性（Prism 模拟器、AVX/AVX2 支持等）。 + +:::tip +因为 ISO 镜像文件较大，请务必选择合适的下载源，在下载完成后需要使用 MD5 或 SHA256 等校验和工具验证文件完整性。 +::: + +### 使用 Rufus 制作安装 U 盘 + +1. 准备一个容量不少于 16 GB 的 USB U 盘（U 盘内数据会被清空）； +2. 从 https://rufus.ie/ 下载最新版本的 Rufus，并在 Windows 主机上运行； +3. 在 Rufus 中选择： + - 设备：选择你的 U 盘； + - 启动选项：选择刚才下载的 Windows ARM64 ISO 镜像； + - 分区类型、目标系统等保持默认（一般为 GPT + UEFI）； + - 按照下图配置选项 + ![rufus](/img/dragon/q6a/windows-image-flash.webp) +4. 点击“开始”，按照提示完成写入过程； +5. 写入完成后，从主机安全移除 U 盘。 + +## 从 U 盘启动安装程序 + +1. 将制作好的 Windows 安装 U 盘插入 Dragon Q6A 的任意 USB 接口； +2. 接好 HDMI 显示器、键盘和鼠标，给开发板上电； +3. 当启动画面出现时，按下 **F12** 键进入启动菜单（Boot Menu）； +4. 在启动菜单中选择对应的 USB 启动项（例如“UEFI: USB ...”），回车确认； +5. 系统会从 U 盘启动标准的 Windows 安装程序，之后可以按常规 Windows 安装流程进行： + - 选择语言、时间和键盘布局； + - 选择“自定义安装”，选中目标磁盘（NVMe/UFS/eMMC 等）； + - 删除、创建分区（如有需要），然后选择目标分区进行安装； + - 等待复制文件与多次重启完成。 + +安装完成并进入桌面后，**建议先在“设置”中关闭自动睡眠**，因为在未安装驱动的情况下，设备可能无法从睡眠状态正常唤醒。 + +## 安装驱动程序 + +Windows 安装完成后，系统仍然缺少诸如网络、GPU、音频等专用驱动，需要安装 Radxa 提供的 Dragon Q6A Windows 驱动包。 + +### 准备驱动包 + +1. 在另一台电脑上从 Radxa 官方渠道下载 **Dragon Q6A Windows 驱动包** [下载链接](https://node0.momosan.cc/mirror/share/dragon-q6a/Q6A_WoS_DriverPackage_251205_testsigned.7z)； +2. 将驱动包解压后，通过 U 盘或网络（如有）拷贝到 Q6A 上的 Windows 系统中； +3. 假设解压后目录中包含如下关键文件： + - `1-testsigning.bat` + - `radxa_wos_test_cert.reg` + - `2-DriverSetInst.bat` + - 以及各类 `.inf`、驱动文件等。 + +### 启用测试签名并导入证书 + +1. 在解压目录中找到 `1-testsigning.bat`； +2. 右键该文件，选择“**以管理员身份运行**”，按照命令提示完成操作； +3. 双击 `radxa_wos_test_cert.reg`，同意导入注册表，以安装测试签名证书； +4. 完成后，重启系统。 + +> 启用测试签名模式并导入证书是为了允许安装 Radxa 提供的测试签名驱动，否则驱动可能会被系统阻止。 + +### 安装驱动集合 + +1. 重启后，再次进入桌面，回到驱动包解压目录； +2. 右键 `2-DriverSetInst.bat`，选择“**以管理员身份运行**”； +3. 等待脚本自动安装所有相关驱动（过程中可能会出现命令行窗口与多次设备刷新）； +4. 安装完成后，再次重启系统。 + +此时，大部分硬件（包括网络、GPU、多媒体、音频等）应可在 Windows 中正常工作。 + +## 后续建议 + +- 通过 Windows Update 检查并安装最新系统更新； +- 从 Microsoft Store 安装 OpenCL、OpenGL、Vulkan 相关兼容包，以获得更完整的 GPU 能力； +- 根据需要安装常用开发工具和应用（推荐优先使用原生 ARM64 或 x64 版本应用）。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/other-system/windows.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/other-system/windows.md new file mode 100644 index 000000000..6a2b6b34d --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/other-system/windows.md @@ -0,0 +1,127 @@ +--- +sidebar_position: 5 +description: Step-by-step guide to installing Windows on ARM on Radxa Dragon Q6A. +--- + +# Install Windows on ARM on Radxa Dragon Q6A + +:::warning Important + +- Currently, the system lacks a wireless NIC driver. Please use a wired network or other methods to get online for further updates. +- The installation process may require multiple reboots. Make sure the power supply is stable and avoid cutting power during critical steps. +- Back up all important data before installation and driver deployment. +- Using SD storage is not recommended. Please use UFS or NVMe storage instead. + ::: + +## Feature Overview (Brief) + +Before installing the dedicated drivers, Dragon Q6A can already boot from a generic Windows ARM64 installation image, with the following basic features available: + +- HDMI output (via UEFI GOP); +- PCIe (you can use NVMe as the system drive; the default image may not include network card drivers); +- eMMC and UFS storage; +- USB2 and USB3 (in some cases, devices must be connected before booting into the system). + +After installing the official drivers, you can further get: + +- Hardware video codec acceleration (up to 4K@60fps 10-bit decode via D3D11VA / MediaFoundation, etc.); +- GPU features (Direct3D 12, OpenCL 3.0, Vulkan 1.3, OpenGL 4.1, etc. — OpenGL/OpenCL/Vulkan compatibility packs must be installed from Microsoft Store); +- MIPI CSI camera (Qualcomm Spectra 570L ISP, supporting 4K@30fps 10-bit recording); +- 40-pin GPIO and other expansion capabilities (see the [GPIO demo](https://github.com/strongtz/radxa-wos-gpio-demo/releases/tag/v1)). + +## Prerequisites + +Before installing Windows on ARM, make sure: + +- You have a Radxa Dragon Q6A board and a suitable power adapter; +- You have an HDMI display, USB keyboard and mouse available; +- You have a Windows PC to create the Windows installation USB drive; +- Dragon Q6A has been flashed with a UEFI firmware that supports booting Windows (see [spi-fw](../low-level-dev/spi-fw.md)). + +## Prepare the Windows Installation USB Drive + +The recommended way to install Windows is to follow the standard Windows setup flow: first create a Windows ARM64 installation USB drive on a PC, then boot the installer from USB on Q6A. + +### Download the Windows ARM64 ISO Image + +You need a Windows 11 ARM64 ISO image. Recommended sources include: + +- [Microsoft official website](https://www.microsoft.com/en-us/software-download/windows11) + ![select windows on arm](/img/dragon/q6a/windows-download1.webp) +- [UUP dump](https://uupdump.net/) + +It is recommended to use Windows 11 24H2 or later to get better application compatibility (Prism emulator, AVX/AVX2 support, etc.). + +:::tip +The ISO image is large. Please choose a suitable mirror/download source and, after the download completes, verify file integrity using checksum tools such as MD5 or SHA256. +::: + +### Create the Installation USB with Rufus + +1. Prepare a USB drive with at least 16 GB of capacity (all data on it will be erased); +2. Download the latest Rufus from https://rufus.ie/ and run it on the Windows PC; +3. In Rufus, configure: + + - **Device**: your USB drive; + - **Boot selection**: the Windows ARM64 ISO you downloaded; + - **Partition scheme / Target system**: keep the defaults (typically GPT + UEFI); + - Configure remaining options following the example below: + + ![rufus](/img/dragon/q6a/windows-image-flash.webp) + +4. Click **Start** and follow Rufus prompts to write the image; +5. When finished, safely eject the USB drive from the PC. + +## 2. Boot the Installer from USB + +1. Plug the Windows installation USB drive into any USB port on the Dragon Q6A; +2. Connect HDMI display, keyboard and mouse, then power on the board; +3. When the splash/boot screen appears, press **F12** to enter the boot menu; +4. In the boot menu, select the USB boot entry (for example, `UEFI: USB ...`) and press Enter; +5. The system will boot the standard Windows installer from the USB drive. Then follow the normal Windows installation steps: + - Choose language, time and keyboard layout; + - Choose **Custom installation**, select the target disk (NVMe/UFS/eMMC, etc.); + - Delete/create partitions as needed, then select the target partition to install to; + - Wait for file copying and several automatic reboots to complete. + +After entering the desktop for the first time, it is **strongly recommended** to disable automatic sleep in **Settings**, because without proper drivers the device may fail to wake up from sleep. + +## 3. Install Drivers + +After Windows installation, the system still lacks specific drivers (network, GPU, audio, etc.). You need to install the Radxa Dragon Q6A Windows driver package. + +### 3.1 Prepare the Driver Package + +1. On another computer, download the **Dragon Q6A Windows driver package** ([download link](https://node0.momosan.cc/mirror/share/dragon-q6a/Q6A_WoS_DriverPackage_251205_testsigned.7z)); +2. Extract the archive and copy the extracted folder to the Q6A Windows system via USB drive or network (if available); +3. Assume the extracted directory contains the following key files: + - `1-testsigning.bat` + - `radxa_wos_test_cert.reg` + - `2-DriverSetInst.bat` + - Plus various `.inf` and driver binary files. + +### 3.2 Enable Test Signing and Import Certificate + +1. In the extracted folder, locate `1-testsigning.bat`; +2. Right-click it and select **Run as administrator**, then follow the on-screen instructions; +3. Double-click `radxa_wos_test_cert.reg` and confirm to import it into the registry in order to install the test certificate; +4. Reboot the system after this step. + +> Enabling test signing mode and importing the certificate is required to allow installation of Radxa-provided test-signed drivers, otherwise Windows may block them. + +### 3.3 Install the Driver Set + +1. After reboot, log back into the desktop and open the driver package folder again; +2. Right-click `2-DriverSetInst.bat` and select **Run as administrator**; +3. Wait for the script to install all related drivers (you may see one or more command windows and device refresh events); +4. Reboot the system again after installation completes. + +At this point, most hardware including networking, GPU, multimedia and audio should work properly under Windows. + +## 4. Next Steps + +- Use Windows Update to check for and install the latest system updates; +- Install OpenCL/OpenGL/Vulkan compatibility packs from Microsoft Store for full GPU capabilities; +- Install commonly used tools and apps as needed (prefer native ARM64 or x64 builds when available). + +For advanced use cases such as GStreamer pipelines, multimedia transcoding, OBS, 40-pin GPIO demos, or firmware update from Windows (e.g. using `edl-ng --radxa-wos-platform` to update SPI Flash), please refer to future official Radxa documentation and upstream resources. diff --git a/static/img/dragon/q6a/windows-download1.webp b/static/img/dragon/q6a/windows-download1.webp new file mode 100644 index 000000000..0618eb028 Binary files /dev/null and b/static/img/dragon/q6a/windows-download1.webp differ diff --git a/static/img/dragon/q6a/windows-image-flash.webp b/static/img/dragon/q6a/windows-image-flash.webp new file mode 100644 index 000000000..732a248f6 Binary files /dev/null and b/static/img/dragon/q6a/windows-image-flash.webp differ