Skip to content

Commit

Permalink
Merge pull request #166 from chrultrabook/faqqqqqqqqqqqqqqqqqqqqqqqqq…
Browse files Browse the repository at this point in the history
…qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq

Update faq
  • Loading branch information
WeirdTreeThing authored Jun 24, 2024
2 parents c7da513 + 3236d6e commit 8658cdd
Showing 1 changed file with 78 additions and 55 deletions.
133 changes: 78 additions & 55 deletions src/docs/faq.md
Original file line number Diff line number Diff line change
@@ -1,88 +1,111 @@
# FAQ

::: tip
Please read this page before asking a question in the Discord. Your help request will be ignored if the answer is found on the FAQ.
Please read this page before asking for help. Your help request will be pointed to the docs otherwise.
:::

#### Can I pay for Windows drivers using PayPal?
* You can pay via PayPal in Patreon.
## General questions

#### How do I buy the Windows audio/Thunderbolt drivers?
* Please see [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html) for a step by step tutorial on purchasing drivers.
### What OS should I use?
* This depends on your use case. Only you can answer this question. <!-- Not ubuntu plz -->

#### Can I get AVS or SOF drivers for free?
* No. Only the Linux drivers are free.

#### How come audio isn't working on Ubuntu / Ubuntu forks?
* Ubuntu and Ubuntu-based distros may have issues, try switching to another distro.
### Should I use rw-legacy or full rom?
* This depends on what you're looking to use your device for. If you are planning on installing Windows or macOS you need to use full rom. Rw-legacy only supports linux.

#### What Linux distros are recommended?
* See [this page](installing/installing-linux.md).
### My internal keyboard doesn't work, can I use an external keyboard to get into developer mode?
* No. The hotkeys will only work on the internal keyboard. Chromeboxes do not have this restriction.

#### Why is there a license error in Device Manager after installing audio drivers?
* You messed up the license setup. Please refer to [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html).
### 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 (RW_LEGACY firmware) and use that.

### Can I disable power-on when I open my Chromebook?
* No. In what situation would you open your Chromebook without the intention of turning it on anyways.

### My Chromebook powers back on when I turn it off. How can I fix this?
* You don't. Specific Chromebooks have this bug which takes too much effort to debug. If you were looking to disable power-on when you open the lid because of this, they are completely unrelated.

### 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.

### 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.

### I'm running Legacy boot firmware now - can I switch to the UEFI firmware?
* If you're using SeaBIOS, you will likely need to re-install your operating system. Otherwise it should work fine.

### Help! I can't exit Developer Mode!
* If you're trying to exit Developer Mode but get the error `WARNING: TONORM prohibited by GBB_FORCE_DEV_SWITCH_ON` or find the `Return to secure mode` button missing, you need to reset your GBB flags. You can do that by running [MrChromebox's firmware utility script](https://mrchromebox.tech/#fwscript) and selecting `3) Set Boot Options (GBB flags)`, followed by `5) Reset to factory default`.
* Then exit developer mode by choosing "Return to secure mode" on the bootup screen

### Can I modify the fan speed?
* Yes, using ectool. To set the fan to auto, run: `ectool autofanctrl`. To specify a percentage, run `ectool fanduty [0-100]`.

#### Can I hackintosh my Celeron/Pentium CPU?
### Can I overclock the fan?
* No.

#### What OS should I use?
* This depends on your use case. Only you can answer this question. <!-- Not ubuntu plz -->
### I want to buy a Chromebook to run Windows or Linux or macOS -- which should I buy?
* Any 64 bit Chromebook should work in Windows and Linux. Some require paid drivers (Windows only). For information on macOS requirements, see [this page](installing/installing-macos.md).

<br>

#### My internal keyboard doesn't work, can I use an external keyboard to get into developer mode?
* No. The hotkeys will only work on the internal keyboard.
## Windows questions

#### Should I use Windows 10 or 11?
### Should I use Windows 10 or 11?
* Windows 11 is required for TB4 users. If you don't have Thunderbolt 4, you may use both 10 or 11.

#### Will the audio driver still work when re-installing Windows?
* Yes, on the device the license was created. If the internal drive was replaced, see below.
### Can I pay for Windows drivers using PayPal?
* You can pay via PayPal in Patreon.

#### I upgraded my Chromebooks' internal drive and my audio/Thunderbolt 4 license is not working, what do I do?
* The license is tied to the serial number of your internal drive. **You do not need to buy another license**. Send CoolStar a message through Patreon, and wait for about a week.
### My balance shows zero on coolstars portal, what should I do?
* It may take up to 48 hours for balance to appear in her portal, though it is normally less then 2.

#### How do I buy Windows audio drivers in bulk?
* A discount is only available for Chromebooks containing an `Intel 6th gen processor (up to Core i5)`, `N3350`, `N4000`, or, `N4020` processor, otherwise you must pay full price. You must purchase 10 or more licenses to be eligible for a discount. If you are eligible for a discount, you should ask in the [Chrultrabook Forum](https://forum.chrultrabook.com).
### How do I buy the Windows audio/Thunderbolt drivers?
* Please see [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html) for a step by step tutorial on purchasing drivers.

#### Can I use one driver license across multiple devices?
* No. One license per device.
### Can I get AVS or SOF drivers for free?
* No. Only the Linux drivers are free.

#### 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. -- 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.
### Why is there a license error in Device Manager after installing audio drivers?
* You messed up the license setup. Please refer to [CoolStar's driver portal](https://coolstar.org/chromebook/driverlicense/login.html).

#### How can I get audio working under Linux?
* Please see [here](https://github.com/WeirdTreeThing/chromebook-linux-audio)
### Will the audio driver still work when re-installing Windows?
* Yes, on the device the license was created. If the internal drive was replaced, see below.

#### How do I get my top row keys on Linux to act like how they did on chromeOS?
* Follow the instructions [here](https://github.com/WeirdTreeThing/cros-keyboard-map).
### I upgraded my Chromebooks' internal drive and my audio/Thunderbolt 4 license is not working, what do I do?
* The license is tied to the serial number of your internal drive. **You do not need to buy another license**. Send CoolStar a message through Patreon, and wait for about a week.

#### 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 (RW_LEGACY firmware) and use that.
### Can I use one driver license across multiple devices?
* No. One license per device.

#### 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.
<br>

#### 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.
## Linux Questions

#### I'm using your UEFI firmware, installed my OS [Linux], and it still boots to the EFI shell - what do I do?
* Sounds like your Linux distro doesn't install the EFI bootloader in the default location - no worries, it's an easy fix:
* Type `exit` to return to the UEFI settings menu, then select Boot Maintenance Manager. From there, select Boot From File, then navigate to and boot from `/EFI/[distro name]/grubx64.efi` (where [distro name] will be fedora, arch, debian, etc). Once your OS is booted, open a terminal/shell, and type the following (observing case):
### How come audio isn't working on Ubuntu / Ubuntu forks?
* Ubuntu and Ubuntu-based distros may have issues and are not supported, try switching to another distro. Debian is a great alternative if you are used to Ubuntu.

* `sudo su`
* `mkdir -p /boot/efi/EFI/BOOT`
* `cp /boot/efi/EFI/[distro name from above]/grubx64.efi /boot/efi/EFI/BOOT/BOOTX64.efi`
### Why are Ubuntu/Ubuntu based distros not supported?
* They consistently break packages.
* They have started to force snap on their users.
* They have published an LTS distro with a non-LTS kernel.

* Then reboot to test. What we're doing is copying the grub EFI boot stub from the OS installed location to the location the firmware is expecting (/EFI/BOOT/BOOTX64.efi) on the EFI system partition (ESP), which most (Debian/Ubuntu-based?) distros will mount at /boot/efi. You may need to adjust slightly for your distro, but these instructions should work in most cases.
Becuse of these things, Ubuntu is unsupported. We will not help you fix issues on Ubuntu.

#### I'm running Legacy boot firmware now - can I switch to the UEFI firmware?
* You can, but your existing OS install won't boot. You'll need to either reinstall the OS (often the easiest course of action), or you can attempt to migrate your existing install, but this isn't ideal and should be considered unsupported.
### What Linux distros are recommended?
* See [this page](installing/installing-linux.md).

#### Help! I can't exit Developer Mode
* If you're trying to exit Developer Mode but get the error `WARNING: TONORM prohibited by GBB_FORCE_DEV_SWITCH_ON` or find the `Return to secure mode` button missing, you need to reset your GBB flags. You can do that by running [MrChromebox's firmware utility script](https://mrchromebox.tech/#fwscript) and selecting `3) Set Boot Options (GBB flags)`, followed by `5) Reset to factory default`.
* Then exit developer mode by running `sudo crossystem disable_dev_request=1; reboot`
### How can I get audio working under Linux?
* Please see [this GitHub repo](https://github.com/WeirdTreeThing/chromebook-linux-audio)

#### Can I modify the fan speed?
* Yes, using ectool. To set the fan to auto, run: `ectool autofanctrl`. To specify a percentage, run `ectool fanduty [0-100]`.
### How do I get my top row keys on Linux to act like how they did on chromeOS?
* Follow the instructions [in this GitHub repo](https://github.com/WeirdTreeThing/cros-keyboard-map).

<br>

#### Can I overclock the fan?
## Hackintosh questions

### Can I hackintosh my Celeron/Pentium CPU?
* No.

### Can I hackintosh an AMD CPU?
* In theory, it might be possible. It has never been tested, and can be considered unsupported.

0 comments on commit 8658cdd

Please sign in to comment.