mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-22 14:05:15 -05:00
68 lines
2.7 KiB
ReStructuredText
68 lines
2.7 KiB
ReStructuredText
|
========================
|
|||
|
|
Hardware troubleshooting
|
|||
|
|
========================
|
|||
|
|
|
|||
|
|
|
|||
|
|
Audio doesn't work / Troubleshooting newer hardware
|
|||
|
|
---------------------------------------------------
|
|||
|
|
|
|||
|
|
|
|||
|
|
By default, the kernel that is installed in dom0 comes from the
|
|||
|
|
``kernel`` package, which is an older Linux LTS kernel. For most cases
|
|||
|
|
this works fine since the Linux kernel developers backport fixes to this
|
|||
|
|
kernel, but for some newer hardware, you may run into issues. For
|
|||
|
|
example, the audio might not work if the sound card is too new for the
|
|||
|
|
LTS kernel. To fix this, you can try the ``kernel-latest`` package –
|
|||
|
|
though be aware that it’s less tested! (See
|
|||
|
|
:ref:`here <user/advanced-topics/how-to-install-software-in-dom0:kernel upgrade>` for more
|
|||
|
|
information about upgrading kernels in dom0). In dom0:
|
|||
|
|
|
|||
|
|
.. code:: bash
|
|||
|
|
|
|||
|
|
sudo qubes-dom0-update kernel-latest
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Reboot when it’s done installing. You can double-check that the boot
|
|||
|
|
used the newer kernel with ``uname -r``, which prints the version of the
|
|||
|
|
currently-running kernel. Compare this with the output of
|
|||
|
|
``rpm -q kernel``. If the start of ``uname -r`` matches one of the
|
|||
|
|
versions printed by ``rpm``, then you’re still using the Linux LTS
|
|||
|
|
kernel, and you’ll probably need to manually fix your boot settings. If
|
|||
|
|
``uname -r`` reports a higher version number, then you’ve successfully
|
|||
|
|
booted with the kernel shipped by ``kernel-latest``.
|
|||
|
|
|
|||
|
|
"Unsupported Hardware Detected" error
|
|||
|
|
-------------------------------------
|
|||
|
|
|
|||
|
|
|
|||
|
|
See :ref:`Installation Troubleshooting <user/troubleshooting/installation-troubleshooting:"unsupported hardware detected" error>`.
|
|||
|
|
|
|||
|
|
Keyboard layout settings not behaving correctly
|
|||
|
|
-----------------------------------------------
|
|||
|
|
|
|||
|
|
|
|||
|
|
The best approach is to choose the right keyboard layout during the
|
|||
|
|
installation process. But if you want to change things afterwards, you
|
|||
|
|
can try this workaround.
|
|||
|
|
|
|||
|
|
Assuming XFCE desktop: in ``Q`` → ``System Tools`` → ``Keyboard`` →
|
|||
|
|
``Layout``, leave the checkbox “ ``Use system defaults``” checked. Do not
|
|||
|
|
customize the keyboard layout here.
|
|||
|
|
|
|||
|
|
Set the system-wide layout and options for ``xorg`` with the
|
|||
|
|
``localectl`` command in ``dom0``. You can use ``localectl --help`` as a
|
|||
|
|
starting point.
|
|||
|
|
|
|||
|
|
Example: ``localectl set-x11-keymap us dell ,qwerty compose:caps``.
|
|||
|
|
|
|||
|
|
This generates the appropriate configuration in
|
|||
|
|
``/etc/X11/xorg.conf.d/00-keyboard.conf``. This file is auto-generated.
|
|||
|
|
Do not edit it by hand, unless you know what you are doing.
|
|||
|
|
|
|||
|
|
Restarting ``xorg`` is required. The most straightforward way is to
|
|||
|
|
reboot the system.
|
|||
|
|
|
|||
|
|
More information in `this discussion <https://groups.google.com/d/topic/qubes-devel/d8ZQ_62asKI/discussion>`__
|
|||
|
|
and `this GitHub issue <https://github.com/QubesOS/qubes-issues/issues/1396>`__.
|