{"id":1848,"date":"2025-04-14T08:30:30","date_gmt":"2025-04-14T08:30:30","guid":{"rendered":"https:\/\/webprojects.cloud\/wordpress\/splatco\/?post_type=spl_knowledgebase&p=1848"},"modified":"2025-06-10T08:40:16","modified_gmt":"2025-06-10T08:40:16","slug":"spice10214-programming","status":"publish","type":"spl_knowledgebase","link":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/","title":{"rendered":"SPice10214: Programming"},"content":{"rendered":"\n

Once installed on a SPLat controller, the SPice10211 appears as several regular analog and digital I\/O points. The following table shows the mappings for all the I\/O on the board. Numbers in parenthesis are the numeric analog channel numbers used with fAnIn<\/a><\/code>.<\/p>\n\n\n\n

 <\/th>Cnctr pin<\/th>SLXXX<\/th>MMiXXX<\/th>MS12<\/th><\/tr>
P1 (Onboard)<\/th>7<\/th>AnInF (5)<\/td>AnInH (7)<\/td>AnInF (5)<\/td><\/tr>
P2<\/th>5<\/th>AnInD (3)<\/td>AnInF (5)<\/td>AnInD (3)<\/td><\/tr>
P3<\/th>6<\/th>AnInE (4)<\/td>AnInG (6)<\/td>AnInE (4)<\/td><\/tr>
P4<\/th>4<\/th>AnInC (2)<\/td>AnInE (4)<\/td>AnInC (2)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
initializing the SPice<\/a> connector<\/h6>\n\n\n\n

Because the pins of the SPice connector, to which the SPice10214 is connected, can be configured for different functions (analog\/digital, input\/output), you need to have some code in your program that configures them to the correct settings for the SPice12014.<\/p>\n\n\n\n

The following section of code should be run by your program just once, at the beginning, before your program attempts to do anything else with the SPice10214.<\/p>\n\n\n\n

         ClrU<\/a>
         setu<\/a>         0,3         ;set spice connector pin 4 as analogue input
         setu         1,3         ;set spice connector pin 5 as analogue input
         setu         2,3         ;set spice connector pin 6 as analogue input
         setu         3,3         ;set spice connector pin 7 as analogue input
         SpiceConfigU<\/a><\/pre>\n\n\n\n
Once that is done programming is a simple matter of executing an analog input instruction against the input of interest.<\/p>\n\n\n\n
The readings (values) obtained will depend on the potentiometer setting, and nominally range from 0 to 255. In practice you should allow for a few missing codes at each end of the scale due to potentiometer end resistances and inevitable errors in the analog inputs of the SPLat.<\/p>\n\n\n\n
Do not rely on obtaining a reading of 0 or 255 for something mission critical to happen in your controller.<\/p>\n\n\n\n
The best strategy is to work on an active range of 5 minimum and 245 maximum (but still tolerate 0 to 255 without doing something silly).<\/p>\n\n\n\n
Example program<\/h6>\n\n\n\n
The following program illustrates how you can use the SPice10214 to create a variable timer.<\/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
Example program:
;vartime.spt - SPice10214 demo program for MS12

;This program illustrates the use of a potentiometer to create 
;a variable timer. It does the following:

;       1       Reads potentiometer on P3
;       2       Limits the range to 5-245
;       3       Shifts it to 0-240 and displays.
;       4       Scales to 1 to 5 seconds and displays
;       5       Generates an output pulse of 1 to 5 seconds
;               when a button is pressed.


        ON              20      ;LCD backlight
;Initialize the SPice connector for SPice10214
        ClrU
        setu            0,3     ;set spice connector pin 4 as analogue input
        setu            1,3     ;set spice connector pin 5 as analogue input
        setu            2,3     ;set spice connector pin 6 as analogue input
        setu            3,3     ;set spice connector pin 7 as analogue input
        SpiceConfigU

;----- Main loop ------
Loop:
        AnInE<\/a>                           ;Read the pot
        GoSub           Fixup           ;Limit range to 5-245, shift to 0-240
        OBLCD_SetCur<\/a>    1,0
        Push<\/a>
        OBLCD_UDecDispXFW<\/a>               ;Display the semi-processed reading
        float<\/a>                           ;Convert to floating point
        fLoadQ<\/a>          0.016667        ;Scale 0-240 to 0-4
        fMul<\/a>
        fLoadQ<\/a>          1               ;1s offset, giving the range 1 to 5
        fAdd<\/a>
        OBLCD_fDispW<\/a>    6,1             ;Display
        InputK<\/a>          16
        GoSubIfT<\/a>        PulseOut        ;Time duration is already in W
        GoTo            Loop            ;Repeat forever

;-------- Generate an output pulse equal to the value in W, in seconds.
PulseOut:
        fLoadQ          10
        fMul<\/a>                            ; now in units of 100mS
        fSetTimer<\/a>       0               ;Start timing
        On              8               ;Turn on the output
PO1:
        Test<\/a>            0               ;Timed out
        GoIfT<\/a>           PO1             ;g\/ not yet
        Off             8               ;Turnoff the output
        Return                          ;All done

;=================================================
;Bound X<\/a> within range 5 to 245, offset to 0 to 240
;I've made this a subroutine because it can then be re-used for all
;4 channels of the SPice10214.
Fixup:
        Push                            ;Make a copy
        GoIfXGE<\/a>         5,L1            ;Test if < 5
        LoadX           5               ;Anything < 5 becomes 5
L1:
        Push                            ;Make a copy
        GoIfXLE<\/a>         245,L2          ;Test if > 245
        LoadX           245             ;Anything > 245 becomes 245
L2:
        DecX<\/a>                            ;Knock off 5 counts ...
        DecX                            ; ... reducing range...
        DecX                            ; ... 5 - 245 ...
        DecX                            ; ... to ...
        DecX                            ; ... 0 - 240
        Return<\/pre>\n","protected":false},"excerpt":{"rendered":"
Once installed on a SPLat controller, the SPice10211 appears as several regular analog and digital I\/O points. The following table shows the mappings for all…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1840,"menu_order":6,"template":"","class_list":["post-1848","spl_knowledgebase","type-spl_knowledgebase","status-publish","hentry"],"acf":[],"yoast_head":"\nSPice10214: Programming - 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=\"SPice10214: Programming - SPLat Controls\" \/>\n<meta property=\"og:description\" content=\"Once installed on a SPLat controller, the SPice10211 appears as several regular analog and digital I\/O points. The following table shows the mappings for all...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/\" \/>\n<meta property=\"og:site_name\" content=\"SPLat Controls\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-10T08:40: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\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/\",\"name\":\"SPice10214: Programming - SPLat Controls\",\"isPartOf\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website\"},\"datePublished\":\"2025-04-14T08:30:30+00:00\",\"dateModified\":\"2025-06-10T08:40:16+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Product documentation\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Product documentation: SPice add-on boards\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"SPice10214 – Potentiometer interface\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"SPice10214: Programming\"}]},{\"@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":"SPice10214: Programming - 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":"SPice10214: Programming - SPLat Controls","og_description":"Once installed on a SPLat controller, the SPice10211 appears as several regular analog and digital I\/O points. The following table shows the mappings for all...","og_url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/","og_site_name":"SPLat Controls","article_modified_time":"2025-06-10T08:40: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\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/","name":"SPice10214: Programming - SPLat Controls","isPartOf":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website"},"datePublished":"2025-04-14T08:30:30+00:00","dateModified":"2025-06-10T08:40:16+00:00","breadcrumb":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/spice10214-programming\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/"},{"@type":"ListItem","position":2,"name":"Product documentation","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/"},{"@type":"ListItem","position":3,"name":"Product documentation: SPice add-on boards","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/"},{"@type":"ListItem","position":4,"name":"SPice10214 – Potentiometer interface","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice10214-potentiometer-interface\/"},{"@type":"ListItem","position":5,"name":"SPice10214: Programming"}]},{"@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\/1848","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\/1840"}],"wp:attachment":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/media?parent=1848"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}