From 0f0e90971b6da2b1a125acc1620c3d33d0f1864c Mon Sep 17 00:00:00 2001 From: Albert Y <76888457+filterpaper@users.noreply.github.com> Date: Thu, 27 Jan 2022 23:56:20 +0800 Subject: [PATCH] [Docs] OLED documentation edits (#15977) * Clarify OLED_TIMEOUT * Add a section on logo file location --- docs/feature_oled_driver.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/feature_oled_driver.md b/docs/feature_oled_driver.md index 0c926f6742..0d04f007f8 100644 --- a/docs/feature_oled_driver.md +++ b/docs/feature_oled_driver.md @@ -84,6 +84,8 @@ static void render_logo(void) { } ``` +?> The default font file is located at `drivers/oled/glcdfont.c` and its location can be overwritten with the `OLED_FONT_H` configuration option. Font file content can be edited with external tools such as [Helix Font Editor](https://helixfonteditor.netlify.app/) and [Logo Editor](https://joric.github.io/qle/). + ## Buffer Read Example For some purposes, you may need to read the current state of the OLED display buffer. The `oled_read_raw` function can be used to safely read bytes from the @@ -162,7 +164,7 @@ These configuration options should be placed in `config.h`. Example: |`OLED_FONT_END` |`223` |The ending character index for custom fonts | |`OLED_FONT_WIDTH` |`6` |The font width | |`OLED_FONT_HEIGHT` |`8` |The font height (untested) | -|`OLED_TIMEOUT` |`60000` |Turns off the OLED screen after 60000ms of keyboard inactivity. Helps reduce OLED Burn-in. Set to 0 to disable. | +|`OLED_TIMEOUT` |`60000` |Turns off the OLED screen after 60000ms of screen update inactivity. Helps reduce OLED Burn-in. Set to 0 to disable. | |`OLED_FADE_OUT` |*Not defined* |Enables fade out animation. Use together with `OLED_TIMEOUT`. | |`OLED_FADE_OUT_INTERVAL` |`0` |The speed of fade out animation, from 0 to 15. Larger values are slower. | |`OLED_SCROLL_TIMEOUT` |`0` |Scrolls the OLED screen after 0ms of OLED inactivity. Helps reduce OLED Burn-in. Set to 0 to disable. |