Differences

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

--- products:maker-kit:mind-2-ai-maker-kit:troubleshooting:fix-ubuntu [2024/12/30 04:51]
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 ======
+====== 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 issue 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
@@ Line 15: / Line 25: @@
 ===== 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 =====
-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.
-===== Upgrade your system & kerenl =====
+===== Upgrade your system =====
 ```shell
 $ sudo apt update
 $ sudo apt full-upgrade -y
+$ sync
+$ sudo reboot
+```
+After reboot, follow the steps below to upgrade the kernel to ''6.11+'' (kernel of Ubuntu 24.10):
+```shell
+$ 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://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://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://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://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 /tmp/linux-*.deb
+```
+===== Fix GPU issue =====
+As Intel® Core™ Ultra Processor (Series 2) GPU is supported from ''NESA 24.2.2'' so you need to upgrade the MESA packages:
+```shell
+$ sudo add-apt-repository ppa:kisak/kisak-mesa
+$ sudo apt update
+$ sudo apt full-upgrade -y
+```
+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
 ```
-Follow the steps below to upgrade the kernel to ''6.12+'':
+Add user to ''render'' group and  reboot the device:
 ```shell
-$ cd /tmp
+$ sudo gpasswd -a ${USER} render
-$ wget https://kernel.ubuntu.com/mainline/v6.12.3/amd64/linux-headers-6.12.3-061203-generic_6.12.3-061203.202412060638_amd64.deb
+$ newgrp render
-$ 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://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://kernel.ubuntu.com/mainline/v6.12.3/amd64/linux-modules-6.12.3-061203-generic_6.12.3-061203.202412060638_amd64.deb
-$ sudo dpkg -i *.deb
 $ sync
 $ sudo reboot
 ```
-===== Download and install the Wi-Fi driver =====
+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 =====
+==== Download and install the Wi-Fi driver ====
 Follow the steps below to download the Wi-Fi driver:
@@ Line 49: / Line 107: @@
 ```shell
 $ 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
 $ git clone git://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git -b release/core91 --depth=1
@@ Line 63: / Line 121: @@
 $ sync
 ```
-===== Update the Wi-Fi firmware =====
-You also need to follow the steps below to update the Wi-Fi firmware:
+==== Update the Wi-Fi firmware ====
+You need to follow the steps below to update the Wi-Fi firmware:
 ```shell
@@ Line 80: / Line 139: @@
 ```
-===== Check Wi-Fi status =====
+==== Check Wi-Fi status ====
 After reboot, you can check the kernel log about the Wi-Fi driver.
@@ Line 112: / Line 171: @@
         TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
 ```
+===== Fix Bluetooth issue =====
+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 =====
+After you upgrade kernel to ''6.11+'' from [[#upgrade-your-system-kernel | Upgrade your system & kernel]] section, this issue will be fixed automatically.
 ===== Troubleshooting =====
@@ Line 120: / Line 187: @@
 ===== In the end =====
-The Linux kernel ''6.11+'' already supports the AX211 Wi-Fi module, so in the future once we get the Ubuntu official kernel update to ''6.11+'', the Wi-Fi will work and no need the steps above.
+<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+''.
-===== Update kernel =====
+See also:
+  * [[https://dgpu-docs.intel.com/driver/client/overview.html | Installing Client GPUs]]
-```shell
-wget https://kernel.ubuntu.com/mainline/v6.11.11/amd64/linux-headers-6.11.11-061111-generic_6.11.11-061111.202412051415_amd64.deb
-wget https://kernel.ubuntu.com/mainline/v6.11.11/amd64/linux-headers-6.11.11-061111_6.11.11-061111.202412051415_all.deb
-wget https://kernel.ubuntu.com/mainline/v6.11.11/amd64/linux-image-unsigned-6.11.11-061111-generic_6.11.11-061111.202412051415_amd64.deb
-wget https://kernel.ubuntu.com/mainline/v6.11.11/amd64/linux-modules-6.11.11-061111-generic_6.11.11-061111.202412051415_amd64.deb
-```
-*/

Khadas Docs

User Tools

Site Tools

Differences

Page Tools