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:13]
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 15: Line 25:
 ===== Preparation ===== ===== Preparation =====
  
-As you need to download the Wi-Fi driver and firmware from the internet, so **you need a USB ethernet adaptor to access the network**.+As you need to download files from the internet, so **you need a USB ethernet adaptor to access the network**.
  
 ===== 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 & kerenl =====+===== 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 $ sudo reboot
 ``` ```
  
-===== Fix Wi-Fi issue =====+After reboot, to verify that the kernel and compute drivers are installed and functional, run ''clinfo'':
  
-You need to use the [[https://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git/ | backport-iwlwifi]] driver to make the Wi-Fi work.+```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 =====
  
 ==== Download and install the Wi-Fi driver ==== ==== Download and install the Wi-Fi driver ====
Line 63: Line 107:
 ```shell ```shell
 $ sudo apt update $ sudo apt update
-$ sudo apt install -y git build-essential gcc-12 net-tools+$ sudo apt install -y git build-essential gcc-14 net-tools
 $ cd ~/Downloads $ cd ~/Downloads
 $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git -b release/core91 --depth=1 $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git -b release/core91 --depth=1
Line 77: Line 121:
 $ sync $ sync
 ``` ```
 +
 ==== Update the Wi-Fi firmware ==== ==== Update the Wi-Fi firmware ====
  
-You also need to follow the steps below to update the Wi-Fi firmware:+You need to follow the steps below to update the Wi-Fi firmware:
  
 ```shell ```shell
Line 129: Line 174:
 ===== Fix Bluetooth issue ===== ===== Fix Bluetooth issue =====
  
-After you upgrade kernel to ''6.12+'' from [[#upgrade-your-system-kerenl | Upgrade your system & kerenl]] 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-kerenl | Upgrade your system & kerenl]] 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 ===== ===== Troubleshooting =====
Line 142: Line 187:
 ===== 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:13 by nick