Merge pull request #58 from chrultrabook/revert-55-main

Revert "08.2023 rewrite"
chrultrabook · Aug 26, 2023 · 34fd6cd · 34fd6cd · github-actions · Aug 26, 2023
2 parents 097f34b + 822ab11
commit 34fd6cd
Show file tree

Hide file tree

Showing 19 changed files with 41 additions and 462 deletions.
diff --git a/.github/actions/spelling/allow.txt b/.github/actions/spelling/allow.txt
@@ -578,32 +578,3 @@ GPIO
 meghann
 Ximimark
 Yourfilename
-AMDGPU
-ASUS
-autofanctrl
-bootableusb
-BSOD
-bugzilla
-cgi
-choie
-cmdline
-crosec
-Devirtualize
-driverinstallers
-instructionaly
-iommu
-Mimo
-newner
-oneshot
-overclock
-pmc
-QOL
-redhat
-rmmod
-sbin
-systemctl
-systemd
-TARLO
-typec
-usbc
-USBs
diff --git a/.github/workflows/spelling.yml b/.github/workflows/spelling.yml
@@ -64,4 +64,7 @@ jobs:
       with:
         checkout: true
         spell_check_this: check-spelling/spell-check-this@prerelease
-        task: ${{ needs.spelling.outputs.followup }}
+        task: ${{ needs.spelling.outputs.followup }}
+
+# Removed PR portions to make bot shut the hell up 
+#  - meghan6
diff --git a/docs/advanced.md b/docs/advanced.md
diff --git a/docs/allaboutfirmware.md b/docs/allaboutfirmware.md
@@ -7,15 +7,6 @@ nav_order: 8
 
 ## All About Firmware
 
-### Terminology 
-
-| **Term** | **Description** |  
-| - | - |
-| coreboot     | UEFI firmware firmware replacement |  
-| UEFI         | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) |  
-| EC           | Embedded Controller. Communicates between the main board and embedded peripherals such as hotkeys, ports, or battery.  
-
-
 ### Firmware Types
 
 ----------------------

diff --git a/docs/altos.md b/docs/altos.md
@@ -17,8 +17,8 @@ Pros:
 * Better game support
 
 Cons: 
-* Audio driver is paid (10 USD) for Skylake (6th generation) and newer devices
-* Thunderbolt driver is paid (20 USD) for certain generations
+* Audio driver is paid (10 USD)
+* Thunderbolt driver is paid (20 USD)
 * Requires the user to install many drivers
 * AVS and SOF users experience instability at times
 

diff --git a/docs/bootableusb.md b/docs/bootableusb.md
diff --git a/docs/compiling-coreboot.md b/docs/compiling-coreboot.md
@@ -2,7 +2,6 @@
 title: Compiling Custom Firmware
 layout: default
 nav_order: 18
-parent: Advanced
 ---
 
 ### Cloning & Building ROMs

diff --git a/docs/debugging.md b/docs/debugging.md
@@ -2,7 +2,6 @@
 title: Debugging
 layout: default
 nav_order: 17
-parent: Advanced
 ---
 
 ## Debugging
@@ -11,15 +10,6 @@ This page has instructions on using multiple different utilities to debug issues
 
 -----------
 
-### Grabbing Logs
-
-* If you're experiencing firmware bugs, provide output from `cbmem` console.
-* If you're experiencing issues with Linux, provide output from `dmesg`, `dmidecode` and `journalctl` or `/var/log/messages`, respectively
-* Ift you're experiencing issues with Windows, provide screenshots from Device Manager, Event Viewer, coredumps etc.
-* If you're experiencing issues with macOS, please ask for help in the Chrultrabook Discord, in the #hackintosh channel. 
-
------------
-
 ### Firmware
 
 To debug firmware, you will need the following tools:

diff --git a/docs/distros.md b/docs/distros.md
@@ -2,7 +2,6 @@
 title: Distro Specific Configuration
 layout: default
 nav_order: 23
-parent: Advanced
 ---
 
 

diff --git a/docs/faq.md b/docs/faq.md
@@ -54,16 +54,16 @@ Please read this page before asking a question in the Discord. Your help request
 * No. One license per device.
 
 **I want to buy a Chromebook to run Windows or Linux or macOS -- which should I buy?**
-* Buying any Chromebook with the intention of running macOS, Windows or Linux is not a great idea.s -- DO NOT EXPECT EVERYTHING TO WORK OUT OF THE BOX. Older models may fair better compatibility wise, but there are still lots of caveats, and it's not recommended to buy a Chromebook as a cheap Linux device.
+* Buying any Chromebook with the intention of running macOS, Windows or Linux is not a great idea. Many can't boot anything other than ChromeOS; Those that can boot Linux (or Windows) often have functional deficiencies -- DO NOT EXPECT EVERYTHING TO WORK OUT OF THE BOX. Older models may fair better compatibility wise, but there are still lots of caveats, and it's not recommended to buy a Chromebook as a cheap Linux device.
 
 **How can I get audio working under Linux?**
 * Please see [here](https://github.com/WeirdTreeThing/chromebook-linux-audio)
 
 **I just want to boot Linux from USB on my Chromebook, what do I need to do?**
-* Check the Supported Devices page, to ensure your device has functional RW_LEGACY firmware available. If so, flash RWL and use that.
+* Check the Supported Devices page, to ensure your device has functional RW_LEGACY firmware available. If so, then simply put your device into Developer Mode, then run my script and update the RW_LEGACY firmware (no need to disable the firmware write protect for this). Reboot, press CTRL+L to boot in Legacy Boot Mode/Alternative Bootloader Menu, then press ESC and select your USB from the boot menu.
 
 **I just installed the UEFI firmware, and now my device boots to a black screen that says 'shell' - what do I do?**
-* You're in the EFI shell; the firmware boots there when it can't find a valid UEFI boot device, either externally (USB, SD) or internally. Just type 'exit' to get back to the the UEFI settings menu.
+* You're in the EFI shell; the firmware boots there when it can't find a valid UEFI boot device, either externally (USB, SD) or internally. Just type 'exit' to get back to the the UEFI settings menu, from which you can select your boot device or reboot. You need to install a UEFI-boot capable OS from a properly formatted USB/SD device. If you're creating the install media from Windows, use Rufus to write the ISO to USB. If writing a Windows ISO, select the ISO, then set the Partition scheme to 'MBR for UEFI' or 'GPT for UEFI;' 'MBR for UEFI-CSM' will not work since CSM = Legacy BIOS and the UEFI firmware doesn't support Legacy mode. For a Linux ISO, select the ISO, then change the write mode from 'ISO Image' to 'DD Image' from the drop-down menu. As most Linux ISO images these days are compatible with both Legacy and UEFI booting, this ensures maximum compatibility.
 
 **Should I install 32 or 64-bit OS?**
 * The UEFI Full ROM firmware only supports 64-bit OS, so be sure to use the 'x86_64' version of whatever OS you want to install. USB media created from 32-bit ISOs will simply fail to boot.

diff --git a/docs/firmware.md b/docs/firmware.md
@@ -4,14 +4,6 @@ layout: default
 nav_order: 9
 ---
 
-### Terminology
-
-| **Term** | **Description** |  
-| - | - |
-| SuzyQable    | A cable that enables CCD (Closed Case Debug). Used to disable WP. | 
-
-
-
 **Flashing Custom Firmware**
 
 Refer to [here](allaboutfirmware.html) for an overview of both RW_LEGACY and UEFI.
@@ -37,7 +29,6 @@ To convert your machine from Google's firmware and chromeOS to Coreboot and AltO
         * Undo a WP screw
         * Unplug your battery
         * Bridge two jumpers
-        * Plug in a SuzyQable  
 
 3. Run [MrChromebox's firmware utility script.](https://mrchromebox.tech/#fwscript)
     * Type `cd; curl -LO mrchromebox.tech/firmware-util.sh && sudo bash firmware-util.sh` and press Enter.
@@ -50,19 +41,15 @@ To convert your machine from Google's firmware and chromeOS to Coreboot and AltO
 
 **Updating coreboot**
 
-1. Boot a live Linux USB. See [here](bootableusb.html) for a guide on making a bootable USB. 
+1. Boot a Linux live USB (Ubuntu 22.04 recommended)
 
   {: .note }
   curl is not installed by default for Ubuntu / Ubuntu distros. To install it, run: `sudo apt update;sudo apt install curl -y`
 
-2. Once you have booted the live USB, **do not install the OS. Some distros may have the option to "try now" click that.**
-
-3. Connect to the internet. Then open a terminal.
-
-4. Run the same firmware utility script you used to install coreboot
+2. Run the same firmware utility script you used to install coreboot
    * In case you forgot, type `cd; curl -LO mrchromebox.tech/firmware-util.sh && sudo bash firmware-util.sh` and press Enter.
 
-5. Pick option 1; "Install/Update UEFI (Full ROM) Firmware" and reboot if successful
+3. Pick option 1; "Install/Update UEFI (Full ROM) Firmware" and reboot if successful
 
 -------
 

diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -5,14 +5,7 @@ nav_order: 4
 ---
 
 ## Getting Started
-
-### Terminology 
-
-| **Term** | **Description** |  
-| - | - |
-| chrultrabook | A modified Chromebook/box designed to run Windows, Linux, or even macOS |   
-| coreboot     | UEFI firmware firmware replacement |  
-| UEFI         | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) |  
+Before we begin, we need to go over a few things.
 
 -------------
 
@@ -52,6 +45,14 @@ If you are facing a issue, please read the [FAQ](faq.html) first.
 **Do not use manufacturer's model name or serial number when asking for help** (i.e: HP Chromebook 14a), it doesn't help with identifying the machine. Provide the boardname, otherwise your support request will be ignored. If you don't know where to find your boardname, take a look [here.](system-info.html)
 
 
+### Provide logs.
+
+* If you're experiencing firmware bugs, provide output from `cbmem` console.
+* If you're experiencing issues with Linux, provide output from `dmesg`, `dmidecode` and `journalctl` or `/var/log/messages`, respectively
+* Ift you're experiencing issues with Windows, provide screenshots from Device Manager, Event Viewer, coredumps etc.
+* If you're experiencing issues with macOS, please ask for help in the Chrultrabook Discord, in the #hackintosh channel. 
+
+See the [Debugging Page](debugging.html) for instructions on how to get these logs.
 
 --------------
 

diff --git a/docs/installing-linux.md b/docs/installing-linux.md
@@ -17,21 +17,22 @@ Only Linux kernel 6.1 LTS or newer is supported.
 {: .warning } 
 Ubuntu and Ubuntu-based distributions, such as Mint or ElementaryOS are unsupported.
 
-**Recommended distros as of August 2023 (in no particular order) are:**
+**Recommended distros as of June 2023 (in no particular order) are:**
 
 * Arch Linux
 * Fedora
 * OpenSUSE Tumbleweed
+* Pop!_OS
 * Debian 12 (Bookworm)
 
 ----------------
 
 
 ### Installation:
 
-1. Create a bootable Linux USB. See [here](bootableusb.html) for a guide.
+1. Create a bootable Linux USB. Ubuntu and Ubuntu based distros have outdated packages and thus are not supported.
 2. Plug the USB Drive into the Chromebook.
-3. Turn on the Chromebook, press `ESC` at the POST screen (when the boot logo appears), and select your USB to boot from. 
+3. Turn on the Chromebook, press `ESC` at the POST screen, and select the USB to boot from. 
 4. Install as you would on any other computer.
 
 
@@ -43,17 +44,9 @@ Ubuntu and Ubuntu-based distributions, such as Mint or ElementaryOS are unsuppor
  {: .warning }
  Using AVS on a device with max98357a will blow your speakers. You have been warned. 
 
-**Prerequisites**
-- Python 3.10 or newner
-- Git
+<br>
 
-**Installation**
-0. Open a terminal.
-1. `git clone https://github.com/WeirdTreeThing/chromebook-linux-audio`
-2. `cd chromebook-linux-audio`
-3. `./setup-audio`
-
-For more information please see [WeirdTreeThing's repo](https://github.com/WeirdTreeThing/chromebook-linux-audio)
+1. Run WeirdTreeThing's [audio script.](https://github.com/WeirdTreeThing/chromebook-linux-audio)
 
 {: .fs-5 }
 

diff --git a/docs/installing-macos.md b/docs/installing-macos.md
@@ -27,11 +27,6 @@ Before we begin, it's important to know whether your Chromebook is even supporte
 ### Known Issues
 
 - Broken NVRAM on Comet Lake Devices
-   - To fix this, **DISABLE** `DevirtualizeMimo`.
-   {: .warning}
-   If your device has a Comet Lake CPU, this MUST be disabled.
-
-
 - Waking from sleep causes:
    - Blank Electron / Chromium apps
    - Buggy video playback in web browsers like Firefox or Safari

diff --git a/docs/known-issues.md b/docs/known-issues.md
@@ -40,15 +40,14 @@ You should avoid buying any devices in this list.
 * No fingerprint reader support
 * No TPM support
 * No IPU camera support
-* OS will BSOD with AVS/SOF driver installer when transitioning from sleep 
 
 
 ### Linux
 
-* Broken USB-C on TigerLake and AlderLake. See Post Install -> Linux for fix.
+* Broken USB-C on TigerLake and AlderLake (although there is a workaround)
 * No fingerprint reader support
 * Sandybridge/Ivybridge need a [workaround](https://github.com/MrChromebox/scripts/issues/277) to flash firmware from linux.
-* PopOS and Debian 12 Bookworm need a custom kernel 
+
 
 ### macOS
 

diff --git a/docs/post-install.md b/docs/post-install.md
@@ -8,11 +8,8 @@ nav_order: 16
 
 
 ### Windows
-
-** Drivers and QOL improvements**
 * Compress the install with `compact.exe /compactos:always` in a Command Prompt with admin privileges if necessary.
-* Install [CoolStar's drivers](https://coolstar.org/chromebook/windows-install.html) if you haven't already
-* Buy audio drivers (if needed), see [the guide](csdriver.html) 
+* Install [CoolStar's drivers](https://coolstar.org/chromebook/windows-install.html) if you haven't already 
 
 **CELES Post Install Workaround**
 
@@ -25,39 +22,18 @@ nav_order: 16
 
 
 ### Linux
-
-**General QOL Fixes**
-
 * Run the [audio script](https://github.com/WeirdTreeThing/chromebook-linux-audio) if you haven't already.
 * Install [keyd](https://github.com/rvaiya/keyd) with the instructions in the README to remap top row FX keys.
   * Pick the relevant [keyboard layout](https://github.com/chrultrabook/keydconfig) and copy to `/etc/keyd/default.conf`
 
-**Fixing USB C on TigerLake and AlderLake**
-1. Create a file called `chromebook-usbc.service` file in `/etc/systemd/system/`
-2. Paste the following contents into the file:
-
-    ```
-   [Unit]
-   Description=Enable USB-C on chromebook
-   
-   [Service]
-   Type=oneshot
-   RemainAfterExit=yes
-   ExecStartPre=/sbin/modprobe -r -a cros-ec-typec intel-pmc-mux
-   ExecStart=/sbin/modprobe -a intel-pmc-mux cros-ec-typec
-   
-   [Install]
-   WantedBy=multi-user.target
-   ```
-3. Enable the systemd service by typing `systemctl enable  --now chromebook-usbc.service`, then reboot.
 
 -----------------------
 
 
 ### macOS 
 * [Remove Verbose](https://dortania.github.io/OpenCore-Post-Install/cosmetic/verbose.html#macos-decluttering)
 * [OpenCore GUI](https://dortania.github.io/OpenCore-Post-Install/cosmetic/gui.html#setting-up-opencore-s-gui)
-* Disable `DevirtualizeMimo` if you're on CML (CometLake, 10th generation)
+* [Setup Emulated NVRAM](https://dortania.github.io/OpenCore-Post-Install/misc/nvram.html) if necessary.
 
 
 <br>