From da6c8265b7eb41128a86c03347e26c6f8ad216ff Mon Sep 17 00:00:00 2001 From: Aditya Garg Date: Sat, 14 Oct 2023 17:14:02 +0530 Subject: [PATCH] Add instructions for tiny-dfr on Ubuntu --- docs/distributions/debian/installation.md | 8 ++++++++ docs/distributions/ubuntu/installation.md | 6 ++++++ docs/guides/postinstall.md | 24 +++++++++++------------ 3 files changed, 25 insertions(+), 13 deletions(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index b540b16de..41bae7ed6 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -88,6 +88,14 @@ After installation, we need to install a kernel having patches to support the T2 7. Follow the [Wi-Fi guide](https://wiki.t2linux.org/guides/wifi-bluetooth/) to get internal Wi-Fi working. +8. If your Mac has a Touch Bar, install `tiny-dfr` by running: + + ```bash + sudo apt install tiny-dfr + ``` + + **Note:** Make sure you restart your Mac after installing `tiny-dfr`. In order to configure your Touch Bar, run `sudo touchbar` and follow the on-screen instructions. + # Basic set up After installing the new kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You shall mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-paramaters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. Rest have been set up automatically by the kernel upgrade script. diff --git a/docs/distributions/ubuntu/installation.md b/docs/distributions/ubuntu/installation.md index 33a765125..c9fb4bd76 100644 --- a/docs/distributions/ubuntu/installation.md +++ b/docs/distributions/ubuntu/installation.md @@ -30,6 +30,12 @@ In order to continue receiving the kernel updates for T2 kernels, it's recommended to set up the kernel update script as described [here](https://github.com/t2linux/T2-Ubuntu-Kernel#using-the-kernel-upgrade-script). +# Configuring the Touch Bar + +If your Mac has a Touch Bar, then you can install the `tiny-dfr` app by running `sudo apt update && sudo apt install tiny-dfr` to set up the Touch Bar. Make sure you restart your Mac after installing the app. + +For configuration of the Touch Bar, run `sudo touchbar` and follow the on-screen instructions. + # Troubleshooting If you are facing issues while installing or have post installation issues (E.g.: Wi-Fi, sound etc.), refer to the [FAQ](https://wiki.t2linux.org/distributions/ubuntu/faq/) section first. If it is not able to help you, you may open an issue [here](https://github.com/t2linux/T2-Ubuntu/issues) or contact us on the [Discord server](https://discord.com/invite/68MRhQu). diff --git a/docs/guides/postinstall.md b/docs/guides/postinstall.md index 3ed799203..ef9758ad9 100644 --- a/docs/guides/postinstall.md +++ b/docs/guides/postinstall.md @@ -90,24 +90,22 @@ The steps to be followed vary depending upon the initramfs module loading mechan ## Setting up the Touch Bar -The Touch Bar can be set up by running [this script](../tools/touchbar.sh) **in Linux** using `bash /path/to/script`. Make sure your Linux kernel and macOS is updated before running this script. +Setting up the Touch Bar is different for Ubuntu and Debian based distros. -If you want to try something new and you're using Arch Linux, EndeavourOS, or Manjaro, you could install `touchbard` package and use that instead. For more information, visit [touchbard repository](https://github.com/NoaHimesaka1873/touchbard). +If you are using an Ubuntu or Debian based distro: -After running this script, if you wish to change the default mode of the Touch Bar, run `sudo touchbar` and choose the mode you wish. + 1. Add the apt repo for T2 Macs from [here](https://github.com/AdityaGarg8/t2-ubuntu-repo.git). + 2. Install `tiny-dfr` by running `sudo apt install tiny-dfr`. + 3. Restart your Mac. + 4. After restarting, you can run `sudo touchbar` to get a list of options that you can configure. Simply follow the on-screen instructions. -In case your Touch Bar is unable to change modes on pressing the fn key, you could try the following: +For other distros: -- Try running the following and rebooting. - - ```sh - echo -e "# delay loading of the touchbar driver\ninstall apple-touchbar /bin/sleep 7; /sbin/modprobe --ignore-install apple-touchbar" | sudo tee /etc/modprobe.d/delay-tb.conf >/dev/null - ``` - -- Boot into the [macOS Recovery](https://support.apple.com/en-gb/HT201314) and then restart into Linux. -- Unplug all the external USB keyboards and mouse and then restart into Linux, keeping them unplugged. + - The Touch Bar can be set up by running [this script](../tools/touchbar.sh) **in Linux** using `bash /path/to/script`. Make sure your Linux kernel and macOS is updated before running this script. -If you still face an issue, mention it [here](https://github.com/t2linux/wiki/issues) or on the discord. + - After running this script, if you wish to change the default mode of the Touch Bar, run `sudo touchbar` and choose the mode you wish. + + - If you want to try something new and you're using Arch Linux, EndeavourOS, or Manjaro, you could install `touchbard` package and use that instead. For more information, visit [touchbard repository](https://github.com/NoaHimesaka1873/touchbard). # Wi-Fi and Bluetooth