{"id":3368,"date":"2025-04-18T05:44:21","date_gmt":"2025-04-18T05:44:21","guid":{"rendered":"https:\/\/webprojects.cloud\/wordpress\/splatco\/?post_type=spl_knowledgebase&p=3368"},"modified":"2025-06-10T11:00:16","modified_gmt":"2025-06-10T11:00:16","slug":"simplehmi-user-input","status":"publish","type":"spl_knowledgebase","link":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/","title":{"rendered":"SimpleHMI: User input"},"content":{"rendered":"\n

SimpleHMI<\/a>\u00a0provides a high level hash function,\u00a0IntInputEvent()<\/code>, to allow a user to input unsigned integer data. You can specify optional minimum and maximum values, and SimpleHMI takes care of ensuring that the\u00a0Enduser<\/a>\u00a0either supplies a value between the limits or “cancels out” of the operation. The maximum can be up to 9-9’s (999,999,999).<\/p>\n\n\n\n

When a enduser enters some data in response to an\u00a0IntInputEvent()<\/code>\u00a0hash function, an event is raised as per usual. When your event handler is called,\u00a0X<\/a>\u00a0will contain\u00a0True<\/code>\u00a0(non-zero) if the enduser actually supplied a number,\u00a0False<\/code>\u00a0if they Cancelled out. The number will be in W.<\/p>\n\n\n\n

Example:<\/p>\n\n\n\n

This example lets the enduser change 3 parameters within set limits. It uses the hash function\u00a0FloatVar()<\/a><\/code>\u00a0to display the current value of each parameter, and\u00a0IntInputEvent()<\/a><\/code>\u00a0to solicit a new value from the enduser.<\/p>\n\n\n\n

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

NOTE: This code will not work as-is on an actual HMI430 or HMI700.<\/strong><\/p>\n\n\n\n

************ SimpleHMI: user data entry ****************
                
kHMIEOMCode EQU 4   ;Termination character used in messages back from the SimpleHMI (*** Cannot be changed ***)
fParam1:  defFLOAT  ;3 user settable parameters
fParam2:  defFLOAT
fParam3:  defFLOAT

#       Open_Serial User(38400,8,N)
#       HMI_Disp ConnectEvent(HMIConnected)
;Initialise the user settable parameters
        fLoadW          5
        fStore          fParam1
        fLoadW          12
        fStore          fParam2
        fLoadW          300
        fStore          fParam3
        GoSub           HomePage
        LaunchTask      HeartBeat
        RunTasksForever    
       
;=======================================================       
HMIConnected:  ;Runs whenever HMI<\/a> sends a Connected event
        GoSub           HomePage
        Return
       
;=======================================================       
;Homepage
HomePage:
#       HMI Reset() HideAllButtons()    ;Force screen to a known state  
#       HMI ButtonEvent(, 5, 2, 3, 36, \"Configure parameters\", ConfigureParameters) 
        Return

;========================================================== 
;Parameter configuration screen 
ConfigureParameters: 
# HMI Reset() HideAllButtons()    ;Force screen to a known state
  
# HMI Cursor(2,3) SetFGColour(255,255,255) SetBGColour(0,0,0) Print(\"Setting 1: \") SetBGColour(0,255,255) SetFGColour(255,0,0)
# HMI FloatVar(fParam1,8,0) Print(\" \") ButtonEvent(,1,28,3,10, \"Change\", ReqChangeParam1) 

# HMI Cursor(7,3) SetFGColour(255,255,255) SetBGColour(0,0,0) Print(\"Setting 2: \") SetBGColour(0,255,255) SetFGColour(255,0,0)
# HMI FloatVar(fParam2,8,0) Print(\" \") ButtonEvent(,6,28,3,10, \"Change\", ReqChangeParam2) 

# HMI Cursor(12,3)  SetFGColour(255,255,255) SetBGColour(0,0,0) Print(\"Setting 3: \") SetBGColour(0,255,255) SetFGColour(255,0,0)
# HMI FloatVar(fParam3,8,0) Print(\" \") ButtonEvent(, 11, 28, 3, 10, \"Change\", ReqChangeParam3) 

        GoSub           UpMenuButton   ;Show a back button     
        Return
;-------------------------- Up one menu level  USES BUTTON 7 --------------------------
UpMenuButton:
#       HMI ButtonEvent(, 22, 0, 3, 9, \"<Back\", ssUpMenuButton) 
        Return
ssUpMenuButton: 
        GoSub           HomePage
        Return
;=======================================================       
;Event<\/a> handlers for when user clicks one of the \"Change setting\" buttons
ReqChangeParam1:
#       HMI      HideAllButtons() IntInputEvent(\"New value for setting 1\", 0, 100, GotChangeParam1)    
; Get user to supply an integer value ___|              |                  |   |            |
; Prompt text___________________________________________|                  |   |            |
;Minimum value. Not enforced if blank______________________________________|   |            |
;Maximum value. Not enforced if blank__________________________________________|            |
;Do this GoSub when user enters acceptable data ____________________________________________|      
        Return

ReqChangeParam2:
#       HMI HideAllButtons() IntInputEvent(\"What do you want setting 2 to be?\", 10, 20, GotChangeParam2)
        Return

ReqChangeParam3:
#       HMI HideAllButtons() IntInputEvent(\"How many jelly beans in the jar?\", 100, 1000, GotChangeParam3)
        Return

;=======================================================       
;Event handlers for when enduser enters new data  
GotChangeParam1:
       GoIfZ            GCP_Exit        ;g\/ user Cancelled
       fStore           fParam1 
       GoTo             GCP_Exit
GotChangeParam2:
       GoIfZ            GCP_Exit        ;g\/ user Cancelled
       fStore           fParam2 
       GoTo             GCP_Exit
GotChangeParam3:
       GoIfZ            GCP_Exit        ;g\/ user Cancelled
       fStore           fParam3 
;       GoTo             GCP_Exit
GCP_Exit:
       Gosub            ConfigureParameters  ;Back to param change screen
       Return

;================ Onscreen heartbeat (just for fun) =======================
HeartBeat:
#       HMI     PushColours()  SetBGColour(255,0,0) Cursor(24,38) Print(\"   \")   PopColours() 
        Pause   10
#       HMI     PushColours()  SetBGColour(64,0, 0) Cursor(24,38) Print(\"   \")   PopColours() 
        Pause   90
        GoTo    HeartBeat<\/pre>\n","protected":false},"excerpt":{"rendered":"
SimpleHMI\u00a0provides a high level hash function,\u00a0IntInputEvent(), to allow a user to input unsigned integer data. You can specify optional minimum and maximum values, and SimpleHMI…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":3355,"menu_order":8,"template":"","class_list":["post-3368","spl_knowledgebase","type-spl_knowledgebase","status-publish","hentry"],"acf":[],"yoast_head":"\nSimpleHMI: User input - 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=\"SimpleHMI: User input - SPLat Controls\" \/>\n<meta property=\"og:description\" content=\"SimpleHMI\u00a0provides a high level hash function,\u00a0IntInputEvent(), to allow a user to input unsigned integer data. You can specify optional minimum and maximum values, and SimpleHMI...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/\" \/>\n<meta property=\"og:site_name\" content=\"SPLat Controls\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-10T11:00:16+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\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/\",\"name\":\"SimpleHMI: User input - SPLat Controls\",\"isPartOf\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website\"},\"datePublished\":\"2025-04-18T05:44:21+00:00\",\"dateModified\":\"2025-06-10T11:00:16+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tutorials, application notes and white papers\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tutorial: SimpleHMI programming of SPLat controllers\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"SimpleHMI: User input\"}]},{\"@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":"SimpleHMI: User input - 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":"SimpleHMI: User input - SPLat Controls","og_description":"SimpleHMI\u00a0provides a high level hash function,\u00a0IntInputEvent(), to allow a user to input unsigned integer data. You can specify optional minimum and maximum values, and SimpleHMI...","og_url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/","og_site_name":"SPLat Controls","article_modified_time":"2025-06-10T11:00:16+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\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/","name":"SimpleHMI: User input - SPLat Controls","isPartOf":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website"},"datePublished":"2025-04-18T05:44:21+00:00","dateModified":"2025-06-10T11:00:16+00:00","breadcrumb":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/simplehmi-user-input\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/"},{"@type":"ListItem","position":2,"name":"Tutorials, application notes and white papers","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/"},{"@type":"ListItem","position":3,"name":"Tutorial: SimpleHMI programming of SPLat controllers","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/tutorials-application-notes-and-white-papers\/tutorial-simplehmi-programming-of-splat-controllers\/"},{"@type":"ListItem","position":4,"name":"SimpleHMI: User input"}]},{"@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\/3368","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\/3355"}],"wp:attachment":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/media?parent=3368"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}