Merge pull request #61 from chrizzo-hb/main

Here's more on everyone's favorite topic: BATTERY DRAIN! (Yay!)

Author: chrizzo-hb

docs/faq/troubleshooting.md

@@ -95,13 +95,16 @@ A: Most bezel decorations are made for screens with an aspect ratio of 16:9. Con
     Due to the reasons explained below, it is **not helpful at all** to report battery issues based on the **displayed percentage**. Telling us that your battery lost 10% of battery while the device was turned off **does not help**, because **you cannot possibly know** if that number is even correct.
     Currently, the **only** valid way to investigate your battery issues with KNULLI is to watch the **power indicator LED** of your device and measure the time it takes for the device to drain completely. E.g., when investigating sleep mode efficiency, **charge the device fully**, put it in sleep mode and see how long it takes for the device to **drain completely**.
 
-A: To our knowledge, there is no difference between the the efficiency of sleep modes between Knulli and the Anbernic stock OS. If you perceive that your device discharges too fast, there's a variety of factors which might be at play here:
+A: To our knowledge, there is no difference between the the efficiency of sleep modes between KNULLI and the **initial version** of the Anbernic stock OS. However, experiments indicate that the **improved** stock OS sleep mode performs **better** than the the sleep mode provided by KNULLI. Since Anbernic does not make their source code available, our developers are still examining the stock OS to determine, what changes they made to further improve their sleep mode. Until we figure this out, KNULLI will only provide the regular sleep mode which consumes about 5% of battery charge per hour.
+
+If you perceive that your device discharges too fast, there's a variety of factors which might be at play here:
 
 * The **battery indicator** of **Emulation Station** (the KNULLI frontend) has a **bug** which causes it to get **stuck** sometimes. It is a **known issue** that is being worked on. However, until the issue is fixed, you **cannot rely** on the **accuracy** of the displayed **battery percentage**. Restarting the device or updating gamelists might temporarily fix the issue, however, it will happen again.
 * The battery percentage that can be read from the **battery drivers** sometimes gives inaccurate readings. Our developers noticed that sometimes the battery percentage reported directly from the battery makes rather large jumps, e.g., from 93% directly to 100% when charging. Consequently, even if your battery indicator is **not** stuck, the displayed battery percentage might still be **a little inaccurate**.
-* The **sleep mode** on the Anbernic devices of that series is very **inefficient**, especially compared to modern smartphones or similar devices:
+* The regular **sleep mode** provided by the kernel for the Anbernic devices of that series is very **inefficient**, especially compared to modern smartphones or similar devices:
      * It applies a simple **suspend to RAM**, which means that many components of the device are shut off, but the entire state of the device is kept in **RAM** (Random Access Memory). Consequently, the device will still require some power to keep the RAM active.
      * The Anbernic devices of that series consume a lot of power to maintain the RAM in sleep mode, which is why you might notice a **discharge** of about **5% per hour**, so you cannot put the device to sleep indefinitely.
+     * The **improved sleep mode** seems to save more power, however, it is still unknown to us how this is achieved.
      * A more efficient power management could be achieved by implementing **suspend to disk**, which would keep the state of the device in a **persistent memory**, such as a hard disk or an SD card. The device would be able to **power off completely**, therefore saving much more battery charge. However, the custom kernel provided by Anbernic for the devices of that series only allows **Suspend to RAM**. We will not be able to provide a **suspend to disk** implementation until the Anbernic devices of that series are supported by the mainline Linux kernel.
 * It is possible that your battery **discharges a little** even when the device is **turned off** completely. It might be a **self-preservation mechanism** built into the battery to make sure that it doesn't stay charged at 100% for too long.
 * If you perceive that your device drains all battery charge within a day or less despite being turned off, the device most likely was **not** turned off but only in **sleep mode**.