{"id":3777,"date":"2025-04-21T09:28:13","date_gmt":"2025-04-21T09:28:13","guid":{"rendered":"https:\/\/webprojects.cloud\/wordpress\/splatco\/?post_type=spl_knowledgebase&p=3777"},"modified":"2025-06-10T05:48:27","modified_gmt":"2025-06-10T05:48:27","slug":"enablesmask-hash-function","status":"publish","type":"spl_knowledgebase","link":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/","title":{"rendered":"# Enables(Mask) hash function"},"content":{"rendered":"\n

Valid for use with hash command: HMI<\/a><\/code><\/p>\n\n\n\n

Implemented on the following platforms: Windows standalone<\/p>\n\n\n\n

This function determines which controls will be available on the SimpleHMI<\/a> screen. Mask<\/code> consists of 8 semaphores packed into a single byte. Each semaphore controls the visibility of one item. This allows you to control what your Enduser<\/a> will see in the standalone Windows version of SimpleHMI.<\/p>\n\n\n\n

The following defines the bit (semaphore) numbers within the byte, and what they control:<\/p>\n\n\n\n

Bit<\/th>Controls<\/th>Notes<\/th><\/tr>
0<\/td>Connect button<\/td> <\/td><\/tr>
1<\/td>Reset button<\/td> <\/td><\/tr>
2<\/td>CLS button<\/td> <\/td><\/tr>
3<\/td>Rulers button<\/td> <\/td><\/tr>
4<\/td>A\/R (aspect ratio) settings<\/td> <\/td><\/tr>
5<\/td>Width settings<\/td> <\/td><\/tr>
6<\/td>Show log button<\/td>The enduser can still set a log file name on the settings tab, so you can implement logging in your app.<\/td><\/tr>
7<\/td>Terminal tab<\/td>Also controls relevant settings on the Settings tab. The terminal is by default hidden in the standalone Windows SimpleHMI. It can be made visible by the command-line\/shortcut switch \/T<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Example program:<\/h2>\n\n\n\n

The following program produces a SimpleHMI screen that can be used to control the visibility of all controllable items. In a practical application you would most likely just send a fixed pattern to the SimpleHMI when you draw the initial screen.<\/p>\n\n\n\n

(Click here<\/a> for some tips for working around problems with copy and paste out of Internet Explorer and HTML-help (.chm)<\/code> files)<\/p>\n\n\n\n

;========= Test enables in standalone sHMI =========================
#       Open_Serial User(38400,8,N)  
        GoSub           HMI_Connect
#       HMI<\/a> ConnectEvent(HMI_Connect)       
        RunTasksForever
         
;ON connecting to SimpleHMI, force the screen to a known width
HMI_Connect:
# HMI Reset() Cls() HideAllButtons() ScreenWidthEvent(40,evScreenWidth)  
        Return
 
;Once the SimpleHMI acknowledges the screen width, draw the buttons.       
evScreenWidth:
# HMI Cursor(1, C-10) Print(\"Test control enables\")
# HMI ButtonEvent(, 0.2, 0.1, 0.1, 0.3, \"Connect\", evConnect)              
# HMI ButtonEvent(, 0.2, 0.6, 0.1, 0.3, \"Reset\", evReset)              

# HMI ButtonEvent(, 0.4, 0.1, 0.1, 0.3, \"Cls\", evCls)              
# HMI ButtonEvent(, 0.4, 0.6, 0.1, 0.3, \"Ruler\", evRuler)              

# HMI ButtonEvent(, 0.6, 0.1, 0.1, 0.3, \"A\/R\", evAspect)              
# HMI ButtonEvent(, 0.6, 0.6, 0.1, 0.3, \"Width\", evWidth)              
                                                         
# HMI ButtonEvent(, 0.8, 0.1, 0.1, 0.3, \"Show log\", evShowLog)              
# HMI ButtonEvent(, 0.8, 0.6, 0.1, 0.3, \"Terminal\", evTerminal)              
                                                         
;Controlling enables. One semaphore byte
bEnables        defBYTE
;Define the enable semaphore bits
sConnect        EQU     0
sReset          EQU     1
sCls            EQU     2
sRuler          EQU     3
sAspect         EQU     4
sWidth          EQU     5
sShowLog        EQU     6    
sTerminal       EQU     7

;Event<\/a> handlers for each of th enable buttons.  
evConnect:      LoadI   sConnect
                GoTo    ToggleEnable

evReset:        LoadI   sReset
                GoTo    ToggleEnable

evCls:          LoadI   sCls
                GoTo    ToggleEnable

evRuler:        LoadI   sRuler
                GoTo    ToggleEnable

evAspect:       LoadI   sAspect
                GoTo    ToggleEnable

evWidth:        LoadI   sWidth
                GoTo    ToggleEnable

evShowLog:      LoadI   sShowLog
                GoTo    ToggleEnable

evTerminal:     LoadI   sTerminal
                GoTo    ToggleEnable
ToggleEnable:
                IasJ:RecallS    0,bEnables 
                Not
                IasJ:StoreS     0,bEnables
# HMI Enables(bEnables)                         ;Send enables mask to SimpleHMI
                Return                <\/pre>\n\n\n\n
The Enables hash function is intended for use in cases where the standalone SimpleHMI for Windows is to be used by an enduser. It also works in the SPLat\/PC version.<\/p>\n\n\n\n
In the SPLat\/PC version, you can restore the default settings by holding down SHIFT and clicking the blue SimpleHMI title bar.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n\n","protected":false},"excerpt":{"rendered":"
Valid for use with hash command: HMI Implemented on the following platforms: Windows standalone This function determines which controls will be available on the SimpleHMI screen. Mask consists of 8…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":3768,"menu_order":7,"template":"","class_list":["post-3777","spl_knowledgebase","type-spl_knowledgebase","status-publish","hentry"],"acf":[],"yoast_head":"\n# Enables(Mask) hash function - 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=\"# Enables(Mask) hash function - SPLat Controls\" \/>\n<meta property=\"og:description\" content=\"Valid for use with hash command: HMI Implemented on the following platforms: Windows standalone This function determines which controls will be available on the SimpleHMI screen. Mask consists of 8...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/\" \/>\n<meta property=\"og:site_name\" content=\"SPLat Controls\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-10T05:48:27+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png\" \/>\n\t<meta property=\"og:image:width\" content=\"335\" \/>\n\t<meta property=\"og:image:height\" content=\"129\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\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\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/\",\"name\":\"# Enables(Mask) hash function - SPLat Controls\",\"isPartOf\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png\",\"datePublished\":\"2025-04-21T09:28:13+00:00\",\"dateModified\":\"2025-06-10T05:48:27+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#primaryimage\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png\",\"contentUrl\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png\",\"width\":335,\"height\":129},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Deprecated\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"# HMI Android & Windows\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"# Enables(Mask) hash function\"}]},{\"@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":"# Enables(Mask) hash function - 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":"# Enables(Mask) hash function - SPLat Controls","og_description":"Valid for use with hash command: HMI Implemented on the following platforms: Windows standalone This function determines which controls will be available on the SimpleHMI screen. Mask consists of 8...","og_url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/","og_site_name":"SPLat Controls","article_modified_time":"2025-06-10T05:48:27+00:00","og_image":[{"width":335,"height":129,"url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png","type":"image\/png"}],"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\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/","name":"# Enables(Mask) hash function - SPLat Controls","isPartOf":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website"},"primaryImageOfPage":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#primaryimage"},"image":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#primaryimage"},"thumbnailUrl":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png","datePublished":"2025-04-21T09:28:13+00:00","dateModified":"2025-06-10T05:48:27+00:00","breadcrumb":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#primaryimage","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png","contentUrl":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-content\/uploads\/2025\/04\/Enables.png","width":335,"height":129},{"@type":"BreadcrumbList","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/enablesmask-hash-function\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/"},{"@type":"ListItem","position":2,"name":"Deprecated","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/"},{"@type":"ListItem","position":3,"name":"# HMI Android & Windows","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/deprecated\/hmi-android-windows\/"},{"@type":"ListItem","position":4,"name":"# Enables(Mask) hash function"}]},{"@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\/3777","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\/3768"}],"wp:attachment":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/media?parent=3777"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}