IC10 - Revision history

Wark: rewrote parts of Learning IC10

2026-06-13T14:45:47Z

rewrote parts of Learning IC10

Wark: tweaks to previously added sections, changed the section title, added ICCode templates

2026-06-10T05:06:50Z

tweaks to previously added sections, changed the section title, added ICCode templates

← Older revision		Revision as of 05:06, 10 June 2026
Line 412:		Line 412:
	[[#clrd\|clrd]], [[#getd\|getd]], [[#putd\|putd]],<br>		[[#clrd\|clrd]], [[#getd\|getd]], [[#putd\|putd]],<br>
	[[#ld\|ld]], [[#sd\|sd]], (no slot access via reference ID)		[[#ld\|ld]], [[#sd\|sd]], (no slot access via reference ID)
			----

	== Stack ~~Instruction Encoding~~ ==		== Internal Stack Programming ==
	The following devices support Stack instructions: [[Logic Sorter]], Autolathe, Electronics Printer, Hydraulic Pipe Bender, Tool Manufactory, Security Printer and Rocket Manufactory. The Medium Satellite Dish also supports Stack instructions, but it's only used to see the traders buy and sell data before they land; see the [[Satellite Tracking]] page for details.		The following devices support Stack instructions: [[Logic Sorter]], Autolathe, Electronics Printer, Hydraulic Pipe Bender, Tool Manufactory, Security Printer and Rocket Manufactory. The Medium Satellite Dish also supports Stack instructions, but it's only used to see the traders buy and sell data before they land; see the [[Satellite Tracking]] page for details.

Line 430:		Line 431:
	<code>Combine OP code and bit shifted Hash = %01101000_11001111_01111111_10010111_00000001</code>		<code>Combine OP code and bit shifted Hash = %01101000_11001111_01111111_10010111_00000001</code>

	The Stack instruction is ~~now~~ complete, and can be ~~placed on~~ the Logic Sorters Stack.		The Stack instruction is complete and the value can be moved to the Logic Sorters Stack. The IC10 for doing that could look like:

	~~<code>~~alias LogicSorter d0~~</code><br>~~		{{ICCode\|alias LogicSorter d0
	~~<code>~~sll r0 HASH("ItemIronOre") 8~~</code>~~ # bit-shift the hash value 8 times to the left~~<br>~~		sll r0 HASH("ItemIronOre") 8 # bit-shift the hash value 8 times to the left
	~~<code>~~or r0 r0 SorterInstruction.FilterPrefabHashEquals~~</code>~~ # combine bit shifted hash and OP code~~<br>~~		or r0 r0 SorterInstruction.FilterPrefabHashEquals # combine bit shifted hash and OP code
	~~<code>~~put LogicSorter 0 r0~~</code>~~ # write the instruction to Stack at position 0		put LogicSorter 0 r0 # write the instruction to Stack at position 0}}

	The finalized Stack instruction can be constructed in various ways. Rocketwerkz demonstrated this with <code>sll</code> and <code>or</code>, which made that choice popular. The same result can also be obtained with <code>mul</code> (multiplying by 256 is equivalent to 8 left bit shifts) and <code>add</code>, or with <code>ins</code> to manipulate the bit fields directly (but limited to the first 52 bits of the total 64).		The finalized Stack instruction can be constructed in various ways. Rocketwerkz demonstrated this with <code>sll</code> and <code>or</code>, which made that choice popular. The same result can also be obtained with <code>mul</code> (multiplying by 256 is equivalent to 8 left bit shifts) and <code>add</code>, or with <code>ins</code> to manipulate the bit fields directly (but limited to the first 52 bits of the total 64).
Line 446:		Line 447:

	====== Example: automatically print 50 Cable Coils ======		====== Example: automatically print 50 Cable Coils ======
	~~<code>~~alias printer d0~~</code><br>~~		{{ICCode\|alias printer d0
	~~<code>~~move r0 PrinterInstruction.ExecuteRecipe~~</code><br>~~		move r0 PrinterInstruction.ExecuteRecipe
	~~<code>~~ins r0 50 8 8~~</code>~~ # insert quantity 50 starting at the 8th bit~~<br>~~		ins r0 50 8 8 # insert quantity 50 starting at the 8th bit
	~~<code>~~ins r0 HASH("ItemCableCoil") 16 32~~</code>~~ # insert the item Hash starting at the 16th bit~~<br>~~		ins r0 HASH("ItemCableCoil") 16 32 # insert the item Hash starting at the 16th bit
	~~<code>~~put printer 0 PrinterInstruction.WaitUntilNextValid~~</code>~~ # required to populate missing reagents~~<br>~~		put printer 0 PrinterInstruction.WaitUntilNextValid # required to populate missing reagents
	~~<code>~~put printer 1 r0~~</code>~~ # ~~place the~~ instruction ~~on the printers Stack<br>~~		put printer 1 r0 # ExecuteRecipe instruction placed after WaitUntilNextValid
	~~<nowiki>~~#~~</nowiki>~~ if the printer runs out of copper, an external IC10 script can detect which ingot to send~~<br>~~		# if the printer runs out of copper, an external IC10 script can detect which ingot to send
	~~<code>~~get r0 printer 54~~</code>~~ # read the Stack address for the first missing reagent~~<br>~~		get r0 printer 54 # read the Stack address for the first missing reagent
	~~<code>~~sra r1 r0 16~~</code>~~ # remove the OPcode and quantity while preserving the sign bit~~<br>~~		sra r1 r0 16 # remove the OPcode and quantity while preserving the sign bit
	~~<code>~~rmap r2 printer r1~~</code>~~ # convert the reagent hash into the corresponding ingot hash		rmap r2 printer r1 # convert the reagent hash into the corresponding ingot hash}}

	=Instructions=		=Instructions=

Wark at 19:52, 8 June 2026

2026-06-08T19:52:30Z

← Older revision		Revision as of 19:52, 8 June 2026
Line 437:		Line 437:
	<code>put LogicSorter 0 r0</code> # write the instruction to Stack at position 0		<code>put LogicSorter 0 r0</code> # write the instruction to Stack at position 0

	The finalized Stack instruction can be constructed in various ways. Rocketwerkz demonstrated this with <code>sll</code> and <code>or</code>, which made that choice popular. The same result can also be obtained with <code>mul</code> (multiplying by 256 is equivalent to 8 left bit shifts) and <code>add</code>, or with <code>ins</code> to manipulate the bit fields directly.		The finalized Stack instruction can be constructed in various ways. Rocketwerkz demonstrated this with <code>sll</code> and <code>or</code>, which made that choice popular. The same result can also be obtained with <code>mul</code> (multiplying by 256 is equivalent to 8 left bit shifts) and <code>add</code>, or with <code>ins</code> to manipulate the bit fields directly (but limited to the first 52 bits of the total 64).

	For Logic Sorters the Mode value is also important. It can be either All (0), Any (1), or None (2), with All being the default value. All means every Stack instruction must evaluate as a match, Any means at least one must evaluate as a match, and None means that every instruction must fail to be a match. When sorting two or more different items, the Mode needs to be changed. To reverse the output sides for a Logic Sorter when using <code>FilterPrefabHashEquals</code> (OP code 1), change the Mode between Any (1) and None (2).		For Logic Sorters the Mode value is also important. It can be either All (0), Any (1), or None (2), with All being the default value. All means every Stack instruction must evaluate as a match, Any means at least one must evaluate as a match, and None means that every instruction must fail to be a match. When sorting two or more different items, the Mode needs to be changed. To reverse the output sides for a Logic Sorter when using <code>SorterInstruction.FilterPrefabHashEquals</code> (OP code 1), change the Mode between Any (1) and None (2).

	When printers receive a <code>PrinterInstruction.ExecuteRecipe</code> they will immediately start printing, and the instruction's quantity value will decrease for each item produced. An instruction with a quantity of zero will not print anything. If the printing is halted due to missing reagents, the printer will proceed to the next instruction (unless it's preceded by a <code>PrinterInstruction.WaitUntilNextValid</code> ). When a printer is idle it will loop through its Stack, which causes any unfinished printing jobs will be resumed as soon as reagents become available.		When printers receive a <code>PrinterInstruction.ExecuteRecipe</code> they will immediately start printing, and the instruction's quantity value will decrease for each item produced. An instruction with a quantity of zero will not print anything. If the printing is halted due to missing reagents, the printer will proceed to the next instruction (unless it's preceded by a <code>PrinterInstruction.WaitUntilNextValid</code> ). When a printer is idle it will loop through its Stack, which causes any unfinished printing jobs will be resumed as soon as reagents become available.
Line 446:		Line 446:

	====== Example: automatically print 50 Cable Coils ======		====== Example: automatically print 50 Cable Coils ======
	alias printer d0<br>		<code>alias printer d0</code><br>
	<code>move r0 PrinterInstruction.ExecuteRecipe</code><br>		<code>move r0 PrinterInstruction.ExecuteRecipe</code><br>
	<code>ins r0 50 8 8</code> # insert quantity 50 starting at the 8th bit<br>		<code>ins r0 50 8 8</code> # insert quantity 50 starting at the 8th bit<br>

Wark: small fixes to recently added sections

2026-06-08T19:48:17Z

small fixes to recently added sections

Show changes

Wark: added "Stack Instruction Encoding" for how to use IC10 to make Stack instructions for devices with internal Stacks (like the Logic Sorter)

2026-06-07T10:24:11Z

added "Stack Instruction Encoding" for how to use IC10 to make Stack instructions for devices with internal Stacks (like the Logic Sorter)

@@ Line 428: / Line 428: @@
 [[#clrd|clrd]], [[#getd|getd]], [[#putd|putd]],<br>
 [[#ld|ld]], [[#sd|sd]], (no slot access via reference ID)
 =Instructions=

Wark: Partial rewrite of "Learning IC10"

2026-06-03T20:44:08Z

Partial rewrite of "Learning IC10"

Show changes

Claimer: Added Data Network colors.

2026-04-05T04:56:14Z

Added Data Network colors.

← Older revision		Revision as of 04:56, 5 April 2026
Line 534:		Line 534:
	: When set to 1, clears the counter memory (e.g. ExportCount). Will set itself back to 0 when triggered.		: When set to 1, clears the counter memory (e.g. ExportCount). Will set itself back to 0 when triggered.
	<div id="Color"></div>		<div id="Color"></div>
	;Color		[[Category:Data Network]]
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#212AA5;"></div>~~ 0 (or lower) = Blue~~		== Data Network ==
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#7B7B7B;"></div>~~ 1 = Grey~~		This is a list of the colors used by various items with the logic network. These are the same colors that can be applied to physical items with a [[Spray_Can\|Spray Can]]. These codes can be used in IC10 scripts or logic circuits to set the color of various components, such as lights.
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#3F9B39;"></div>~~ 2 = Green~~		{\| class="wikitable sortable"
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#FF662B;"></div>~~ 3 = Orange~~		\|-
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#E70200;"></div>~~ 4 = Red~~		! Value !! Color !! Hex
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#FFBC1B;"></div>~~ 5 = Yellow~~		\|-
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#E7E7E7;"></div>~~ 6 = White~~		\| 0 \|\| Blue \|\| #212AA5<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#212AA5;"></div>
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#080908;"></div>~~ 7 = Black~~		\|-
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#633C2B;"></div>~~ 8 = Brown~~		\| 1 \|\| Gray \|\| #7B7B7B<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#7B7B7B;"></div>
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#63633F;"></div>~~ 9 = Khaki~~		\|-
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#E41C99;"></div>~~ 10 = Pink~~		\| 2 \|\| Green \|\| #3F9B39<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#3F9B39;"></div>
	: <div style="~~display: inline-block; vertical-align: top;~~ height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#732CA7;"></div>~~ 11 (or higher) = Purple~~		\|-
			\| 3 \|\| Orange \|\| #FF662B<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#FF662B;"></div>
			\|-
			\| 4 \|\| Red \|\| #E70200<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#E70200;"></div>
			\|-
			\| 5 \|\| Yellow \|\| #FFBC1B<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#FFBC1B;"></div>
			\|-
			\| 6 \|\| White \|\| #E7E7E7<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#E7E7E7;"></div>
			\|-
			\| 7 \|\| Black \|\| #080908<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#080908;"></div>
			\|-
			\| 8 \|\| Brown \|\| #633C2B<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#633C2B;"></div>
			\|-
			\| 9 \|\| Khaki \|\| #63633F<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#63633F;"></div>
			\|-
			\| 10 \|\| Pink \|\| #E41C99<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#E41C99;"></div>
			\|-
			\| 11 \|\| Purple \|\| #732CA7<div style="height: 20px; width: 20px; border: 1px solid black; margin-right: 5px; background-color:#732CA7;"></div>
			\|}
	<div id="CompletionRatio"></div>		<div id="CompletionRatio"></div>
	;CompletionRatio		;CompletionRatio

RA2lover: Add FilterType return values for gases introduced in the Gas update

2026-04-01T21:32:02Z

Add FilterType return values for gases introduced in the Gas update

← Older revision		Revision as of 21:32, 1 April 2026
Line 249:		Line 249:
	l r0 d0:0 Channel0}}		l r0 d0:0 Channel0}}

	For example: on an [[IC Housing]], the 0 connection is the data port and 1 is [[power]], so you could write out r0 to Channel0 of the power network of the Housing using <code>s db:1 Channel0 r0</code>		For example: on an [[IC Housing]], the 0 connection is the [[Data Port\|data port]] and 1 is [[power]], so you could write out r0 to Channel0 of the power network of the Housing using <code>s db:1 Channel0 r0</code>
	{{ICCode\|		{{ICCode\|
	#read all 8 channels with a loop and		#read all 8 channels with a loop and
Line 379:		Line 379:

	Two practice scripts:		Two practice scripts:
	<br>Automatic Night [[Light]]: Load "Activate" from a Daylight sensor, flip the value with a NOT-gate, store the value to the "On" variable of one or more lights.		<br>Automatic Night [[Light]]: Load "Activate" from a [[Daylight Sensor\|Daylight sensor]], flip the value with a NOT-gate, store the value to the "On" variable of one or more lights.
	<br>Automatic [[Wall Cooler]]: Read "Temperature" from a [[Gas Sensor]]. Branch if the value is greater than X, turn on the cooler. Branch if the value is less than Y, turn off the cooler. (Wall coolers need a minimum of 12.5 kPa pressure in the connected pipe)		<br>Automatic [[Wall Cooler]]: Read "Temperature" from a [[Gas Sensor]]. Branch if the value is greater than X, turn on the cooler. Branch if the value is less than Y, turn off the cooler. (Wall coolers need a minimum of 12.5 kPa pressure in the connected pipe)

Line 699:		Line 699:
	;FilterType		;FilterType
	Reports the type of [[filter]] installed in the slot (e.g. in a Filtration unit).		Reports the type of [[filter]] installed in the slot (e.g. in a Filtration unit).
	:Return Values: 1: Oxygen, 2: Nitrogen, 4: [[Carbon Dioxide]], 8: Volatiles, 16: Pollutants, 32: Water, 64: [[Nitrous]] ~~Oxide~~		:Return Values: 1: [[Oxygen]], 2: [[Nitrogen]], 4: [[Carbon Dioxide]], 8: [[Volatiles]], 16: [[Pollutants]], 32: [[Water]], 64: [[Nitrous Oxide]], 16384: [[Hydrogen]], 65536: [[Polluted Water]], 131072: [[Hydrazine]], 524288: [[Alcohol]], 1048576: [[Helium]], 2097152: [[Liquid Sodium Chloride]], 4194304: [[Silanol]], 16777216: [[Hydrochloric Acid]], 67108864: [[Ozone]]
	:<code>ls r0 db 0 FilterType</code>		:<code>ls r0 db 0 FilterType</code>
	<div id="Health"></div>		<div id="Health"></div>

Legolegs: /* Debugging advices */ breakpoints trick

2026-03-26T13:56:22Z

Debugging advices: breakpoints trick

Show changes

TK421: using iccode template

2026-02-20T06:28:14Z

using iccode template

← Older revision		Revision as of 06:28, 20 February 2026
Line 30:		Line 30:
	=== batch IO to - '''Device registers''' ===		=== batch IO to - '''Device registers''' ===
	'''Batch writing''' needs to be done to a specific '''deviceHash''' instead of d?. Is unique per device type, which you can find in the [[Stationpedia]] entries.		'''Batch writing''' needs to be done to a specific '''deviceHash''' instead of d?. Is unique per device type, which you can find in the [[Stationpedia]] entries.
	* <code>lb r? deviceHash logicType batchMode~~</code>~~		{{ICCode\|
	* <code>sb deviceHash logicType r?~~</code>~~		lb r? deviceHash logicType batchMode
			sb deviceHash logicType r?
			}}
	Additionally, using the following batch commands, a '''nameHash''' can be provided to only modify devices with a certain name.		Additionally, using the following batch commands, a '''nameHash''' can be provided to only modify devices with a certain name.
	* <code>lbn r? deviceHash nameHash logicType batchMode ~~</code>~~		{{ICCode\|
	* <code>sbn deviceHash nameHash logicType r?~~</code>~~		lbn r? deviceHash nameHash logicType batchMode
			sbn deviceHash nameHash logicType r?
			}}

	All hashes used in the game are CRC-32 checksums computed from the strings they represent.		All hashes used in the game are CRC-32 checksums computed from the strings they represent.
Line 42:		Line 46:
	Combining one of these functions with the <code>HASH()</code> function can be advantageous:		Combining one of these functions with the <code>HASH()</code> function can be advantageous:

	~~<code>~~lbn r0 HASH("StructureGasSensor") HASH("Sensor 1") Temperature Average~~</code>~~		{{ICCode\|
			lbn r0 HASH("StructureGasSensor")
			HASH("Sensor 1") Temperature Average
			}}

	This code will load the average temperature of all gas sensors on the network named "Sensor 1" onto register '''r0'''		This code will load the average temperature of all gas sensors on the network named "Sensor 1" onto register '''r0'''
Line 64:		Line 71:

	pinf and ninf are the IC10 constants for "positive infinity" and "negative infinity" respectively, and work much like other numerical constants.		pinf and ninf are the IC10 constants for "positive infinity" and "negative infinity" respectively, and work much like other numerical constants.



	=== Examples ===		=== Examples ===