Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


products:maker-kit:mind-2-ai-maker-kit:troubleshooting:fix-ubuntu

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
products:maker-kit:mind-2-ai-maker-kit:troubleshooting:fix-ubuntu [2024/12/30 05:31]
nick
products:maker-kit:mind-2-ai-maker-kit:troubleshooting:fix-ubuntu [2025/02/20 22:01] (current)
nick
Line 2: Line 2:
  
  
-====== Fix Ubuntu issues ======+====== Fix Ubuntu 24.04.1 issues ======
  
-As the CPU (Intel® Core™ Ultra Processor [Series 2]) of Mind 2 AI Maker Kit is a quite new CPU, so current Ubuntu ''22.04/24.04'' LTS with Linux kernel ''6.8'' doesn't support well on it, current known issues list below:+<WRAP important > 
 +This documentation is only applied for **Ubuntu 24.04.1**, if you use **Ubuntu  24.04.2** or newer version you don't need any tweak and just ignore this documentation. 
 + 
 +And we suggest you to use **Ubuntu 24.04.2** or newer version. 
 +</WRAP> 
 + 
 + 
 +===== Introduction ===== 
 + 
 + 
 +As the CPU (Intel® Core™ Ultra Processor [Series 2]) of Mind 2 AI Maker Kit is a quite new CPU, so current Ubuntu ''24.04'' LTS with Linux kernel ''6.8'' doesn't support well on it, current known issues list below:
  
   * AX211 Wi-Fi doesn't work   * AX211 Wi-Fi doesn't work
Line 19: Line 29:
 ===== Disable the Secure Boot ===== ===== Disable the Secure Boot =====
  
-You need to disable the Secure Boot to update the Wi-Fi drivers, you can follow the steps below to disable the Secure Boot.+You need to disable the Secure Boot to update the kernel, you can follow the steps below to disable the Secure Boot.
  
 Reboot and press ''DELETE'' to enter BIOS setup menu, and then navigate to ''Security'' -> ''Secure Boot'', and setup to ''Disabled'', press ''F4'' to save and reboot. Reboot and press ''DELETE'' to enter BIOS setup menu, and then navigate to ''Security'' -> ''Secure Boot'', and setup to ''Disabled'', press ''F4'' to save and reboot.
  
-===== Upgrade your system & kernel =====+===== Upgrade your system =====
  
 ```shell ```shell
 $ sudo apt update $ sudo apt update
 $ sudo apt full-upgrade -y $ sudo apt full-upgrade -y
 +$ sync 
 +$ sudo reboot
 ``` ```
  
-Follow the steps below to upgrade the kernel to ''6.12+'':+After reboot, follow the steps below to upgrade the kernel to ''6.11+'' (kernel of Ubuntu 24.10):
  
 ```shell ```shell
-cd /tmp +wget https://security.ubuntu.com/ubuntu/pool/main//l/linux-signed/linux-image-6.11.0-13-generic_6.11.0-13.14_amd64.deb -P /tmp 
-$ wget https://kernel.ubuntu.com/mainline/v6.12.3/amd64/linux-headers-6.12.3-061203-generic_6.12.3-061203.202412060638_amd64.deb +$ wget https://security.ubuntu.com/ubuntu/pool/main//l/linux/linux-modules-6.11.0-13-generic_6.11.0-13.14_amd64.deb -P /tmp 
-$ wget https://kernel.ubuntu.com/mainline/v6.12.3/amd64/linux-headers-6.12.3-061203_6.12.3-061203.202412060638_all.deb +$ wget https://security.ubuntu.com/ubuntu/pool/main//l/linux/linux-modules-extra-6.11.0-13-generic_6.11.0-13.14_amd64.deb -P /tmp 
-$ wget https://kernel.ubuntu.com/mainline/v6.12.3/amd64/linux-image-unsigned-6.12.3-061203-generic_6.12.3-061203.202412060638_amd64.deb +$ wget https://security.ubuntu.com/ubuntu/pool/main//l/linux/linux-headers-6.11.0-13-generic_6.11.0-13.14_amd64.deb -P /tmp 
-$ wget https://kernel.ubuntu.com/mainline/v6.12.3/amd64/linux-modules-6.12.3-061203-generic_6.12.3-061203.202412060638_amd64.deb +$ wget https://security.ubuntu.com/ubuntu/pool/main//l/linux/linux-headers-6.11.0-13_6.11.0-13.14_all.deb -P /tmp 
-$ sudo dpkg -i linux-*.deb+$ sudo dpkg -i /tmp/linux-*.deb
 ``` ```
  
Line 49: Line 61:
 $ sudo apt update $ sudo apt update
 $ sudo apt full-upgrade -y $ sudo apt full-upgrade -y
-$ sync +``` 
 + 
 +The Ubuntu 24.04 repositories contain compute packages for various Intel graphics products. To install those packages, use the following commands: 
 + 
 +```shell 
 +$ wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | \ 
 +  sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg 
 +$ echo "deb [arch=amd64,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu noble client" | \ 
 +  sudo tee /etc/apt/sources.list.d/intel-gpu-noble.list 
 +$ sudo apt update 
 +$ sudo apt install -y libze-intel-gpu1 libze1 intel-opencl-icd clinfo intel-gsc 
 +``` 
 + 
 +The commands listed above install all the essential packages needed for most users, aiming to minimize the installation of unnecessary packages. However, if you plan to use PyTorch, install ''libze-dev'' and ''intel-ocloc'' additionally: 
 + 
 +```shell 
 +$ sudo apt install -y libze-dev intel-ocloc 
 +``` 
 + 
 +Add user to ''render'' group and  reboot the device: 
 + 
 +```shell 
 +$ sudo gpasswd -a ${USER} render 
 +$ newgrp render 
 +$ sync 
 +$ sudo reboot 
 +``` 
 + 
 +After reboot, to verify that the kernel and compute drivers are installed and functional, run ''clinfo'': 
 + 
 +```shell 
 +$ clinfo | grep "Device Name" 
 +  Device Name                                     Intel(R) Graphics [0x64a0] 
 +    Device Name                                   Intel(R) Graphics [0x64a0] 
 +    Device Name                                   Intel(R) Graphics [0x64a0] 
 +    Device Name                                   Intel(R) Graphics [0x64a0]
 ``` ```
  
 ===== Fix Wi-Fi issue ===== ===== Fix Wi-Fi issue =====
 +
 +==== Download and install the Wi-Fi driver ====
 +
 +Follow the steps below to download the Wi-Fi driver:
 +
 +```shell
 +$ sudo apt update
 +$ sudo apt install -y git build-essential gcc-14 net-tools
 +$ cd ~/Downloads
 +$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git -b release/core91 --depth=1
 +```
 +
 +Build and install the Wi-Fi driver:
 +
 +```shell
 +$ cd ~/Downloads/backport-iwlwifi
 +$ make defconfig-iwlwifi-public
 +$ make -j10
 +$ sudo make install
 +$ sync
 +```
  
 ==== Update the Wi-Fi firmware ==== ==== Update the Wi-Fi firmware ====
Line 59: Line 127:
  
 ```shell ```shell
-$ wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/iwlwifi-bz-b0-gf-a0-92.ucode -P /tmp +$ wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/iwlwifi-bz-b0-gf-a0-94.ucode -P /tmp 
-$ wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/iwlwifi-bz-b0-gf-a0-94.ucode -P /tmp/ +$ wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/iwlwifi-bz-b0-gf-a0.pnvm -P /tmp/
-$ wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/iwlwifi-bz-b0-gf-a0.pnvm -P /tmp+
 $ sudo cp /tmp/iwlwifi-bz-b0-gf-a0* /lib/firmware/ $ sudo cp /tmp/iwlwifi-bz-b0-gf-a0* /lib/firmware/
 $ sync $ sync
Line 78: Line 145:
 ```shell ```shell
 $ sudo dmesg | grep iw $ sudo dmesg | grep iw
-[sudopassword for khadas+   1.466177Loading modules backported from iwlwifi 
-[    2.138378] iwlwifi 0000:00:14.3: enabling device (0000 -> 0002) +[    1.466183] iwlwifi-stack-public:release/core91:12629:813fd3c6 
-[    2.152438] iwlwifi 0000:00:14.3: Detected crf-id 0x400410, cnv-id 0x1080900 wfpm id 0x80005b20 +[    1.526533] iwlwifi 0000:00:14.3: enabling device (0000 -> 0002) 
-[    2.152454] iwlwifi 0000:00:14.3: PCI dev a840/0094, rev=0x461, rfid=0x2010d000 +[    1.545348] iwlwifi 0000:00:14.3: Detected crf-id 0x400410, cnv-id 0x1080900 wfpm id 0x80005b20 
-[    2.152457] iwlwifi 0000:00:14.3: Detected Intel(R) Wi-Fi 7 BE201 320MHz +[    1.545364] iwlwifi 0000:00:14.3: PCI dev a840/0094, rev=0x461, rfid=0x2010d000 
-[    2.154067] iwlwifi 0000:00:14.3: Direct firmware load for iwlwifi-bz-b0-gf-a0-93.ucode failed with error -2 +[    1.545366] iwlwifi 0000:00:14.3: Detected Intel(R) Wi-Fi 7 BE201 320MHz 
-[    2.157226] iwlwifi 0000:00:14.3: TLV_FW_FSEQ_VERSION: FSEQ Version: 0.182.4.3 +[    1.554165] iwlwifi 0000:00:14.3: TLV_FW_FSEQ_VERSION: FSEQ Version: 0.0.4.191 
-[    2.157991] iwlwifi 0000:00:14.3: loaded firmware version 92.7541f516.0 bz-b0-gf-a0-92.ucode op_mode iwlmvm +[    1.554464] iwlwifi 0000:00:14.3: loaded firmware version 94.62990553.0 bz-b0-gf-a0-94.ucode op_mode iwlmvm 
-[    2.574664] iwlwifi 0000:00:14.3: RFIm is deactivated, reason = 4 +[    2.082992] iwlwifi 0000:00:14.3: loaded PNVM version da3b5cf2 
-[    2.575630] iwlwifi 0000:00:14.3: loaded PNVM version da3b5cf2 +[    2.101329] iwlwifi 0000:00:14.3: Detected RF GF, rfid=0x2010d000 
-[    2.593653] iwlwifi 0000:00:14.3: Detected RF GF, rfid=0x2010d000 +[    2.165121] iwlwifi 0000:00:14.3: base HW address: b0:dc:ef:58:db:3f 
-[    2.657680] iwlwifi 0000:00:14.3: base HW address: bc:38:98:04:62:3f +[    2.245760] iwlwifi 0000:00:14.3 wlo1: renamed from wlan0 
-[    2.727740] iwlwifi 0000:00:14.3 wlo1: renamed from wlan0 +[    2.643634] iwlwifi 0000:00:14.3: Registered PHC clock: iwlwifi-PTP, with index: 0
-[    3.697260] iwlwifi 0000:00:14.3: RFIm is deactivated, reason = 4 +
-[    3.781210] iwlwifi 0000:00:14.3: Registered PHC clock: iwlwifi-PTP, with index: 0+
 ``` ```
  
Line 109: Line 174:
 ===== Fix Bluetooth issue ===== ===== Fix Bluetooth issue =====
  
-After you upgrade kernel to ''6.12+'' from [[#upgrade-your-system-kernel | Upgrade your system & kernel]] section, this issue will be fixed automatically.+After you upgrade kernel to ''6.11+'' from [[#upgrade-your-system-kernel | Upgrade your system & kernel]] section, this issue will be fixed automatically.
  
 ===== Fix HDMI sound card issue ===== ===== Fix HDMI sound card issue =====
  
-After you upgrade kernel to ''6.12+'' from [[#upgrade-your-system-kernel | Upgrade your system & kernel]] section, this issue will be fixed automatically.+After you upgrade kernel to ''6.11+'' from [[#upgrade-your-system-kernel | Upgrade your system & kernel]] section, this issue will be fixed automatically
 + 
 +===== Troubleshooting ===== 
 + 
 +If you upgrade the kernel manually then you may need to [[#download-and-install-the-wi-fi-driver | Download and install the Wi-Fi driver 
 +]] again to make the Wi-Fi work.
  
 ===== In the end ===== ===== In the end =====
  
-All the above steps will not needed once the Ubuntu official release the new OS with kernel ''6.12+''.+<WRAP tip > 
 +Ubuntu **24.04.2** already fixed all the issues above, you don't need to do anything if you use **24.04.2** or newer version. 
 +</WRAP> 
 + 
 +All the above steps will not needed once the Ubuntu official release the new OS with kernel ''6.11+''. 
 + 
 +See also: 
 + 
 +  * [[https://dgpu-docs.intel.com/driver/client/overview.html | Installing Client GPUs]]
  
  
Last modified: 2024/12/30 05:31 by nick