Vending Machine Export IC10 - Revision history

Emilgardis: Use proper/better category -> IC10

2024-05-23T18:22:22Z

Use proper/better category -> IC10

Legolegs: Category:MIPS Programming

2020-06-18T20:45:09Z

Category:MIPS Programming

JedBolt at 18:24, 30 March 2019

2019-03-30T18:24:34Z

JedBolt at 22:24, 29 March 2019

2019-03-29T22:24:32Z

JedBolt: minor corrections

2019-03-29T22:21:19Z

minor corrections

JedBolt at 22:17, 29 March 2019

2019-03-29T22:17:05Z

JedBolt: Added a guide for setting up an automated vending machine exporter project.

2019-03-29T22:10:08Z

Added a guide for setting up an automated vending machine exporter project.

New page

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">
#Vending machine item exporter
alias rTemp r0
alias rTemp2 r1
alias rSorterBusy r6
alias rSorterOutput r7
alias rBusy r2
alias rReqHash r9
alias rReqCount r10
alias rMaxUnitStack r11
alias rStackerCount r12
alias rStackerSetting r13

alias dVender d0
alias dStacker d1
alias dSorter d2
alias dMemHash d3
alias dMemCount d4
#alias dStartExport d5

main:
yield
l rBusy dMemCount Setting
beqz rBusy main
l rBusy dMemHash Setting
beqz rBusy main
jal _Configuration
l rReqCount dMemCount Setting
l rReqHash dMemHash Setting
s dMemCount Setting 0
jal _ExportItem
j main

_Configuration:
s dSorter Mode 0
s dStacker Mode 1
s dStacker ClearMemory 1
s dSorter ClearMemory 1
s dVender ClearMemory 1
j ra

_ExportItem:
push ra
ExportItemLoop:
ls rTemp dStacker 2 Quantity
s dVender RequestHash rReqHash
#wait for item to arrive
ls rTemp2 dStacker 2 Quantity
breq rTemp rTemp2 -1
ls rStackerCount dStacker 2 Quantity
ls rMaxUnitStack dStacker 2 MaxQuantity
jal _WaitForDevices
s db Setting rMaxUnitStack
min rStackerSetting rReqCount rMaxUnitStack
min rStackerSetting rStackerSetting rStackerCount
breq rStackerCount rMaxUnitStack 2
bgt rReqCount rStackerCount ExportItemLoop
s dStacker Setting rStackerSetting
move rSorterOutput 0
jal _RunStacker
ls rStackerCount dStacker 2 Quantity
sub rReqCount rReqCount rStackerSetting
bgtz rReqCount ExportItemLoop
#done, route any leftovers to the vender
beqz rStackerCount ExportItemExit
s dStacker Setting rStackerCount
move rSorterOutput 1
jal _RunStacker
#wait for item to arrive
l rTemp dVender ImportCount
l rTemp2 dVender ImportCount
breq rTemp rTemp2 -1
ExportItemExit:
pop ra
j ra

_RunStacker:
push ra
s dSorter Output rSorterOutput
l rTemp dSorter ImportCount
s dStacker Output 1
#wait for item to arrive
l rTemp2 dSorter ImportCount
breq rTemp rTemp2 -1
jal _WaitForDevices
pop ra
j ra

_WaitForDevices:
yield
ls rBusy dSorter 0 Occupied
bgtz rBusy _WaitForDevices
ls rBusy dSorter 1 Occupied
bgtz rBusy _WaitForDevices
ls rBusy dSorter 2 Occupied
bgtz rBusy _WaitForDevices
ls rBusy dVender 0 Occupied
bgtz rBusy _WaitForDevices
ls rBusy dVender 1 Occupied
bgtz rBusy _WaitForDevices
#if the stacker is full so we skip it
beq rStackerCount rMaxUnitStack WaitEnd
ls rBusy dStacker 0 Occupied
bgtz rBusy _WaitForDevices
ls rBusy dStacker 1 Occupied
bgtz rBusy _WaitForDevices
WaitEnd:
j ra


</div>

|}

== Setup ==

* Place all components listed above and connect them using [[Cables]] and [[Chutes]] as shown in the picture
* Load the code into the IC and turn everything on

== 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 ==

=== Control And Initialization ===

* Wait until both memory modules have a non-zero value, then configure the sorter and stacker with the right mode and reset their counters. Reset the memory module for quantity.

=== Main ExportItem Loop ===
* 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 the stacker depending on the remaining items, the count inside the stacker and the maximum stacking size (in manual mode, it won't do anything until we set Output 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.)

@@ Line 1: / Line 1: @@
-[[Category:MIPS Programming]]
+[[Category:IC10 Programming]]
 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.]]

← Older revision		Revision as of 20:45, 18 June 2020
Line 1:		Line 1:
		+	[[Category:MIPS Programming]]
	This solution will export a given quantity of the specified item from a vending machine.		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.]]		[[File:VendingExporterSetup.png\|thumb\|right\|Connect the three devices with chutes as shown in the diagram.]]

@@ Line 17: / Line 17: @@
 </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>
@@ Line 65: / Line 63: @@
 </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>
@@ Line 71: / Line 68: @@
 </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: #6666FF;">move</span><span> </span><span>rSorterOutput</span><span> </span><span>0</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>
@@ Line 79: / Line 76: @@
 </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: #6666FF;">move</span><span> </span><span>rSorterOutput</span><span> </span><span>1</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>
@@ Line 91: / Line 84: @@
 </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>

@@ Line 132: / Line 132: @@
 * 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
 == Usage ==

@@ Line 143: / Line 143: @@
 == How It Works ==
-=== Control And Initialization ===
+=== Main loop ===
-* Wait until both memory modules have a non-zero value, then configure the sorter and stacker with the right mode and reset their counters. Reset the memory module for quantity.
+* Wait until both memory modules have a non-zero value.
-=== Main ExportItem Loop ===
+=== _Configuration ===
 * 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)

@@ Line 130: / Line 130: @@
 == Setup ==
-* Place all components listed above and connect them using [[Cables]] and [[Chutes]] as shown in the picture
+* 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
@@ Line 149: / Line 149: @@
 === Main ExportItem Loop ===
 * 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 the stacker depending on the remaining items, the count inside the stacker and the maximum stacking size (in manual mode, it won't do anything until we set Output to 1)
+* 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
+* 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.)