View source for Logic Sorter

[[Category:Machines]]
[[Category:Import/Export]]
{{Structurebox
| name = Logic Sorter
| image = [[File:StructureLogicSorter.png]]
| prefab_hash = 873418029
| prefab_name = StructureLogicSorter
| power_usage = 5W
| placed_on_grid = Small Grid
| decon_with_tool1 = [[Hand Drill]]
| placed_with_item = [[Kit (Sorter)]]
| item_rec1 = [[Kit (Sorter)]]
}}
{{Distinguish|Sorter}}

==Description==

<blockquote><q>Contains an Internal Memory which is assessed to check whether something should be sorted. When an item is in the Import slot Slot, the stack is checked and if result is true the thing is moved to the Export2 slot slot, otherwise it is moved to the Export slot slot. The Mode is used in how the stack is assessed, by default the mode is ALL, so every instruction in the stack would need to return true.</q><br>
'''- Stationpedia'''</blockquote>
 
Logic sorter is similar in almost every way to the previous sorter but has a internal memory that can be configured with logic and bit shifting to sort items passing through. When an item enters the import slot, it is checked against the filters in memory.  If the Mode is 0(All) then every filter must return true for the item to be sent to the export 2 slot.  If the mode is 1(Any) then as long as one of the filters returns true, the item matches and will be sent to the export 2 slot.

==Filter Instructions==
Check the in game Stationpedia [F1 on your keyboard] for formatting and instruction sizes to determine how to populate the memory.  Be warned that the stationpedia fails to document the endianness (bit 0 is the least significant bit).  While the stationpedia does document that the Logic Sorter has 256 bytes of memory, it is addressed as 32 x 8-byte (64-bit) numbers.

If you wish your sorter to send [[Steel Ingot]]s to the second output you should place the value 0xd8f8af8d_01 ( = 931885190401 decimal ) into memory 0.  More complicated programs will have to consider whether they want to use Mode 0 (match All), Mode 1 (match Any), or Mode 2 (match None).

It is more readable to calculate the instructions using [[IC10]] like this:

{{ICCode|
alias sorter d0
define steel HASH("ItemSteelIngot")
s sorter Mode 1 # Any
clr sorter # erase any stale instructions in RAM
sll r0 steel 8
or r0 r0 SorterInstruction.FilterPrefabHashEquals
put sorter 0 r0
}}

{| class="wikitable"
|-
! Sorter Instruction !! OP Code !! Description
|-
| FilterPrefabHashEquals || 1 || Compares Hash of item in import slot to the set hash and returns true if equal.
|-
| FilterPrefabHashNotEquals || 2 || Compares Hash of item in import slot to the set hash and returns true if not equal.
|-
| FilterSortingClassCompare || 3 || Compares the sorting class of an object in input slot. Example would be all ores. 
|-
| FilterSlotTypeCompare || 4 || Compares the item type of an object in the input slot. See slot type table below for item comparisons.
|-
| FilterQuantityCompare || 5 || Compares the stack size of the items in the import slot. 
|-
|LimitNextExecutionByCount || 6 || Ensures the next executable instruction will only return true a specified number of times. Each time it returns true, it decrements by one. 
|}

{| class="wikitable"
|-
! Conditional Operation (CONDOP) !! Value !! Pre-shifted
|-
| Equals || 0 || 0
|-
| Greater || 1 || 256
|-
| Less || 2 || 512
|-
| NotEquals || 3 || 768
|}

<pre>
MSB                                                          LSB
6666555555555544444444443333333333222222222211111111110000000000
3210987654321098765432109876543210987654321098765432109876543210
FilterPrefabHashEquals
########################(                   PREFAB_HASH)(     1)
FilterPrefabHashNotEquals
########################(                   PREFAB_HASH)(     2)
FilterSortingClassCompare
################################( SORTING_CLASS)(CONDOP)(     3)
FilterSlotTypeCompare
################################(     SLOT_TYPE)(CONDOP)(     4)
FilterQuantityCompare
################################(      QUANTITY)(CONDOP)(     5)
LimitNextExecutionByCount
########################(                         COUNT)(     6)
</pre>

{{Data Network Header}}

{{Data Parameters|
{{Data Parameters/row|Power|Boolean|w=0|Can be read to return if the Logic Sorter is correctly powered or not, set via the power system, return 1 if powered and 0 if not|multiple=2|0|Unpowered|1|Powered}}
{{Data Parameters/row|Mode|Integer|The mode of the Logic Sorter.|multiple=3|0|All|1|Any|2|None}}
{{Data Parameters/row|Error|Boolean|w=0|1 if device is in error state, otherwise 0|multiple=2|0|<p></p>|1|Error}}
{{Data Parameters/row|Lock|Boolean|Disable manual operation of the Logic Sorter.|multiple=2|0|Unlocked|1|Locked}}
{{Data Parameters/row|On|Boolean|The current state of the Logic Sorter.|multiple=2|0|Off|1|On}}
{{Data Parameters/row|RequiredPower|Integer|w=0|Idle operating power quantity, does not necessarily include extra demand power}}
{{Data Parameters/row|ClearMemory|Integer|r=0|When set to 1, clears the counter memory (e.g. ExportCount). Will set itself back to 0 when actioned}}
{{Data Parameters/row|ExportCount|Integer|w=0|How many items exported since last ClearMemory}}
{{Data Parameters/row|ImportCount|Integer|w=0|How many items imported since last ClearMemory}}
{{Data Parameters/row|PrefabHash|Integer|w=0|The hash of the structure}}
{{Data Parameters/row|ReferenceId|Integer|w=0|Unique Reference Identifier for this object}}
{{Data Parameters/row|NameHash|Integer|w=0|Provides the hash value for the name of the object as a 32 bit integer.}}
}}

=== Data Slots ===
These are all parameters, that can be read with a [[Kit_(Logic_I/O)#Slots_Reader|Slots Reader]]. The outputs are listed in the order a Slots Reader's "VAR" setting cycles through them.
{| class="wikitable"
|-
! Number || Name !! Description
|-
| 0 || Import || Import slot.
|-
| 1 || Export (reject) || Export slot.
|-
| 2 || Export (accept) || Export slot.
|-
| 3 || Data Disk || Diskslot
|}

{| class="wikitable"
|-
! Name !! Data Type !! Description
|-
| MaxQuantity || Integer || Returns maximum stacksize.
|-
| Damage || Integer || Item durability in percent.
|-
| Class || Integer || Item class ID for slot type comparison.
|-
| SortingClass || Integer || Class group of items. 
|-
| Quantity || Integer || Size of item stack.
|-
| PrefabHash || Integer || Returns [[ItemHash]] of item in slot.
|-
| Occupied || Boolean || Returns whether the slot occupied. (0 for no, 1 for yes).
|-
| OccupantHash || Integer || Returns [[ItemHash]] of item in slot.
|-
|}

== Item Slot Classes / Types ==

Reading the ''class'' attribute of the input slot will give one of the following values:

Note that you can use <pre style="display: inline">SlotClass.<Item></pre> directly in IC code instead of the numeric value
*NOTE The classes listed in this section are FilterSlotTypeCompare and NOT sorting class.  eg: SortingClass.Ores vs SlotClass.Ore

{| class="wikitable"
|+ Item values and descriptions
! Item !! Value !! Description !! Item !! Value !! Description !! Item !! Value !! Description
|-
| None || 0 || || Helmet || 1 || || Suit || 2 ||
|-
| Back || 3 || || GasFilter || 4 || || GasCanister || 5 ||
|-
| Motherboard || 6 || || Circuitboard || 7 || || DataDisk || 8 ||
|-
| Organ || 9 || || Ore || 10 || Includes reagent mixes from recycler and ices || Plant || 11 ||
|-
| Uniform || 12 || || Entity || 13 || || Battery || 14 ||
|-
| Egg || 15 || || Belt || 16 || || Tool || 17 ||
|-
| Appliance || 18 || || Ingot || 19 || || Torpedo || 20 ||
|-
| Cartridge || 21 || || AccessCard || 22 || || Magazine || 23 ||
|-
| Circuit || 24 || || Bottle || 25 || || ProgrammableChip || 26 ||
|-
| Glasses || 27 || || CreditCard || 28 || || DirtCanister || 29 ||
|-
| SensorProcessingUnit || 30 || || LiquidCanister || 31 || || LiquidBottle || 32 ||
|-
| Wreckage || 33 || || SoundCartridge || 34 || || DrillHead || 35 ||
|-
| ScanningHead || 36 || || Flare || 37 || || Blocked || 38 ||
|-
| SuitMod || 39 || || Crate || 40 || || Portables || 41 ||
|}