2024-05-30 02:02:10 +00:00
<!DOCTYPE html>
< html lang = "en-US" dir = "ltr" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width,initial-scale=1" >
< title > OLED Driver | QMK Firmware< / title >
< meta name = "description" content = "Documentation for QMK Firmware" >
< meta name = "generator" content = "VitePress v1.1.3" >
2024-05-31 00:38:24 +00:00
< link rel = "preload stylesheet" href = "/assets/style.No8zk9aC.css" as = "style" >
2024-05-30 02:02:10 +00:00
2024-06-02 02:43:43 +00:00
< script type = "module" src = "/assets/app.DQznqO_F.js" > < / script >
2024-05-30 02:02:10 +00:00
< link rel = "preload" href = "/assets/inter-roman-latin.Di8DUHzh.woff2" as = "font" type = "font/woff2" crossorigin = "" >
< link rel = "modulepreload" href = "/assets/chunks/framework.DyMmIvSC.js" >
2024-06-02 02:43:43 +00:00
< link rel = "modulepreload" href = "/assets/chunks/theme.BbG4GfFx.js" >
< link rel = "modulepreload" href = "/assets/features_oled_driver.md.D9wJVdL1.lean.js" >
2024-05-30 02:02:10 +00:00
< script id = "check-dark-mode" > ( ( ) => { const e = localStorage . getItem ( "vitepress-theme-appearance" ) || "auto" , a = window . matchMedia ( "(prefers-color-scheme: dark)" ) . matches ; ( ! e || e === "auto" ? a : e === "dark" ) && document . documentElement . classList . add ( "dark" ) } ) ( ) ; < / script >
< script id = "check-mac-os" > document . documentElement . classList . toggle ( "mac" , /Mac|iPhone|iPod|iPad/i . test ( navigator . platform ) ) ; < / script >
< / head >
< body >
2024-06-02 02:43:43 +00:00
< div id = "app" > < div class = "Layout" data-v-5d98c3a5 > <!-- [ --> <!-- ] --> <!-- [ --> < span tabindex = "-1" data-v-0f60ec36 > < / span > < a href = "#VPContent" class = "VPSkipLink visually-hidden" data-v-0f60ec36 > Skip to content < / a > <!-- ] --> <!-- --> < header class = "VPNav" data-v-5d98c3a5 data-v-ae24b3ad > < div class = "VPNavBar has-sidebar top" data-v-ae24b3ad data-v-ccf7ddec > < div class = "wrapper" data-v-ccf7ddec > < div class = "container" data-v-ccf7ddec > < div class = "title" data-v-ccf7ddec > < div class = "VPNavBarTitle has-sidebar" data-v-ccf7ddec data-v-ab179fa1 > < a class = "title" href = "/" data-v-ab179fa1 > <!-- [ --> <!-- ] --> <!-- [ --> <!-- [ --> <!-- [ --> < img class = "VPImage dark logo" src = "/qmk-logo-dark.svg" alt data-v-8426fc1a > <!-- ] --> <!-- [ --> < img class = "VPImage light logo" src = "/qmk-logo-light.svg" alt data-v-8426fc1a > <!-- ] --> <!-- ] --> <!-- ] --> < span data-v-ab179fa1 > QMK Firmware< / span > <!-- [ --> <!-- ] --> < / a > < / div > < / div > < div class = "content" data-v-ccf7ddec > < div class = "content-body" data-v-ccf7ddec > <!-- [ --> <!-- ] --> < div class = "VPNavBarSearch search" data-v-ccf7ddec > <!-- [ --> <!-- --> < div id = "local-search" > < button type = "button" class = "DocSearch DocSearch-Button" aria-label = "Search" > < span class = "DocSearch-Button-Container" > < span class = "vp-icon DocSearch-Search-Icon" > < / span > < span class = "DocSearch-Button-Placeholder" > Search< / span > < / span > < span class = "DocSearch-Button-Keys" > < kbd class = "DocSearch-Button-Key" > < / kbd > < kbd class = "DocSearch-Button-Key" > K< / kbd > < / span > < / button > < / div > <!-- ] --> < / div > < nav aria-labelledby = "main-nav-aria-label" class = "VPNavBarMenu menu" data-v-ccf7ddec data-v-7f418b0f > < span id = "main-nav-aria-label" class = "visually-hidden" data-v-7f418b0f > Main Navigation< / span > <!-- [ --> <!-- [ --> < a class = "VPLink link VPNavBarMenuLink" href = "./" tabindex = "0" data-v-7f418b0f data-v-9c663999 > <!-- [ --> < span data-v-9c663999 > Home< / span > <!-- ] --> < / a > <!-- ] --> <!-- ] --> < / nav > <!-- --> < div class = "VPNavBarAppearance appearance" data-v-ccf7ddec data-v-e6aabb21 > < button class = "VPSwitch VPSwitchAppearance" type = "button" role = "switch" title = "Switch to dark theme" aria-checked = "false" data-v-e6aabb21 data-v-d1f28634 data-v-1d5665e3 > < span class = "check" data-v-1d5665e3 > < span class = "icon" data-v-1d5665e3 > <!-- [ --> < span class = "vpi-sun sun" data-v-d1f28634 > < / span > < span class = "vpi-moon moon" data-v-d1f28634 > < / span > <!-- ] --> < / span > < / span > < / button > < / div > < div class = "VPSocialLinks VPNavBarSocialLinks social-links" data-v-ccf7ddec data-v-0394ad82 data-v-7bc22406 > <!-- [ --> < a class = "VPSocialLink no-icon" href = "https://reddit.com/r/olkb" aria-label target = "_blank" rel = "noopener" data-v-7bc22406 data-v-eee4e7cb > < svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 50 50" width = "50px" height = "50px" > < path d = "M 29 3 C 28 . 0625 3 27 . 164063 3 . 382813 26 . 5 4 C 25 . 835938 4 . 617188 25 . 363281 5 . 433594 25 6 . 40625 C 24 . 355469 8 . 140625 24 . 085938 10 . 394531 24 . 03125 13 . 03125 C 19 . 234375 13 . 179688 14 . 820313 14 . 421875 11 . 28125 16 . 46875 C 10 . 214844 15 . 46875 8 . 855469 14 . 96875 7 . 5 14 . 96875 C 6 . 089844 14 . 96875 4 . 675781 15 . 511719 3 . 59375 16 . 59375 C 1 . 425781 18 . 761719 1 . 425781 22 . 238281 3 . 59375 24 . 40625 L 3 . 84375 24 . 65625 C 3 . 3125 26 . 035156 3 27 . 488281 3 29 C 3 33 . 527344 5 . 566406 37 . 585938 9 . 5625 40 . 4375 C 13 . 558594 43 . 289063 19 . 007813 45 25 45 C 30 . 992188 45 36 . 441406 43 . 289063 40 . 4375 40 . 4375 C 44 . 433594 37 . 585938 47 33 . 527344 47 29 C 47 27 . 488281 46 . 6875 26 . 035156 46 . 15625 24 . 65625 L 46 . 40625 24 . 40625 C 48 . 574219 22 . 238281 48 . 574219 18 . 761719 46 . 40625 16 . 59375 C 45 . 324219 15 . 511719 43 . 910156 14 . 96875 42 . 5 14 . 96875 C 41 . 144531 14 . 96875 39 . 785156 15 . 46875 38 . 71875 16 . 46875 C 35 . 195313 14 . 433594 30 . 800781 13 . 191406 26 . 03125 13 . 03125 C 26 . 09375 10 . 546875 26 . 363281 8 . 46875 26 . 875 7 . 09375 C 27 . 164063 6 . 316406 27 . 527344 5 . 757813 27 . 875 5 . 4375 C 28 . 222656 5 . 117188 28 . 539063 5 29 5 C 29 . 460938 5 29 . 683594 5 . 125 30 . 03125 5 . 40625 C 30 . 378906 5 . 6875 30 . 785156 6 . 148438 31 . 3125 6 . 6875 C 32 . 253906 7 . 652344 33 . 695313 8 . 714844 36 . 09375 8 . 9375 C 36 . 539063 11 . 238281 38 . 574219 13 41 13 C 43 . 75 13 46 10 . 75 46 8 C 46 5 . 25 43 . 75 3 41 3 C 38 . 605469 3 36 . 574219 4 . 710938 36 . 09375 6 . 96875 C 34 . 3125 6 . 796875 33 . 527344 6 . 109375 32 . 75 5 . 3125 C 32 . 300781 4 . 851563 31 . 886719
2024-05-30 02:02:10 +00:00
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_task_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Host Keyboard Layer Status< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Layer: " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > get_highest_layer< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (layer_state)) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > _QWERTY:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Default< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \n< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > _FN:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " FN< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \n< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > _ADJ:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " ADJ< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \n< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Or use the write_ln shortcut over adding ' \n' to the end of your string< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_ln_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Undefined" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Host Keyboard LED Status< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > led_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > led_state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > host_keyboard_led_state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (led_state.num_lock < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ?< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " NUM " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > :< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (led_state.caps_lock < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ?< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " CAP " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > :< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (led_state.scroll_lock < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ?< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " SCR " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > :< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > < / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #endif< / span > < / span > < / code > < / pre > < / div > < h2 id = "logo-example" tabindex = "-1" > Logo Example < a class = "header-anchor" href = "#logo-example" aria-label = "Permalink to "Logo Example"" > < / a > < / h2 > < p > In the default font, certain ranges of characters are reserved for a QMK logo. To render this logo to the OLED screen, use the following code example:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > static< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > render_logo< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > static< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > PROGMEM qmk_logo< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 80< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 81< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 82< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 83< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 84< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 85< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 86< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 87< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 88< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 89< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8A< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8B< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8C< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8D< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8E< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8F< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 90< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 91< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 92< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 93< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A4< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A5< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A6< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A7< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A8< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > A9< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > AA< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > AB< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > AC< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > AD< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > AE< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > AF< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > B0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > B1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > B2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > B3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C4< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C5< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C6< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C7< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C8< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > C9< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > CA< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > CB< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > CC< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > CD< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > CE< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > CF< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > D0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > D1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > D2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > 0x< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > D3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (qmk_logo, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_task_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > render_logo< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < div class = "tip custom-block" > < p class = "custom-block-title" > TIP< / p > < p > The default font file is located at < code > drivers/oled/glcdfont.c< / code > and its location can be overwritten with the < code > OLED_FONT_H< / code > configuration option. Font file content can be edited with external tools such as < a href = "https://helixfonteditor.netlify.app/" target = "_blank" rel = "noreferrer" > Helix Font Editor< / a > and < a href = "https://joric.github.io/qle/" target = "_blank" rel = "noreferrer" > Logo Editor< / a > .< / p > < / div > < h2 id = "buffer-read-example" tabindex = "-1" > Buffer Read Example < a class = "header-anchor" href = "#buffer-read-example" aria-label = "Permalink to "Buffer Read Example"" > < / a > < / h2 > < p > For some purposes, you may need to read the current state of the OLED display buffer. The < code > oled_read_raw< / code > function can be used to safely read bytes from the buffer.< / p > < p > In this example, calling < code > fade_display< / code > in the < code > oled_task_user< / code > function will slowly fade away whatever is on the screen by turning random pixels black over time.< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > //Setup some mask which can be or' d with bytes to turn off pixels< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > single_bit_masks< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 127< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 191< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 223< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 239< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 247< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 251< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 253< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 254< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > static< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > fade_display< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > //Define the reader structure< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_buffer_reader_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > reader;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > buff_char;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > random< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > () < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > %< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 30< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > srand< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > timer_read< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ());< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Fetch a pointer for the buffer byte at index 0. The return structure< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // will have the pointer and the number of bytes remaining from this< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // index position if we want to perform a sequential read by< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // incrementing the buffer pointer< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > reader < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_read_raw< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > //Loop over the remaining buffer and erase pixels as we go< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > for< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > i < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ; i < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > < < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > reader.remaining_element_count; i< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ++< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > //Get the actual byte in the buffer by dereferencing the pointer< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > buff_char < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > reader.current_element;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (buff_char < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !=< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_raw_byte< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (buff_char < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > & < / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > single_bit_masks< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > rand< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > () < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > %< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 8< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ], i);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > //increment the pointer to fetch a new byte during the next loop< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > reader.current_element< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ++< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < h2 id = "other-examples" tabindex = "-1" > Other Examples < a class = "header-anchor" href = "#other-examples" aria-label = "Permalink to "Other Examples"" > < / a > < / h2 > < p > In split keyboards, it is very common to have two OLED displays that each render different content and are oriented or flipped differently. You can do this by switching which content to render by using the return value from < code > is_keyboard_master()< / code > or < code > is_keyboard_left()< / code > found in < code > split_util.h< / code > , e.g:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #ifdef< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > OLED_ENABLE< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_init_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > rotation< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > is_keyboard_master< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ()) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_180;< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // flips the display 180 degrees if offhand< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > rotation;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_task_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > is_keyboard_master< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ()) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > render_status< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Renders the current keyboard state (layer, lock, caps, scroll, etc)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > render_logo< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Renders a static logo< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_scroll_left< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Turns on scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #endif< / span > < / span > < / code > < / pre > < / div > < p > Render a message before booting into bootloader mode.< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_render_boot< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > bootloader< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_clear< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > for< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > int< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > i < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ; i < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > < < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ; i< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ++< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_set_cursor< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , i);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (bootloader) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Awaiting New Firmware " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PSTR< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Rebooting " < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ), < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_render_dirty< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > true< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > shutdown_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > jump_to_bootloader< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_render_boot< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (jump_to_bootloader);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < h2 id = "basic-configuration" tabindex = "-1" > Basic Configuration < a class = "header-anchor" href = "#basic-configuration" aria-label = "Permalink to "Basic Configuration"" > < / a > < / h2 > < p > These configuration options should be placed in < code > config.h< / code > . Example:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > OLED_BRIGHTNESS< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 128< / span > < / span > < / code > < / pre > < / div > < table > < thead > < tr > < th > Define< / th > < th > Default< / th > < th > Description< / th > < / tr > < / thead > < tbody > < tr > < td > < code > OLED_BRIGHTNESS< / code > < / td > < td > < code > 255< / code > < / td > < td > The default brightness level of the OLED, from 0 to 255.< / td > < / tr > < tr > < td > < code > OLED_COLUMN_OFFSET< / code > < / td > < td > < code > 0< / code > < / td > < td > Shift output to the right this many pixels.< br > Useful for 128x64 displays centered on a 132x64 SH1106 IC.< / td > < / tr > < tr > < td > < code > OLED_DISPLAY_CLOCK< / code > < / td > < td > < code > 0x80< / code > < / td > < td > Set the display clock divide ratio/oscillator frequency.< / td > < / tr > < tr > < td > < code > OLED_FONT_H< / code > < / td > < td > < code > " glcdfont.c" < / code > < / td > < td > The font code file to use for custom fonts< / td > < / tr > < tr > < td > < code > OLED_FONT_START< / code > < / td > < td > < code > 0< / code > < / td > < td > The starting character index for custom fonts< / td > < / tr > < tr > < td > < code > OLED_FONT_END< / code > < / td > < td > < code > 223< / code > < / td > < td > The ending character index for custom fonts< / td > < / tr > < tr > < td > < code > OLED_FONT_WIDTH< / code > < / td > < td > < code > 6< / code > < / td > < td > The font width< / td > < / tr > < tr > < td > < code > OLED_FONT_HEIGHT< / code > < / td > < td > < code > 8< / code > < / td > < td > The font height (untested)< / td > < / tr > < tr > < td > < code > OLED_IC< / code > < / td > < td > < code > OLED_IC_SSD1306< / code > < / td > < td > Set to < code > OLED_IC_SH1106< / code > or < code > OLED_IC_SH1107< / code > if the corresponding controller chip is used.< / td > < / tr > < tr > < td > < code > OLED_FADE_OUT< / code > < / td > < td > < em > Not defined< / em > < / td > < td > Enables fade out animation. Use together with < code > OLED_TIMEOUT< / code > .< / td > < / tr > < tr > < td > < code > OLED_FADE_OUT_INTERVAL< / code > < / td > < td > < code > 0< / code > < / td > < td > The speed of fade out animation, from 0 to 15. Larger values are slower.< / td > < / tr > < tr > < td > < code > OLED_SCROLL_TIMEOUT< / code > < / td > < td > < code > 0< / code > < / td > < td > Scrolls the OLED screen after 0ms of OLED inactivity. Helps reduce OLED Burn-in. Set to 0 to disable.< / td > < / tr > < tr > < td > < code > OLED_SCROLL_TIMEOUT_RIGHT< / code > < / td > < td > < em > Not defined< / em > < / td > < td > Scroll timeout direction is right when defined, left when undefined.< / td > < / tr > < tr > < td > < code > OLED_TIMEOUT< / code > < / td > < td > < code > 60000< / code > < / td > < td > Turns off the OLED screen after 60000ms of screen update inactivity. Helps reduce OLED Burn-in. Set to 0 to disable.< / td > < / tr > < tr > < td > < code > OLED_UPDATE_INTERVAL< / code > < / td > < td > < code > 0< / code > (< code > 50< / code > for split keyboards)< / td > < td > Set the time interval for updating the OLED display in ms. This will improve the matrix scan rate.< / td > < / tr > < tr > < td > < code > OLED_UPDATE_PROCESS_LIMIT< / code > < / td > < td > < code > 1< / code > < / td > < td > Set the number of dirty blocks to render per loop. Increasing may degrade performance.< / td > < / tr > < / tbody > < / table > < h3 id = "i2c-configuration" tabindex = "-1" > I2C Configuration < a class = "header-anchor" href = "#i2c-configuration" aria-label = "Permalink to "I2C Configuration"" > < / a > < / h3 > < table > < thead > < tr > < th > Define< / th > < th > Default< / th > < th > Description< / th > < / tr > < / thead > < tbody > < tr > < td > < code > OLED_DISPLAY_ADDRESS< / code > < / td > < td > < code > 0x3C< / code > < / td > < td > The i2c address of the OLED Display< / td > < / tr > < / tbody > < / table > < h3 id = "spi-configuration" tabindex = "-1" > SPI Configuration < a class = "header-anchor" href = "#spi-configuration" aria-label = "Permalink to "SPI Configuration"" > < / a > < / h3 > < table > < thead > < tr > < th > Define< / th > < th > Default< / th > < th > Description< / th > < / tr > < / thead > < tbody > < t
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_0 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_90 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_180 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_270 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // OLED_ROTATION_90 | OLED_ROTATION_180< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span > < / code > < / pre > < / div > < p > OLED displays driven by SSD1306, SH1106 or SH1107 drivers only natively support in hardware 0 degree and 180 degree rendering. This feature is done in software and not free. Using this feature will increase the time to calculate what data to send over i2c to the OLED. If you are strapped for cycles, this can cause keycodes to not register. In testing however, the rendering time on an ATmega32U4 board only went from 2ms to 5ms and keycodes not registering was only noticed once we hit 15ms.< / p > < p > 90 degree rotation is achieved by using bitwise operations to rotate each 8 block of memory and uses two precalculated arrays to remap buffer memory to OLED memory. The memory map defines are precalculated for remap performance and are calculated based on the display height, width, and block size. For example, in the 128x32 implementation with a < code > uint8_t< / code > block type, we have a 64 byte block size. This gives us eight 8 byte blocks that need to be rotated and rendered. The OLED renders horizontally two 8 byte blocks before moving down a page, e.g:< / p > < table > < thead > < tr > < th > < / th > < th > < / th > < th > < / th > < th > < / th > < th > < / th > < th > < / th > < / tr > < / thead > < tbody > < tr > < td > 0< / td > < td > 1< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < tr > < td > 2< / td > < td > 3< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < tr > < td > 4< / td > < td > 5< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < tr > < td > 6< / td > < td > 7< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < / tbody > < / table > < p > However the local buffer is stored as if it was Height x Width display instead of Width x Height, e.g:< / p > < table > < thead > < tr > < th > < / th > < th > < / th > < th > < / th > < th > < / th > < th > < / th > < th > < / th > < / tr > < / thead > < tbody > < tr > < td > 3< / td > < td > 7< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < tr > < td > 2< / td > < td > 6< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < tr > < td > 1< / td > < td > 5< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < tr > < td > 0< / td > < td > 4< / td > < td > < / td > < td > < / td > < td > < / td > < td > < / td > < / tr > < / tbody > < / table > < p > So those precalculated arrays just index the memory offsets in the order in which each one iterates its data.< / p > < p > Rotation on SH1106 and SH1107 is noticeably less efficient than on SSD1306, because these controllers do not support the “horizontal addressing mode”, which allows transferring the data for the whole rotated block at once; instead, separate address setup commands for every page in the block are required. The screen refresh time for SH1107 is therefore about 45% higher than for a same size screen with SSD1306 when using STM32 MCUs (on AVR the slowdown is about 20%, because the code which actually rotates the bitmap consumes more time).< / p > < h2 id = "oled-api" tabindex = "-1" > OLED API < a class = "header-anchor" href = "#oled-api" aria-label = "Permalink to "OLED API"" > < / a > < / h2 > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // OLED Rotation enum values are flags< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_0 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_90 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_180 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > OLED_ROTATION_270 < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // OLED_ROTATION_90 | OLED_ROTATION_180< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Initialize the oled display, rotating the rendered output based on the define passed in.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the OLED was initialized successfully< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_init< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > rotation< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Called at the start of oled_init, weak function overridable by the user< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // rotation - the value passed into oled_init< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Return new oled_rotation_t if you want to override default rotation< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_init_kb< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > rotation< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_init_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_rotation_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > rotation< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Send commands/data to screen< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_send_cmd< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > size< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_send_cmd_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > size< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_send_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > size< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Clears the display buffer, resets cursor position to 0, and sets the buffer to dirty for rendering< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_clear< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Alias to oled_render_dirty to avoid a change in api.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_render< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > () < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_render_dirty< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > false< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > )< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Renders all dirty blocks to the display at one time or a subset depending on the value of< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // all.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_render_dirty< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > all< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Moves cursor to character position indicated by column and line, wraps if out of bounds< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Max column denoted by ' oled_max_chars()' and max lines by ' oled_max_lines()' functions< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_set_cursor< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > col< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > line< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor to the next page, writing ' ' if true< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Wraps to the beginning when out of bounds< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_advance_page< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > clearPageRemainder< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Moves the cursor forward 1 character length< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advance page if there is not enough room for the next character< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Wraps to the beginning when out of bounds< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_advance_char< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a single character to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor while writing, inverts the pixels if true< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Main handler that writes character data to the display buffer< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_char< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a string to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor while writing, inverts the pixels if true< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a string to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor while writing, inverts the pixels if true< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor to the next page, wiring ' ' to the remainder of the current page< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_ln< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Pans the buffer to the right (or left by passing true) by moving contents of the buffer< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Useful for moving the screen in preparation for new drawing< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_pan< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > left< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns a pointer to the requested start index in the buffer plus remaining< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // buffer length as struct< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > oled_buffer_reader_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_read_raw< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > start_index< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a string to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_raw< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > size< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a single byte into the buffer at the specified index< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_raw_byte< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > index< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Sets a specific pixel on or off< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Coordinates start at top-left and go right and down for positive x and y< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_pixel< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > x< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > y< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #if< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > defined< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > __AVR__< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > )< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a PROGMEM string to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor while writing, inverts the pixels if true< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Remapped to call ' void oled_write(const char *data, bool invert);' on ARM< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a PROGMEM string to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor while writing, inverts the pixels if true< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Advances the cursor to the next page, wiring ' ' to the remainder of the current page< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Remapped to call ' void oled_write_ln(const char *data, bool invert);' on ARM< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_ln_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Writes a PROGMEM string to the buffer at current cursor position< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_raw_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > char< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > size< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #else< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > # define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (data, invert)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > # define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_ln_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_ln< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (data, invert)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > # define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_raw_P< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > size< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_write_raw< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (data, size)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #endif< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // defined(__AVR__)< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Can be used to manually turn on the screen if it is off< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the screen was on or turns on< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Can be used to manually turn off the screen if it is on< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the screen was off or turns off< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the oled is currently on, false if it is< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // not< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > is_oled_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Sets the brightness level of the display< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_set_brightness< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > level< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Gets the current brightness level of the display< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_get_brightness< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Basically it' s oled_render, but with timeout management and oled_task_user calling!< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_task< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Called at the start of oled_task, weak function overridable by the user< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_task_kb< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_task_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Set the specific 8 lines rows of the screen to scroll.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // 0 is the default for start, and 7 for end, which is the entire< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // height of the screen. For 128x32 screens, rows 4-7 are not used.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_scroll_set_area< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > start_line< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > end_line< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Sets scroll speed, 0-7, fastest to slowest. Default is three.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Does not take effect until scrolling is either started or restarted< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // the ssd1306 supports 8 speeds with the delay< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // listed below between each frame of the scrolling effect< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // 0=2, 1=3, 2=4, 3=5, 4=25, 5=64, 6=128, 7=256< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_scroll_set_speed< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > speed< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Begin scrolling the entire display right< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the screen was scrolling or starts scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // NOTE: display contents cannot be changed while scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_scroll_right< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Begin scrolling the entire display left< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the screen was scrolling or starts scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // NOTE: display contents cannot be changed while scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_scroll_left< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Turns off display scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the screen was not scrolling or stops scrolling< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_scroll_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the oled is currently scrolling, false if it is< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // not< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > is_oled_scrolling< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Inverts the display< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns true if the screen was or is inverted< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > invert< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns the maximum number of characters that will fit on a line< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_max_chars< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Returns the maximum number of lines that will fit on the OLED< / span > < / span >
2024-06-02 02:43:43 +00:00
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint8_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > oled_max_lines< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span > < / code > < / pre > < / div > < div class = "warning custom-block" > < p class = "custom-block-title" > WARNING< / p > < p > Scrolling is unsupported on the SH1106 and SH1107.< / p > < / div > < div class = "warning custom-block" > < p class = "custom-block-title" > WARNING< / p > < p > Scrolling does not work properly on the SSD1306 if the display width is smaller than 128.< / p > < / div > < h2 id = "ssd1306-h-driver-conversion-guide" tabindex = "-1" > SSD1306.h Driver Conversion Guide < a class = "header-anchor" href = "#ssd1306-h-driver-conversion-guide" aria-label = "Permalink to "SSD1306.h Driver Conversion Guide"" > < / a > < / h2 > < table > < thead > < tr > < th > Old API< / th > < th > Recommended New API< / th > < / tr > < / thead > < tbody > < tr > < td > < code > struct CharacterMatrix< / code > < / td > < td > < em > removed - delete all references< / em > < / td > < / tr > < tr > < td > < code > iota_gfx_init< / code > < / td > < td > < code > oled_init< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_on< / code > < / td > < td > < code > oled_on< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_off< / code > < / td > < td > < code > oled_off< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_flush< / code > < / td > < td > < code > oled_render< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_write_char< / code > < / td > < td > < code > oled_write_char< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_write< / code > < / td > < td > < code > oled_write< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_write_P< / code > < / td > < td > < code > oled_write_P< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_clear_screen< / code > < / td > < td > < code > oled_clear< / code > < / td > < / tr > < tr > < td > < code > matrix_clear< / code > < / td > < td > < em > removed - delete all references< / em > < / td > < / tr > < tr > < td > < code > matrix_write_char_inner< / code > < / td > < td > < code > oled_write_char< / code > < / td > < / tr > < tr > < td > < code > matrix_write_char< / code > < / td > < td > < code > oled_write_char< / code > < / td > < / tr > < tr > < td > < code > matrix_write< / code > < / td > < td > < code > oled_write< / code > < / td > < / tr > < tr > < td > < code > matrix_write_ln< / code > < / td > < td > < code > oled_write_ln< / code > < / td > < / tr > < tr > < td > < code > matrix_write_P< / code > < / td > < td > < code > oled_write_P< / code > < / td > < / tr > < tr > < td > < code > matrix_write_ln_P< / code > < / td > < td > < code > oled_write_ln_P< / code > < / td > < / tr > < tr > < td > < code > matrix_render< / code > < / td > < td > < code > oled_render< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_task< / code > < / td > < td > < code > oled_task< / code > < / td > < / tr > < tr > < td > < code > iota_gfx_task_user< / code > < / td > < td > < code > oled_task_user< / code > < / td > < / tr > < / tbody > < / table > < / div > < / div > < / main > < footer class = "VPDocFooter" data-v-39a288b8 data-v-09de1c0f > <!-- [ --> <!-- ] --> <!-- --> < nav class = "prev-next" data-v-09de1c0f > < div class = "pager" data-v-09de1c0f > < a class = "VPLink link pager-link prev" href = "/features/st7565" data-v-09de1c0f > <!-- [ --> < span class = "desc" data-v-09de1c0f > Previous page< / span > < span class = "title" data-v-09de1c0f > ST7565 LCD Driver< / span > <!-- ] --> < / a > < / div > < div class = "pager" data-v-09de1c0f > < a class = "VPLink link pager-link next" href = "/features/backlight" data-v-09de1c0f > <!-- [ --> < span class = "desc" data-v-09de1c0f > Next page< / span > < span class = "title" data-v-09de1c0f > Backlight< / span > <!-- ] --> < / a > < / div > < / nav > < / footer > <!-- [ --> <!-- ] --> < / div > < / div > < / div > <!-- [ --> <!-- ] --> < / div > < / div > <!-- --> <!-- [ --> <!-- ] --> < / div > < / div >
< script > w i n d o w . _ _ V P _ H A S H _ M A P _ _ = J S O N . p a r s e ( " { \ " c h a n g e l o g _ 2 0 2 1 0 5 2 9 . m d \ " : \ " C R 1 Y N f Z X \ " , \ " c h a n g e l o g _ 2 0 1 9 0 8 3 0 . m d \ " : \ " D r t q 3 l M y \ " , \ " c h a n g e l o g _ 2 0 2 1 0 2 2 7 . m d \ " : \ " B W O t C a e S \ " , \ " c h a n g e l o g _ 2 0 2 2 0 5 2 8 . m d \ " : \ " B X 3 C C Y 1 Z \ " , \ " c h a n g e l o g _ 2 0 2 0 1 1 2 8 . m d \ " : \ " 7 X X L 0 2 B n \ " , \ " c h a n g e l o g _ 2 0 2 2 0 2 2 6 . m d \ " : \ " B W O 5 r _ e c \ " , \ " c h a n g e l o g _ 2 0 2 0 0 5 3 0 . m d \ " : \ " D k - v R p T Q \ " , \ " c h a n g e l o g _ 2 0 2 1 0 8 2 8 . m d \ " : \ " D N b H I u u M \ " , \ " c h a n g e l o g _ 2 0 2 1 1 1 2 7 . m d \ " : \ " C l U a w W k q \ " , \ " d r i v e r s _ i 2 c . m d \ " : \ " C u j 8 7 r e B \ " , \ " f a q _ m i s c . m d \ " : \ " q G r h O T u 4 \ " , \ " c l i _ c o m m a n d s . m d \ " : \ " D G x - q N i E \ " , \ " d r i v e r s _ u a r t . m d \ " : \ " B N B s - m 3 h \ " , \ " f e a t u r e _ a d v a n c e d _ k e y c o d e s . m d \ " : \ " C X 8 d J k Y - \ " , \ " a p i _ o v e r v i e w . m d \ " : \ " 0 F P a U s M b \ " , \ " a r m _ d e b u g g i n g . m d \ " : \ " B H - H 2 U k z \ " , \ " f e a t u r e _ l a y e r s . m d \ " : \ " 8 G w B U T Z N \ " , \ " f e a t u r e s _ m o u s e _ k e y s . m d \ " : \ " C 3 P 3 p Y u E \ " , \ " f e a t u r e s _ o l e d _ d r i v e r . m d \ " : \ " D 9 w J V d L 1 \ " , \ " c h a n g e l o g _ 2 0 2 0 0 8 2 9 . m d \ " : \ " C o q r O f f n \ " , \ " b r e a k i n g _ c h a n g e s _ i n s t r u c t i o n s . m d \ " : \ " B A j I G e J b \ " , \ " c h a n g e l o g _ 2 0 2 3 0 2 2 6 . m d \ " : \ " C g 0 A Y x I n \ " , \ " c h a n g e l o g _ 2 0 2 4 0 5 2 6 . m d \ " : \ " i G L F D 0 S P \ " , \ " c h a n g e l o g _ 2 0 2 0 0 2 2 9 . m d \ " : \ " D N s o w w M 1 \ " , \ " b r e a k i n g _ c h a n g e s _ h i s t o r y . m d \ " : \ " C k z d D 6 x 8 \ " , \ " c h a n g e l o g _ 2 0 2 2 0 8 2 7 . m d \ " : \ " D j P t h q D k \ " , \ " c l i . m d \ " : \ " B L z A d A 6 l \ " , \ " p l a t f o r m d e v _ b l a c k p i l l _ f 4 x 1 . m d \ " : \ " D v O b L R u k \ " , \ " p l a t f o r m d e v _ p r o t o n _ c . m d \ " : \ " C D R u J B v D \ " , \ " s q u e e z i n g _ a v r . m d \ " : \ " B m c L Y K O r \ " , \ " p l a t f o r m d e v _ r p 2 0 4 0 . m d \ " : \ " C Y K Y M D f c \ " , \ " c l i _ t a b _ c o m p l e t e . m d \ " : \ " C h a x f z Y o \ " , \ " p l a t f o r m d e v _ s e l e c t i n g _ a r m _ m c u . m d \ " : \ " a F 4 D U s v b \ " , \ " d a t a _ d r i v e n _ c o n f i g . m d \ " : \ " B v L Q 7 P 2 0 \ " , \ " p o r t i n g _ y o u r _ k e y b o a r d _ t o _ q m k . m d \ " : \ " C G l G d F j 4 \ " , \ " o t h e r _ e c l i p s e . m d \ " : \ " C - z q y J O 9 \ " , \ " f e a t u r e s _ r g b _ m a t r i x . m d \ " : \ " 8 P R l k G E q \ " , \ " s y l l a b u s . m d \ " : \ " B _ A R G k L g \ " , \ " q u a n t u m _ p a i n t e r _ r l e . m d \ " : \ " B 0 7 V 3 m - n \ " , \ " f e a t u r e s _ h d 4 4 7 8 0 . m d \ " : \ " 1 5 K 4 0 o _ e \ " , \ " o n e _ s h o t _ k e y s . m d \ " : \ " Q R 0 9 r S b - \ " , \ " u n i t _ t e s t i n g . m d \ " : \ " u 3 f g b G U j \ " , \ " f e a t u r e s _ s e c u r e . m d \ " : \ " B X 7 j F v W 5 \ " , \ " f e a t u r e s _ r g b l i g h t . m d \ " : \ " D e h Q i k i L \ " , \ " f e a t u r e s _ s e n d _ s t r i n g . m d \ " : \ " v M 6 8 u n 4 v \ " , \ " r e f _ f u n c t i o n s . m d \ " : \ " B V I 2 u X S N \ " , \ " f l a s h i n g _ b o o t l o a d h i d . m d \ " : \ " a X G P 0 b N 5 \ " , \ " g e t t i n g _ s t a r t e d _ d o c k e r . m d \ " : \ " m z 6 H E 4 B l \ " , \ " g e t t i n g _ s t a r t e d _ g i t h u b . m d \ " : \ " O Y q 7 I T 7 B \ " , \ " g e t t i n g _ s t a r t e d _ i n t r o d u c t i o n . m d \ " : \ " B O J r e q S s \ " , \ " t a p _ h o l d . m d \ " : \ " D D 8 W T S l a \ " , \ " g e t t i n g _ s t a r t e d _ m a k e _ g u i d e . m d \ " : \ " B j U u E n S h \ " , \ " h a n d _ w i r e . m d \ " : \ " C c I 1 s p C v \ " , \ " u n d e r s t a n d i n g _ q m k . m d \ " : \ " f - B c _ e H Q \ " , \ " h a r d w a r e _ d r i v e r s . m d \ " : \ " B U n x 4 8 D 9 \ " , \ " f l a s h i n g . m d \ " : \ " B S Z F 2 R C y \ " , \ " i n d e x . m d \ " : \ " B 4 Q Y z v H E \ " , \ " k e y c o d e s _ m a g i c . m d \ " : \ " C G O 3 h g M m \ " , \ " h a r d w a r e _ k e y b o a r d _ g u i d e l i n e s . m d \ " : \ " C J e v s a n E \ " , \ " k e y c o d e s _ b a s i c . m d \ " : \ " C H I e C v w n \ " , \ " k e y c o d e s _ u s _ a n s i _ s h i f t e d . m d \ " : \ " C s 7 8 S D f M \ " , \ " r e f e r e n c e _ c o n f i g u r a t o r _ s u p p o r t . m d \ " : \ " F a B Q z I j 6 \ " , \ " m o d _ t a p . m d \ " : \ " C 7 w R K L c f \ " , \ " n e w b s . m d \ " : \ " - Y Y N d 3 d T \ " , \ " a p i _ d e v e l o p m e n t _ o v e r v i e w . m d \ " : \ " D c e y 4 n t L \ " , \ " c a p a b i l i t i e s _ i n c . m d \ " : \ " C a 9 z p M c e \ " , \ " n e w b s _ b u i l d i n g _ f i r m w a r e . m d \ " : \ " D n V U K 9 i t \ " , \ " a p i _ d e v e l o p m e n t _ e n v i r o n m e n t . m d \ " : \ " E h J C l b 9 f \ " , \ " k e y m a p . m d \ " : \ " Y 4 F e i 1 T y \ " , \ " i s p _ f l a s h i n g _ g u i d e . m d \ " : \ " B i u B p O K X \ " , \ " n e w b s _ b u i l d i n g _ f i r m w a r e _ w o r k f l o w . m d \ " : \ " D p L V w A 7 x \ " , \ " c l i _ d e v e l o p m e n t . m d \ " : \ " 3 x F A 2 O v S \ " , \ " c h a n g e l o g _ 2 0 2 3 1 1 2 6 . m d \ " : \ " D 2 O k 5 Q A f \ " , \ " c l i _ c o n f i g u r a t i o n . m d \ " : \ " C G S B 1 2 8 P \ " , \ " n e w b s _ e x t e r n a l _ u s e r s p a c e . m d \ " : \ " p D 9 L c - a 5 \ " , \ " n e w b s _ f l a s h i n g . m d \ " : \ " B 4 2 m 5 W l n \ " , \ " h o w _ k e y b o a r d s _ w o r k . m d \ " : \ " C B 7 z 8 o c b \ " , \ " n e w b s _ g e t t i n g _ s t a r t e d . m d \ " : \ " D D 4 a 5 q P C \ " , \ " o t h e r _ v s c o d e . m d \ " : \ " D i 3 v O y S R \ " , \ " k e y c o d e s . m d \ " : \ " h k O k K J P h \ " , \ " n e w b s _ g i t _ u s i n g _ y o u r _ m a s t e r _ b r a n c h . m d \ " : \ " B 9 D x Z C l 8 \ " , \ " q u a n t u m _ p a i n t e r _ l v g l . m d \ " : \ " D o b N b S g A \ " , \ " d o c u m e n t a t i o n _ t e m p l a t e s . m d \ " : \ " B h k u m 0 w D \ " , \ " a p i _ d o c s . m d \ " : \ " C R o D 6 C b L \ " , \ " s u p p o r t . m d \ " : \ " C w J _ H 6 Q x \ " , \ " d r i v e r _ i n s t a l l a t i o n _ z a d i g . m d \ " : \ " C X 9 - B A C t \ " , \ " c h a n g e l o g _ 2 0 2 2 1 1 2 6 . m d \ " : \ " D p b r n X e C \ " , \ " n e w b s _ b u i l d i n g _ f i r m w a r e _ c o n f i g u r a t o r . m d \ " : \ " y y o - 1 Q D E \ " , \ " n e w b s _ l e a r n _ m o r e _ r e s o u r c e s . m d \ " : \ " D j 1 s 2 B D G \ " , \ " b r e a k i n g _ c h a n g e s . m d \ " : \ " B t d q W Q l Y \ " , \ " d r i v e r s _ s e r i a l . m d \ " : \ " q x j y t V d M \ " , \ " q u a n t u m _ p a i n t e r _ q g f . m d \ " : \ " B J N S u 2 s 0 \ " , \ " n e w b s _ g i t _ b e s t _ p r a c t i c e s . m d \ " : \ " B I 2 - E V I 5 \ " , \ " n e w b s _ g i t _ r e s o l v i n g _ m e r g e _ c o n f l i c t s . m d \ " : \ " 7 2 w 3 B R m m \ " , \ " n e w b s _ g i t _ r e s y n c h r o n i z e _ a _ b r a n c h . m d \ " : \ " Y G D e f Q F x \ " , \ " d r i v e r s _ a p a 1 0 2 . m d \ " : \ " Q b - K X R p F \ " , \ " r e f e r e n c e _ k e y m a p _ e x t r a s . m d \ " : \ " - n _ b L m 7 8 \ " , \ " f e a t u r e s _ w p m . m d \ " : \ " B Y f - X c 1 H \ " , \ " d r i v e r s _ g p i o . m d \ " : \ " C 5 P v y J V h \ " , \ " d r i v e r s _ a u d i o . m d \ " : \ " m q a z 6 p 5 N \ " , \ " d r i v e r s _ s p i . m d \ " : \ " t J V e I T 7 e \ " , \ " c h a n g e l o g _ 2 0 2 4 0 2 2 5 . m d \ " : \ " B 4 - W r X j 6 \ " , \ " f e a t u r e s _ s e q u e n c e r . m d \ " : \ " D k g q N C s Q \ " , \ " d r i v e r s _ f l a s h . m d \ " : \ " D h W c H p 8 S \ " , \ " f e a t u r e
2024-05-30 02:02:10 +00:00
< / body >
< / html >
