{"id":2876,"date":"2025-04-17T04:40:33","date_gmt":"2025-04-17T04:40:33","guid":{"rendered":"https:\/\/webprojects.cloud\/wordpress\/splatco\/?post_type=spl_knowledgebase&#038;p=2876"},"modified":"2025-06-10T13:27:48","modified_gmt":"2025-06-10T13:27:48","slug":"oblcd_dim-lohidelay","status":"publish","type":"spl_knowledgebase","link":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/","title":{"rendered":"OBLCD_Dim Lo,Hi,Delay"},"content":{"rendered":"\n<p><code>&lt;OBLCD Backlight Levels&gt; = Lo,Hi; &lt;OBLCD Backlight Delay&gt; = Delay<\/code><\/p>\n\n\n\n<p>Sets the parameters for automatic LCD display dimming.\u00a0 Note, this instruction is only for character displays, for touch screen dimming see\u00a0<a href=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/hash-commands-and-functions\/hmi-controller-instructions\/setbacklight\/\">#HMI SetBacklight()<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>Parameter<\/th><th>Option<\/th><th>Range<\/th><th>Description<\/th><\/tr><tr><th>Lo<\/th><td>mandatory<\/td><td>0 (off) &#8211; 8 (maximum)<\/td><td>Sets the backlight low level.&nbsp;&nbsp;&nbsp;<\/td><\/tr><tr><th>Hi<\/th><td>mandatory<\/td><td>0 (off) &#8211; 8 (maximum)<\/td><td>Sets the backlight high level.&nbsp;&nbsp; If set to anything other than 0, will disable digital output control of the backlight.<\/td><\/tr><tr><th>Delay<\/th><td>mandatory<\/td><td>0 &#8211; 255<\/td><td>Sets the time in minutes that the backlight should remain at the high level after the last button press.&nbsp; A value of 0 will set the backlight to the low level instantly.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>The backlight will start at the high level and automatically switch to the low level when the delay elapses.&nbsp; Pressing a button will reset the delay and set the backlight back to the high level.<\/p>\n\n\n\n<p>On controllers that expose the backlight as a digital output, this digital output will only work while the backlight high level is set to 0.&nbsp; Otherwise, if the high level is set to anything else, the backlight is exclusively controlled by OBLCD_Dim.<\/p>\n\n\n\n<h6 class=\"wp-block-heading\">Alternative Method<\/h6>\n\n\n\n<p>There is also a low level way to manipulate the backlight.&nbsp; The high\/low levels and delay time are set separately.<\/p>\n\n\n\n<p>This code sets the high and low backlight levels:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">   SetU       0,High<br>   SetU       1,Low<br>   SPxCmd2    1,!CPU<\/pre>\n\n\n\n<p>Where<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>High = backlight high level, 0 (off) thru 8 (maximum)<\/li>\n\n\n\n<li>Low = backlight low level, 0 (off) thru 8 (maximum)<\/li>\n<\/ul>\n\n\n\n<p>Why would you possibly want to know this?&nbsp; Well, it means you could dynamically alter the backlight level by using the values from memory or registers, eg:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">   Recall     VariableLowLevel<br>   PopU       0<br>   Recall     VariableHighLevel<br>   PopU       1<br>   SPxCmd2    1,!CPU<\/pre>\n\n\n\n<p>As for the high level backlight time, this code sets the delay:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">   SetU       0,Minutes<br>   SPxCmd1    4,!CPU<\/pre>\n\n\n\n<p>Where<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Minutes = Time to keep the backlight at the high level, 0 thru 255 (4hr 15min)<\/li>\n<\/ul>\n\n\n\n<p>Using a minutes value of 0 will dim the backlight instantly.<\/p>\n\n\n\n<h6 class=\"wp-block-heading\">Reading Current Level<\/h6>\n\n\n\n<p>On some controllers the state of the backlight can be read back. The code<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">   SPxPoll1    8,!cpu        ;returns current back light level in U(0)<\/pre>\n\n\n\n<p>Use the\u00a0<a href=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/splat-expansion-framework-generic-instructions\/pushu-n\/\"><code>PushU 0<\/code>\u00a0<\/a>instruction to get the number to\u00a0<a href=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/glossary-of-terms\/#o3808\">X<\/a>\u00a0or use\u00a0<code><a href=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/the-splat-expansion-framework\/uv-transfer-instructions\/goifut-nmline\/\">GoIfUT<\/a>\/<a href=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/the-splat-expansion-framework\/uv-transfer-instructions\/goifuf-nmline\/\">GoifUF<\/a><\/code>\u00a0if you just want to know when the back light is on\/off.<\/p>\n\n\n\n<p><a href=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/glossary-of-terms\/#o2825\">Dialect<\/a>\u00a0exclusions: Not available in dialects before 9.<\/p>\n\n\n\n<h6 class=\"wp-block-heading\">Backlight Lifetime<\/h6>\n\n\n\n<h6 class=\"wp-block-heading\">Blue displays with a white backlight<\/h6>\n\n\n\n<p>The white LED technology used in these displays has a lifetime of approximately 3000 hours. The backlight should therefore be dimmed when not in use.&nbsp; The lower the dimming the longer the backlight will last.&nbsp; The ideal level is OFF (0).<\/p>\n\n\n\n<h6 class=\"wp-block-heading\">Greenish displays with a greenish backlight<\/h6>\n\n\n\n<p>The backlight in these displays has a great lifetime, something in the order of &#8220;<strong>yonks<\/strong>&#8221; according to our hardware guru.&nbsp; For those of you who may not hail from Australia, &#8220;yonks&#8221; means &#8220;a very, very long time&#8221;, like over 100,000 hours.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table class=\"has-fixed-layout\"><tbody><tr><td>Note: This instruction modifies UV<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>&lt;OBLCD Backlight Levels&gt; = Lo,Hi; &lt;OBLCD Backlight Delay&gt; = Delay Sets the parameters for automatic LCD display dimming.\u00a0 Note, this instruction is only for character&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2863,"menu_order":10,"template":"","class_list":["post-2876","spl_knowledgebase","type-spl_knowledgebase","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>OBLCD_Dim Lo,Hi,Delay - SPLat Controls<\/title>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"OBLCD_Dim Lo,Hi,Delay - SPLat Controls\" \/>\n<meta property=\"og:description\" content=\"&lt;OBLCD Backlight Levels&gt; = Lo,Hi; &lt;OBLCD Backlight Delay&gt; = Delay Sets the parameters for automatic LCD display dimming.\u00a0 Note, this instruction is only for character...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/\" \/>\n<meta property=\"og:site_name\" content=\"SPLat Controls\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-10T13:27:48+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/\",\"name\":\"OBLCD_Dim Lo,Hi,Delay - SPLat Controls\",\"isPartOf\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website\"},\"datePublished\":\"2025-04-17T04:40:33+00:00\",\"dateModified\":\"2025-06-10T13:27:48+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Programming reference\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Instructions arranged by function\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Onboard LCD (OBLCD) instructions\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"OBLCD_Dim Lo,Hi,Delay\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/\",\"name\":\"SPLat Controls\",\"description\":\"OEM Embedded Machine Controllers\",\"publisher\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#organization\",\"name\":\"SPLat Controls\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2024\/10\/logo.svg\",\"contentUrl\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2024\/10\/logo.svg\",\"caption\":\"SPLat Controls\"},\"image\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"OBLCD_Dim Lo,Hi,Delay - SPLat Controls","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"en_US","og_type":"article","og_title":"OBLCD_Dim Lo,Hi,Delay - SPLat Controls","og_description":"&lt;OBLCD Backlight Levels&gt; = Lo,Hi; &lt;OBLCD Backlight Delay&gt; = Delay Sets the parameters for automatic LCD display dimming.\u00a0 Note, this instruction is only for character...","og_url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/","og_site_name":"SPLat Controls","article_modified_time":"2025-06-10T13:27:48+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/","name":"OBLCD_Dim Lo,Hi,Delay - SPLat Controls","isPartOf":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website"},"datePublished":"2025-04-17T04:40:33+00:00","dateModified":"2025-06-10T13:27:48+00:00","breadcrumb":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/oblcd_dim-lohidelay\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/"},{"@type":"ListItem","position":2,"name":"Programming reference","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/"},{"@type":"ListItem","position":3,"name":"Instructions arranged by function","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/"},{"@type":"ListItem","position":4,"name":"Onboard LCD (OBLCD) instructions","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/programming-reference\/instructions-arranged-by-function\/onboard-lcd-oblcd-instructions\/"},{"@type":"ListItem","position":5,"name":"OBLCD_Dim Lo,Hi,Delay"}]},{"@type":"WebSite","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/","name":"SPLat Controls","description":"OEM Embedded Machine Controllers","publisher":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/webprojects.cloud\/wordpress\/splatco\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#organization","name":"SPLat Controls","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#\/schema\/logo\/image\/","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2024\/10\/logo.svg","contentUrl":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2024\/10\/logo.svg","caption":"SPLat Controls"},"image":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/spl_knowledgebase\/2876","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/spl_knowledgebase"}],"about":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/types\/spl_knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/users\/1"}],"up":[{"embeddable":true,"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/spl_knowledgebase\/2863"}],"wp:attachment":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/media?parent=2876"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}