【写在前面】飞腾开发者平台是基于飞腾自身强大的技术基础和开放能力，聚合行业内优秀资源而打造的。该平台覆盖了操作系统、算法、数据库、安全、平台工具、虚拟化、存储、网络、固件等多个前沿技术领域，包含了应用使能套件、软件仓库、软件支持、软件适配认证四大板块，旨在共享尖端技术，为开发者提供一个涵盖多领域的开发平台和工具套件。点击这里开始你的技术升级之旅吧
本文分享至飞腾开发者平台《飞腾X100适配Ubuntu说明文档》
1 简介
本文档介绍飞腾X100芯片图形软件栈如何适配Ubuntu系统，后续介绍主要基于Ubuntu20.04系统。
注意：文档中提到的deb安装包，可联系飞腾提供，实际名称会根据版本有所不同。
- linux-image-phytium-4.19.deb： 飞腾linux内核安装包(集成了X100显示驱动)
- phytium-x100-drivers_1.1.2_ubuntu20.04_aarch64.deb：Ubuntu 20.04飞腾X100 GPU驱动安装包
2 KDE适配步骤
飞腾X100芯片图形软件栈适配KDE桌面的Ubuntu系统步骤如下：
1）安装原版arm64 ubuntu系统，如ubuntu arm64 server 20.04.2版，该版本默认没有图形界面。可制作安装U盘（rufus工具等），使用U盘安装。
注： 安装系统时，硬盘分区请选择ext4文件格式，不要选择默认的LVM格式。
2）更新系统：
sudo apt update
sudo apt upgrade3）联网安装kde桌面：
sudo apt install kubuntu-desktop4）替换phytium的4.19内核：
sudo dpkg -i linux-image-phytium-4.19.deb 注意：
a）为了使phytium 4.19内核为默认启动项，可将/boot下的5.4内核移走，然后更新grub。这样就只剩下4.19一个启动选项了。命令如下：
cd /boot
mkdir bak
mv vmlinux-5.4.0-xxx bak
update-grubb）替换phytium 4.19内核后，可能出现启动时间过长问题，解决办法如下；
i. 关闭init-cloud.service服务：
systemctl disable cloud-init-local cloud-init cloud-config cloud-final
systemctl stop cloud-init-local cloud-init cloud-config cloud-finalii. 修复固态硬盘启动等待10分钟问题：修改/lib/systemd/system/systemd-random-seed.service文件内容，将其中的TimeoutSec改为3s或更短时间
iii. 对于长时间等待“a start job is running for wait for network.. to be configued”问题，可通过禁用相关服务解决：
sudo systemctl mask systemd-networkd-wait-online.service5）安装X100 GPU驱动安装包：
sudo dpkg -i phytium-x100-drivers_1.1.2_ubuntu20.04_aarch64.deb6）重启。
3 GNOME适配步骤
1）安装原版arm64 ubuntu系统，如ubuntu arm64 server 20.04.2版，该版本默认没有图形界面。可制作安装U盘（rufus工具等），使用U盘安装。
注： 安装系统时，硬盘分区请选择ext4文件格式，不要选择默认的LVM格式。
2）更新系统：
apt update
apt upgrade3）联网安装gnome桌面：
sudo apt install ubuntu-gnome-desktop ubuntu-desktop4）替换phytium的4.19内核：
sudo dpkg -i linux-image-phytium-4.19.deb注意：
a）为了使phytium 4.19内核为默认启动项，可将/boot下的5.4内核移走，然后更新grub。这样就只剩下4.19一个启动选项了。命令如下：
cd /boot
mkdir bak
mv vmlinux-5.4.0-xxx bak
update-grubb）替换phytium 4.19内核后，可能出现启动时间过长问题，解决办法如下；
i. 关闭init-cloud.service服务：
systemctl disable cloud-init-local cloud-init cloud-config cloud-final
systemctl stop cloud-init-local cloud-init cloud-config cloud-finalii. 修复固态硬盘启动等待10分钟问题：修改/lib/systemd/system/systemd-random-seed.service文件内容，将其中的TimeoutSec改为3s或更短时间
iii. 对于长时间等待“a start job is running for wait for network.. to beconfigued”问题，可通过禁用相关服务解决：
sudo systemctl mask systemd-networkd-wait-online.service5）安装X100 GPU驱动安装包：
sudo dpkg -i phytium-x100-drivers_1.1.2_ubuntu20.04_aarch64.deb6）其它定制修改：
a）修改gdm配置，禁用xwayland: 编辑/etc/gdm3/custom.conf:
[daemon]
# Uncomment the line below to force the login screen to use Xorg
WaylandEnable=falseb）修改/etc/X11/Xwrapper.config
# If you have edited this file but would like it to be automatically updated
# again, run the following command as root:
# dpkg-reconfigure xserver-xorg-legacy
#allowed_users=console
allowed_users = anybody
needs_root_rights = yesc）此时，可正常进入gdm登录界面，但用户登录后，还是会回到登录界面。需要将用户加入到render和video组，才能正常进入桌面。
gpasswd -a test render
gpasswd -a test video7）重启。
4 常见问题
1）使用lightdm，在登录界面输入密码后，出现failed to startsession错误，无法登录进入桌面？
这是因为/usr/share/lightdm/lightdm.conf.d/40-kde-plasma-kf5.conf文件内容:
[SetDefaults]
user-session=kde-plasma-kf5其中kde-plasma-kf5与/usr/share/xsessions/目录下的plasma.desktop项不一致导致。
可将其中的kde-plasma-kf5修改为plasma，或plasma.desktop重命名为kde-plasma-kf5.desktop即可解决该问题。
2）如何设置系统默认显示管理器？
例如系统同时安装了sddm和lightdm时，需要默认显示管理器为sddm，可运行下列命令：
dpkg-reconfigure sddm3）如何设置ubuntu系统默认进入字符界面/图形界面？
为调试问题，有时需要让Ubuntu不自动进入图形界面。此时，可输入下列命令：
systemctl set-default multi-user.target如果要恢复默认进入图形界面，输入：
systemctl set-default multi-user.target graphical.target4）常用内核启动参数配置
UEFI启动时，选择引导盘后，进入grub菜单选项时，按“e”进入编辑界面，修改其中包含linux /boot/vmlinuz-4.19.0.ft+的行，可修改启动内核、增加多种内核启动参数，例如：
- 设置OS使用的cpu数目为1，添加maxcpus=1
- 进行S3睡眠时不关闭串口输出，添加no_console_suspend
- 设置内核打印信息级别，添加loglevel=7
- 禁止自动加载驱动，如禁用phytium_mci_pci驱动，添加
modprobe.blacklist=phytium_mci_pci - 强制PCI设备使用INT中断方式，添加pci=nomsi
- initcall_debug
更详细的参数配置，可参考linux内核相关文档。
为让这些配置永久生效，需要修改grub配置文件，更新grub。例如为永久增加no_console_suspend，可输入下列命令：
sudo su
vi /etc/default/grub
# 修改其中的GRUB_CMDLINE_LINUX_DEFAULT=””行,在引号中添加
no_console_suspend
update-grub #更新grub配置5）进入KDE桌面后没有声音？
进入KDE桌面后，没有声音，打开声音图标没有声卡设备。
可能原因：当前用户没有权限访问声音设备，将当前用户加入audio组后，重启。
sudo gpasswd -a test audio
sudo reboot如果还是没有找到声音设备，可通过下列命令查看声音设备：
aplay -l检查是否存在声音设备，例如对于飞腾hda声音设备，会输出：
card 0: fthda [ft-hda] ...如果存在声音设备，可运行alsamixer配置声音设备：
alsamixer如果没有找到任何声音设备，则可能声音驱动出现问题，请联系飞腾进一步分析。
推荐阅读
欢迎广大开发者来飞腾开发者平台获取更多前沿技术文档及资料
如开发者在使用飞腾产品有任何问题可通过在线工单联系我们
版权所有。飞腾信息技术有限公司 2023。保留所有权利。
未经本公司同意，任何单位、公司或个人不得擅自复制，翻译，摘抄本文档内容的部分或全部，不得以任何方式或途径进行传播和宣传。
商标声明
Phytium和其他飞腾商标均为飞腾信息技术有限公司的商标。
本文档提及的其他所有商标或注册商标，由各自的所有人拥有。
注意
本文档的内容视为飞腾的保密信息，您应当严格遵守保密任务；未经飞腾事先书面同意，您不得向任何第三方披露本文档内容或提供给任何第三方使用。
由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，飞腾在现有技术的基础上尽最大努力提供相应的介绍及操作指引，但飞腾在此明确声明对本文档内容的准确性、完整性、适用性、可靠性的等不作任何明示或暗示的保证。
本文档中所有内容，包括但不限于图片、架构设计、页面布局、文字描述，均由飞腾和/或其关联公司依法拥有其知识产权，包括但不限于商标权、专利权、著作权等。非经飞腾和/或其关联公司书面同意，任何人不得擅自使用、修改，复制上述内容。
ubuntu
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用。你还可以使用@来通知其他用户。