{"id":1855,"date":"2025-04-14T08:35:13","date_gmt":"2025-04-14T08:35:13","guid":{"rendered":"https:\/\/webprojects.cloud\/wordpress\/splatco\/?post_type=spl_knowledgebase&p=1855"},"modified":"2025-06-10T08:41:32","modified_gmt":"2025-06-10T08:41:32","slug":"spice10218-programming","status":"publish","type":"spl_knowledgebase","link":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/","title":{"rendered":"SPice10218: Programming"},"content":{"rendered":"\n

Once installed on a SPLat controller, the SPice10218 appears as one analog input and 3 digital outputs. 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>. You should use fAnIn<\/code> to get the full benefit of 10-bit resolution.<\/p>\n\n\n\n

 <\/th>SPice<\/a> cnctr pin<\/th>SLXXX<\/th>MMiXXX<\/th>MS12x<\/th><\/tr>
Analog input<\/th>4<\/th>AnInC (2)<\/td>AnInE (4)<\/td>AnInC (2)<\/td><\/tr>
Channel select 2<\/th>5<\/th>DO 9<\/td>DO 17<\/td>DO 13<\/td><\/tr>
Channel select 1<\/th>6<\/th>DO 10<\/td>DO 18<\/td>DO 14<\/td><\/tr>
Channel select 0<\/th>7<\/th>DO 11<\/td>DO 19<\/td>DO 15<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

The SPice10218 is a multiplexer. That means it has the ability to select any one of its 8 analog input lines and route that through to a single analog input on the main SPLat controller board, where it can be read by an analog input instruction, e.g. fAnIn<\/code>. The channel to be read is selected by sending a binary coded channel number to 3 “channel select” outputs. The analog input channel used, and the 3 channel select outputs, vary between SPLat controller boards according to the table above.<\/p>\n\n\n\n

Channel select patterns<\/h6>\n\n\n\n

The following table defines the bit patterns for the 3 channel select outputs and the corresponding input channel numbers.<\/p>\n\n\n\n

 <\/td>Channel select out<\/th><\/tr>
Ch<\/th>0<\/th>1<\/th>2<\/th><\/tr>
0<\/th>Off<\/td>Off<\/td>Off<\/td><\/tr>
1<\/th>On<\/td>Off<\/td>Off<\/td><\/tr>
2<\/th>Off<\/td>On<\/td>Off<\/td><\/tr>
3<\/th>On<\/td>On<\/td>Off<\/td><\/tr>
4<\/th>Off<\/td>Off<\/td>On<\/td><\/tr>
5<\/th>On<\/td>Off<\/td>On<\/td><\/tr>
6<\/th>Off<\/td>On<\/td>On<\/td><\/tr>
7<\/th>On<\/td>On<\/td>On<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

You may recognize this as a simply binary count, which indeed it is. Note however that the the least significant channel select bit is in the most significant of the three outputs.<\/p>\n\n\n\n

Initializing the SPice connector<\/h6>\n\n\n\n

Because the pins of the SPice connector, to which the SPice10218 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 SPice10218.<\/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 SPice10218.<\/p>\n\n\n\n

         ClrU<\/a>
         setu<\/a>         0,3         ;set spice connector pin 4 as analogue input
         setu         1,1         ;set spice connector pin 5 as digital output
         setu         2,1         ;set spice connector pin 6 as digital output
         setu         3,1         ;set spice connector pin 7 as digital output
         setu         4,0         ;set spice connector pin 8 as unchanged
         setu         5,0         ;set spice connector pin 9 as unchanged
         SpiceConfigU<\/a><\/pre>\n\n\n\n
Reading an analog value (example program)<\/h6>\n\n\n\n
Once the SPice connector has been initialized (which you would do early in your program using the code above), reading a channel requires setting the channel select outputs to the right pattern, allowing the analog voltage to settle, and then executing an analog input instruction.<\/p>\n\n\n\n
The analog settling time must be taken into account. It cannot be ignored<\/em>. The settling time constant is up about 0.5mS. It takes 7 time constants to settle to 10 bits. Hence the multiplexer requires at least 3.5mS to settle to 10 bits.<\/p>\n\n\n\n
The following is a MultiTrack task that will automatically scan all 8 channels. To use it copy and paste the code into your program and edit the SP218_MUXStart <\/code>and SP218_AnIn<\/code> constant values to match your controller type. To start it up simply LaunchTask<\/a> Scan218. <\/code>To access a reading load X<\/a> with the required channel number 0-7 and GoSub Get218Reading.<\/code> The latest reading for the required channel will be returned in W as a normalized number 0-1.<\/p>\n\n\n\n
* The following equates select the base address for the MUX select lines on the
* SPICE connector based on the board type:
*
* SL99, SL100                           SP218_MUXStart =  9, SP218_AnIn = 2
* MMi99<\/a>, MMi200, MMi201, MMi202         SP218_MUXStart = 17, SP218_AnIn = 4
* MS12, MS120                           SP218_MUXStart = 13, SP218_AnIn = 2

SP218_MUXStart  equ     17      ;MMiXXX
SP218_AnIn      equ     4


Ch218           defBYTE
Readings218     defFLOAT        8       ;Result holding variables

;The scanner stores readings in an array of 8 floating point numbers.
;Because of the bit reversal that takes place on the 218 board, the 
;order of readings in memory will be scrambled. This gets sorted out
;by bit reversing the index used during readout, in Get218Reading.
Scan218:
                Recall          Ch218
                LoadX           7
                OutputM         SP218_MUXStart
                Pause           2\t         ;Guarantee 10mS minimum settling delay.
                fAnIn           SP218_AnIn
                Recall          Ch218
                Push
                XtoI
                IasJ:fStore     Readings218
                IncX
                LoadX           7
                AndM
                Store           Ch218
                GoTo            Scan218

;Return the latest reading for the channel number in X
Get218Reading:
                GoSub           ReverseBits012
                XtoI
                IasJ:fRecallW   Readings218
                Return

ReverseBits012: ;Reverse bit order 0, 1, 2 in X         
RB_X1           defBYTE
RB_X2           defBYTE

RB_Y0           SetMem          RB_X2,0
                Store           RB_X1
                GoIfSF          0,RB_X1,RB_Y1
                SetS            2,RB_X2
RB_Y1           GoIfSF          1,RB_X1,RB_Y2
                SetS            1,RB_X2
RB_Y2           GoIfSF          2,RB_X1,RB_Y3
                SetS            0,RB_X2
RB_Y3           Recall          RB_X2
                Return<\/pre>\n","protected":false},"excerpt":{"rendered":"
Once installed on a SPLat controller, the SPice10218 appears as one analog input and 3 digital outputs. The following table shows the mappings for all…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1849,"menu_order":4,"template":"","class_list":["post-1855","spl_knowledgebase","type-spl_knowledgebase","status-publish","hentry"],"acf":[],"yoast_head":"\nSPice10218: 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=\"SPice10218: Programming - SPLat Controls\" \/>\n<meta property=\"og:description\" content=\"Once installed on a SPLat controller, the SPice10218 appears as one analog input and 3 digital outputs. 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\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/\" \/>\n<meta property=\"og:site_name\" content=\"SPLat Controls\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-10T08:41:32+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=\"3 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\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/\",\"url\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/\",\"name\":\"SPice10218: Programming - SPLat Controls\",\"isPartOf\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website\"},\"datePublished\":\"2025-04-14T08:35:13+00:00\",\"dateModified\":\"2025-06-10T08:41:32+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-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\":\"SPIce 10218 – 8 channel analog input multiplexer\",\"item\":\"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"SPice10218: 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":"SPice10218: 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":"SPice10218: Programming - SPLat Controls","og_description":"Once installed on a SPLat controller, the SPice10218 appears as one analog input and 3 digital outputs. The following table shows the mappings for all...","og_url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/","og_site_name":"SPLat Controls","article_modified_time":"2025-06-10T08:41:32+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/","url":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/","name":"SPice10218: Programming - SPLat Controls","isPartOf":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/#website"},"datePublished":"2025-04-14T08:35:13+00:00","dateModified":"2025-06-10T08:41:32+00:00","breadcrumb":{"@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-programming\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/spice10218-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":"SPIce 10218 – 8 channel analog input multiplexer","item":"https:\/\/webprojects.cloud\/wordpress\/splatco\/knowledgebase\/product-documentation\/product-documentation-spice-add-on-boards\/spice-10218-8-channel-analog-input-multiplexer\/"},{"@type":"ListItem","position":5,"name":"SPice10218: 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\/1855","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\/1849"}],"wp:attachment":[{"href":"https:\/\/webprojects.cloud\/wordpress\/splatco\/wp-json\/wp\/v2\/media?parent=1855"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}