View source for Vending Machine Export IC10

This solution will export a given quantity of the specified item from a vending machine.
[[File:VendingExporterSetup.png|thumb|right|Connect the three devices with chutes as shown in the diagram.]]
== Required Items ==

* 1 x [[Vending Machine]]
* 1 x [[Integrated Circuit (IC10)]]
* 1 x [[Kit (IC Housing)|IC Housing]]
* 1 x [[Stacker]]
* 1 x [[Sorter]]
* 2 x [[Kit_(Logic_Memory) | Logic Memory]]
* [[Cables]] and [[Chutes]]
{| class="mw-collapsible mw-collapsed"
!Source code:
|-
|<div style="background: #000000; float: none">
<p style="float: none; white-space: pre; line-height: 1; color: #FFFFFF; background: #000000; font-size: 110%;font-family:Consolas; margin-left: 10px;><span style="color: #FF8000;">#Vending machine item exporter
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rTemp</span><span> </span><span>r0</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rTemp2</span><span> </span><span>r1</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rBusy</span><span> </span><span>r2</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rReqHash</span><span> </span><span>r9</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rReqCount</span><span> </span><span>r10</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rMaxUnitStack</span><span> </span><span>r11</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rStackerCount</span><span> </span><span>r12</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>rStackerSetting</span><span> </span><span>r13</span><span>
</span><span></span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>dVender</span><span> </span><span>d0</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>dStacker</span><span> </span><span>d1</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>dSorter</span><span> </span><span>d2</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>dMemHash</span><span> </span><span>d3</span><span>
</span><span style="color: #00FFFF;">alias</span><span> </span><span>dMemCount</span><span> </span><span>d4</span><span>
</span><span style="color: #FF8000;">#alias dStartExport d5
</span><span></span><span>
</span><span>main:</span><span>
</span><span>yield</span><span>
</span><span style="color: #00FFFF;">l</span><span> </span><span>rBusy</span><span> </span><span>dMemCount</span><span> </span><span>Setting</span><span>
</span><span style="color: #FF0000;">beqz</span><span> </span><span>rBusy</span><span> </span><span>main</span><span>
</span><span style="color: #00FFFF;">l</span><span> </span><span>rBusy</span><span> </span><span>dMemHash</span><span> </span><span>Setting</span><span>
</span><span style="color: #FF0000;">beqz</span><span> </span><span>rBusy</span><span> </span><span>main</span><span>
</span><span style="color: #FF0000;">jal</span><span> </span><span>_Configuration</span><span>
</span><span style="color: #00FFFF;">l</span><span> </span><span>rReqCount</span><span> </span><span>dMemCount</span><span> </span><span>Setting</span><span>
</span><span style="color: #00FFFF;">l</span><span> </span><span>rReqHash</span><span> </span><span>dMemHash</span><span> </span><span>Setting</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dMemCount</span><span> </span><span>Setting</span><span> </span><span>0</span><span>
</span><span style="color: #FF0000;">jal</span><span> </span><span>_ExportItem</span><span>
</span><span style="color: #FF0000;">j</span><span> </span><span>main</span><span>
</span><span></span><span>
</span><span>_Configuration:</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dSorter</span><span> </span><span>Mode</span><span> </span><span>0</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dStacker</span><span> </span><span>Mode</span><span> </span><span>1</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dStacker</span><span> </span><span>ClearMemory</span><span> </span><span>1</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dSorter</span><span> </span><span>ClearMemory</span><span> </span><span>1</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dVender</span><span> </span><span>ClearMemory</span><span> </span><span>1</span><span>
</span><span style="color: #FF0000;">j</span><span> </span><span>ra</span><span>

</span><span>_ExportItem:</span><span>
</span><span style="color: #6666FF;">push</span><span> </span><span>ra</span><span>
</span><span>ExportItemLoop:</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rTemp</span><span> </span><span>dStacker</span><span> </span><span>2</span><span> </span><span>Quantity</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dVender</span><span> </span><span>RequestHash</span><span> </span><span>rReqHash</span><span>
</span><span style="color: #FF8000;">#wait for item to arrive
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rTemp2</span><span> </span><span>dStacker</span><span> </span><span>2</span><span> </span><span>Quantity</span><span>
</span><span style="color: #FF0000;">breq</span><span> </span><span>rTemp</span><span> </span><span>rTemp2</span><span> </span><span>-1</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rStackerCount</span><span> </span><span>dStacker</span><span> </span><span>2</span><span> </span><span>Quantity</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rMaxUnitStack</span><span> </span><span>dStacker</span><span> </span><span>2</span><span> </span><span>MaxQuantity</span><span>
</span><span style="color: #FF0000;">jal</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #6666FF;">min</span><span> </span><span>rStackerSetting</span><span> </span><span>rReqCount</span><span> </span><span>rMaxUnitStack</span><span>
</span><span style="color: #6666FF;">min</span><span> </span><span>rStackerSetting</span><span> </span><span>rStackerSetting</span><span> </span><span>rStackerCount</span><span>
</span><span style="color: #FF0000;">breq</span><span> </span><span>rStackerCount</span><span> </span><span>rMaxUnitStack</span><span> </span><span>2</span><span>
</span><span style="color: #FF0000;">bgt</span><span> </span><span>rReqCount</span><span> </span><span>rStackerCount</span><span> </span><span>ExportItemLoop</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dStacker</span><span> </span><span>Setting</span><span> </span><span>rStackerSetting</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dSorter</span><span> </span><span>Output</span><span> </span><span>0</span><span>
</span><span style="color: #FF0000;">jal</span><span> </span><span>_RunStacker</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rStackerCount</span><span> </span><span>dStacker</span><span> </span><span>2</span><span> </span><span>Quantity</span><span>
</span><span style="color: #6666FF;">sub</span><span> </span><span>rReqCount</span><span> </span><span>rReqCount</span><span> </span><span>rStackerSetting</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rReqCount</span><span> </span><span>ExportItemLoop</span><span>
</span><span style="color: #FF8000;">#done, route any leftovers to the vender
</span><span style="color: #FF0000;">beqz</span><span> </span><span>rStackerCount</span><span> </span><span>ExportItemExit</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dStacker</span><span> </span><span>Setting</span><span> </span><span>rStackerCount</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dSorter</span><span> </span><span>Output</span><span> </span><span>1</span><span>
</span><span style="color: #FF0000;">jal</span><span> </span><span>_RunStacker</span><span>
</span><span>ExportItemExit:</span><span>
</span><span style="color: #6666FF;">pop</span><span> </span><span>ra</span><span>
</span><span style="color: #FF0000;">j</span><span> </span><span>ra</span><span>
</span><span></span><span>
</span><span>_RunStacker:</span><span>
</span><span style="color: #6666FF;">push</span><span> </span><span>ra</span><span>
</span><span style="color: #00FFFF;">l</span><span> </span><span>rTemp</span><span> </span><span>dSorter</span><span> </span><span>ImportCount</span><span>
</span><span style="color: #00FFFF;">s</span><span> </span><span>dStacker</span><span> </span><span>Output</span><span> </span><span>1</span><span>
</span><span style="color: #FF8000;">#wait for item to arrive
</span><span style="color: #00FFFF;">l</span><span> </span><span>rTemp2</span><span> </span><span>dSorter</span><span> </span><span>ImportCount</span><span>
</span><span style="color: #FF0000;">breq</span><span> </span><span>rTemp</span><span> </span><span>rTemp2</span><span> </span><span>-1</span><span>
</span><span style="color: #FF0000;">jal</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #6666FF;">pop</span><span> </span><span>ra</span><span>
</span><span style="color: #FF0000;">j</span><span> </span><span>ra</span><span>
</span><span></span><span>
</span><span>_WaitForDevices:</span><span>
</span><span>yield</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dSorter</span><span> </span><span>0</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dSorter</span><span> </span><span>1</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dSorter</span><span> </span><span>2</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dVender</span><span> </span><span>0</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dVender</span><span> </span><span>1</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #FF8000;">#if the stacker is full so we skip it
</span><span style="color: #FF0000;">beq</span><span> </span><span>rStackerCount</span><span> </span><span>rMaxUnitStack</span><span> </span><span>WaitEnd</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dStacker</span><span> </span><span>0</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span style="color: #00FFFF;">ls</span><span> </span><span>rBusy</span><span> </span><span>dStacker</span><span> </span><span>1</span><span> </span><span>Occupied</span><span>
</span><span style="color: #FF0000;">bgtz</span><span> </span><span>rBusy</span><span> </span><span>_WaitForDevices</span><span>
</span><span>WaitEnd:</span><span>
</span><span style="color: #FF0000;">j</span><span> </span><span>ra
</span>
</p>
</div>

|}


== Setup ==

* Place all components listed above and connect them using [[Cables]] and [[Chutes]] as shown in the picture. (For cables just connect everything)
* Load the code into the IC and turn everything on
* You may want to put a junction and an inlet to the import of the vending machine so you can restock it.

== Usage ==

# Set the two memory modules with the quantity and the hash of the item.
# Unless busy, the IC will set the quantity memory to zero and start the export process.
# Excess items will be routed back into the vending machine.

''' NOTE: ''' The IC can handle split stacks of small quantities in the vending machine or exporting more than one stack. It does '''NOT''' handle having insufficient items in the vending machine and will halt until you fill it and export it manually (or reset the whole process)

== How It Works ==

=== Main loop ===

* Wait until both memory modules have a non-zero value.
* Run device configuration.
* Store request hash and quantity.
* Reset the memory for quantity to indicate the start of the export (and so we don't keep exporting the same item)
* Run the item export function.

=== _Configuration ===

* Configure the sorter for default mode, and the stacker for manual.

=== _ExportItem ===
* Request the item from the vender and wait for it to arrive into the stacker, then run _WaitForDevices to make sure nothing is busy.
* Calculate the setting for the stacker depending on the remaining items, the quantity inside the stacker and the maximum stacking size (in manual mode, it won't do anything until the Output parameter is set to 1)
* Either make another request from the vender, or flush the stacker if it's full.
* Make more requests if there are remaining items, or empty the stacker and route any excess items back into the vender.

=== _RunStacker ===
* Set the output of the sorter, run the stacker and wait for the item to arrive in the sorter.

=== _WaitForDevices ===
* Makes sure none of the devices have occupied import/export slots - the exception being the stacker, since it may have a full processing slot and items stuck in the import slot (for example when the vender exports 30 coal twice in a row. 50 will be in the processing slot and 10 in import.)