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

Next revision
Previous revision
products:maker-kit:mind-2-ai-maker-kit:troubleshooting:fix-ubuntu [2024/12/30 04:40]
nick created
products:maker-kit:mind-2-ai-maker-kit:troubleshooting:fix-ubuntu [2025/02/20 22:01] (current)
nick
Line 2: Line 2:
  
  
-====== Fix Ubuntu Wi-Fi ======+====== Fix Ubuntu 24.04.1 issues ======
  
-For some reasons current Ubuntu ''22.04/24.04'' LTS with Linux kernel ''6.8'' doesn't support the Intel AX211 Wi-Fi moduleso you need to use +<WRAP important > 
-the [[https://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git/ | backport-iwlwifi]] driver to make the Wi-Fi work.+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 itcurrent known issues list below: 
 + 
 +  * AX211 Wi-Fi doesn'work 
 +  * AX211 Bluetooth doesn't work 
 +  * HDMI sound card doesn't work 
 +  * GPU doesn't work 
 + 
 +This documentation will guide you to fix these issues.
  
 ===== 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.
Line 22: Line 38:
 $ sudo apt update $ sudo apt update
 $ sudo apt full-upgrade -y $ 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
 +```
 +
 +Add user to ''render'' group and  reboot the device:
 +
 +```shell
 +$ sudo gpasswd -a ${USER} render
 +$ newgrp render
 $ sync $ sync
 $ sudo reboot $ 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: Follow the steps below to download the Wi-Fi driver:
Line 31: 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 45: Line 121:
 $ sync $ 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 ```shell
Line 62: Line 139:
 ``` ```
  
-===== Check Wi-Fi status =====+==== Check Wi-Fi status ====
  
 After reboot, you can check the kernel log about the Wi-Fi driver. After reboot, you can check the kernel log about the Wi-Fi driver.
Line 94: Line 171:
         TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0         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 ===== ===== Troubleshooting =====
Line 102: Line 187:
 ===== In the end ===== ===== In the end =====
  
-The Linux kernel ''6.11+'' already supports the AX211 Wi-Fi moduleso 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 aboveyou 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 
-``` 
  
-*/ 
Last modified: 2024/12/30 04:40 by nick