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:34]
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 ====== 
 + 
 +<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 ===== ===== Introduction =====
  
  
-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:+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 26: Line 33:
 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 52: 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 62: 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 81: 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 112: 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:34 by nick